obsidian-markdown
This skill handles Obsidian Flavored Markdown syntax beyond standard Markdown, covering wikilinks for vault-internal linking, embed directives for content inclusion, callout blocks for highlighted information, and frontmatter properties. Use it when working with .md files in Obsidian or when users reference wikilinks, callouts, tags, embeds, or note organization.
obsidian-markdown creates and edits notes with Obsidian Flavored Markdown, including wikilinks, embeds, callouts, and properties.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-06-08
obsidian-markdown creates and edits notes with Obsidian Flavored Markdown, including wikilinks, embeds, callouts, and properties. This skill handles Obsidian Flavored Markdown syntax beyond standard Markdown, covering wikilinks for vault-internal linking, embed directives for content inclusion, callout blocks for highlighted information, and frontmatter properties. Use it when working with .md files in Obsidian or when users reference wikilinks, callouts, tags, embeds, or note organization.
Use it when
- obsidian-markdown embeds content using the `![[file-name]]` syntax.
- obsidian-markdown supports block references by adding a caret and identifier to any block: `^block-id`.
Verify before relying
Read SKILL.md below before installing (4 files). Open directory: indexed for reading, not audited.
Similar skills
Install
kepano/obsidian-skills/obsidian-markdown
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I create wikilinks in obsidian?
obsidian-markdown uses double-bracket syntax to create wikilinks for vault-internal linking. Wrap note titles in `[[note-name]]` to link to other notes in your vault. You can also use `[[note-name|display text]]` to show custom link text while pointing to the target note. Wikilinks enable bidirectional linking and appear in Obsidian's graph view, making them superior to standard Markdown links for vault navigation.
What's the obsidian markdown syntax for embed images and files?
obsidian-markdown embeds content using the `![[file-name]]` syntax. Prefix a wikilink with an exclamation mark to embed images, PDFs, audio, video, or even entire notes inline. For images, you can resize with `![[image.png|width]]`. Embeds pull live content into your note, so changes to the embedded file automatically reflect wherever it's embedded.
How do I use block references in obsidian?
obsidian-markdown supports block references by adding a caret and identifier to any block: `^block-id`. Then link to that specific block with `[[note-name#^block-id]]` or embed it with `![[note-name#^block-id]]`. This lets you reference paragraphs, lists, or code blocks without linking the entire note, enabling granular content reuse across your vault.
How do I create callout boxes in obsidian?
obsidian-markdown callouts use the syntax `> [!TYPE] Title` where TYPE is INFO, WARNING, DANGER, SUCCESS, QUESTION, EXAMPLE, QUOTE, or custom. Follow with indented content on the next lines. Example: `> [!WARNING] Be careful` creates a highlighted warning box. Callouts are collapsible and styled distinctly, making them ideal for emphasizing important information within notes.
What frontmatter properties does obsidian-markdown support?
obsidian-markdown supports YAML frontmatter at the top of notes using `---` delimiters. Define properties like `tags: [tag1, tag2]`, `aliases: [alt-name]`, `date: 2024-01-15`, or custom fields. Properties appear in Obsidian's metadata panel and enable filtering, sorting, and templating. Use frontmatter to organize vault metadata and enhance note discoverability.
What's the difference between wikilinks and markdown links in obsidian?
obsidian-markdown distinguishes wikilinks (`[[note]]`) from standard Markdown links (`[text](url)`). Wikilinks are vault-internal, create backlinks, and appear in the graph view; Markdown links point to external URLs or files. Use wikilinks for vault navigation and Markdown links for web references. Obsidian auto-completes wikilinks but requires manual Markdown link entry.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
Obsidian Flavored Markdown Skill
Create and edit valid Obsidian Flavored Markdown. Obsidian extends CommonMark and GFM with wikilinks, embeds, callouts, properties, comments, and other syntax. This skill covers only Obsidian-specific extensions -- standard Markdown (headings, bold, italic, lists, quotes, code blocks, tables) is assumed knowledge.
Workflow: Creating an Obsidian Note
- Add frontmatter with properties (title, tags, aliases) at the top of the file. See PROPERTIES.md for all property types.
- Write content using standard Markdown for structure, plus Obsidian-specific syntax below.
- Link related notes using wikilinks (
[[Note]]) for internal vault connections, or standard Markdown links for external URLs. - Embed content from other notes, images, or PDFs using the
![[embed]]syntax. See
(truncated - see the full file via the links below)
File tree — 4 files
skills/obsidian-markdown/SKILL.md
skills/obsidian-markdown/references/CALLOUTS.md
skills/obsidian-markdown/references/EMBEDS.md
skills/obsidian-markdown/references/PROPERTIES.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Create and format notes using Obsidian-specific Markdown syntax”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
Master Obsidian Flavored Markdown to create richly formatted notes with wikilinks, embeds, callouts, and frontmatter properties. This skill covers Obsidian-specific extensions beyond standard Markdown, enabling you to link notes within your vault, embed content inline, highlight information with styled callouts, and organize metadata through properties.
Build structured database views within Obsidian by creating .base files that organize notes through filters, computed formulas, and customizable display formats. Support table, card, list, and map views with optional grouping, limits, and summary calculations across your vault.
Build structured database views within Obsidian using .base files that support tables, cards, lists, and maps. Define filters to scope which notes appear, add computed formulas for derived properties, and configure multiple views with custom summaries—all through simple YAML configuration.
Build and modify .canvas files following the JSON Canvas Spec 1.0, adding text, file, link, and group nodes with precise positioning and connections. Manage edges between nodes, apply colors, and validate your canvas structure to ensure all references resolve correctly.
Obsidian Bases lets you build structured database views within your vault using YAML-based .base files. Define tables, cards, or lists with custom filters, computed formulas, and aggregated summaries to organize and display your notes dynamically.
This skill guides you through WooCommerce's markdown standards for documentation and README files. It covers heading hierarchy, list formatting with proper indentation, code block syntax highlighting, and UTF-8 character handling for directory trees. Use markdownlint from the repository root to auto-fix and validate your changes.