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
Install
kepano/obsidian-skills/obsidian-markdown
git clone https://github.com/kepano/obsidian-skills
cp -r obsidian-skills/skills/obsidian-markdown ~/.claude/skills/obsidian-markdownFrequently 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)
Read as markdown · JSON record · Browse the source repository
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