pivoshenko/pivoshenko.ai / skills/obsidian-markdown
obsidian-markdown
VerifiedObsidian Flavored Markdown syntax reference - wikilinks, embeds, callouts, properties/frontmatter, tags, comments, block IDs. Use when creating or editing .md files in an Obsidian vault, when linking or embedding notes, when writing callouts or note frontmatter, or when the user mentions wikilinks, backlinks, block references, or Obsidian notes. Also use before hand-writing Obsidian syntax from memory - the extensions here are not standard markdown and the near-misses (markdown links to vault notes, wrong callout keywords) fail silently in the app.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
| references/callouts.md | markdown | 1.2 KB |
| references/embeds.md | markdown | 861 B |
| references/properties.md | markdown | 1.1 KB |
SKILL.md
View on GitHub---
name: obsidian-markdown
description: Obsidian Flavored Markdown syntax reference - wikilinks, embeds, callouts, properties/frontmatter, tags, comments, block IDs. Use when creating or editing .md files in an Obsidian vault, when linking or embedding notes, when writing callouts or note frontmatter, or when the user mentions wikilinks, backlinks, block references, or Obsidian notes. Also use before hand-writing Obsidian syntax from memory - the extensions here are not standard markdown and the near-misses (markdown links to vault notes, wrong callout keywords) fail silently in the app.
tags: [wiki, obsidian]
updated_at: 2026-09-13
---
# Obsidian Markdown
Obsidian = CommonMark + GFM + extensions below. Standard markdown assumed; this covers only the Obsidian-specific parts. Adapted from [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) (MIT).
## Wikilinks
```markdown
[[Note Name]] link to note
[[Note Name|Display Text]] custom text
[[Note Name#Heading]] link to heading
[[Note Name#^block-id]] link to block
[[#Heading]] same-note heading
```
In-vault -> wikilink (Obsidian tracks renames). External URL -> `[text](url)`. Never markdown-link vault notes.
Block ID: `^block-id` at the end of the paragraph's last line, space before it. Lists/quotes -> ID on its own line after the block.
## Embeds
`!` prefix on any wikilink embeds it inline:
```markdown
![[Note Name]] full note
![[Note Name#Heading]] section
![[image.png|300]] image, width 300
![[document.pdf#page=3]] PDF page
```
More (audio, bases, search embeds, external images) -> [references/embeds.md](references/embeds.md).
## Callouts
```markdown
> [!note]
> Basic.
> [!warning] Custom Title
> Body.
> [!faq]- Collapsed by default (+ = expanded)
```
Types: `note tip info warning example quote bug danger success failure question abstract todo`. Full table + aliases + nesting -> [references/callouts.md](references/callouts.md).
## Properties (Frontmatter)
YAML at top of file. Defaults Obsidian understands: `tags`, `aliases`, `cssclasses`. Lists as YAML lists; links as `related: "[[Other Note]]"` (quoted). Types + tag charset rules -> [references/properties.md](references/properties.md).
## Tags
`#tag`, `#nested/tag`. Letters, numbers (not first char), `_`, `-`, `/`. Frontmatter `tags:` list = same namespace.
## Misc
```markdown
==highlight==
%%hidden comment%%
$e^{2i\pi}$ inline / $$block$$
Text with footnote[^1]. / inline.^[Inline footnote.]
```
Mermaid: fenced ```mermaid block; `class NodeName internal-link;` makes nodes link to notes.
## Docs
https://help.obsidian.md/obsidian-flavored-markdown · /links · /embeds · /callouts · /properties
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |