{
  "schema": "https://ai-atoms.com/schemas/skill-v1.json",
  "type": "skill",
  "id": "skill/obsidian-markdown",
  "version": "1.0.0",
  "name": "obsidian-markdown",
  "description": "Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.",
  "system_prompt_fragment": "# Obsidian Flavored Markdown Skill\n\nCreate 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.\n\n## Workflow: Creating an Obsidian Note\n\n1. **Add frontmatter** with properties (title, tags, aliases) at the top of the file. See [PROPERTIES.md](references/PROPERTIES.md) for all property types.\n2. **Write content** using standard Markdown for structure, plus Obsidian-specific syntax below.\n3. **Link related notes** using wikilinks (`[[Note]]`) for internal vault connections, or standard Markdown links for external URLs.\n4. **Embed content** from other notes, images, or PDFs using the `![[embed]]` syntax. See [EMBEDS.md](references/EMBEDS.md) for all embed types.\n5. **Add callouts** for highlighted information using `> [!type]` syntax. See [CALLOUTS.md](references/CALLOUTS.md) for all callout types.\n6. **Verify** the note renders correctly in Obsidian's reading view.\n\n> When choosing between wikilinks and Markdown links: use `[[wikilinks]]` for notes within the vault (Obsidian tracks renames automatically) and `[text](url)` for external URLs only.\n\n## Internal Links (Wikilinks)\n\n```markdown\n[[Note Name]]                          Link to note\n[[Note Name|Display Text]]             Custom display text\n[[Note Name#Heading]]                  Link to heading\n[[Note Name#^block-id]]                Link to block\n[[#Heading in same note]]              Same-note heading link\n```\n\nDefine a block ID by appending `^block-id` to any paragraph:\n\n```markdown\nThis paragraph can be linked to. ^my-block-id\n```\n\nFor lists and quotes, place the block ID on a separate line after the block:\n\n```markdown\n> A quote block\n\n^quote-id\n```\n\n## Embeds\n\nPrefix any wikilink with `!` to embed its content inline:\n\n```markdown\n![[Note Name]]                         Embed full note\n![[Note Name#Heading]]                 Embed section\n![[image.png]]                         Embed image\n![[image.png|300]]                     Embed image with width\n![[document.pdf#page=3]]               Embed PDF page\n```\n\nSee [EMBEDS.md](references/EMBEDS.md) for audio, video, search embeds, and external images.\n\n## Callouts\n\n```markdown\n> [!note]\n> Basic callout.\n\n> [!warning] Custom Title\n> Callout with a custom title.\n\n> [!faq]- Collapsed by default\n> Foldable callout (- collapsed, + expanded).\n```\n\nCommon types: `note`, `tip`, `warning`, `info`, `example`, `quote`, `bug`, `danger`, `success`, `failure`, `question`, `abstract`, `todo`.\n\nSee [CALLOUTS.md](references/CALLOUTS.md) for the full list with aliases, nesting, and custom CSS callouts.\n\n## Properties (Frontmatter)\n\n```yaml\n---\ntitle: My Note\ndate: 2024-01-15\ntags:\n  - project\n  - active\naliases:\n  - Alternative Name\ncssclasses:\n  - custom-class\n---\n```\n\nDefault properties: `tags` (searchable labels), `aliases` (alternative note names for link suggestions), `cssclasses` (CSS classes for styling).\n\nSee [PROPERTIES.md](references/PROPERTIES.md) for all property types, tag syntax rules, and advanced usage.\n\n## Tags\n\n```markdown\n#tag                    Inline tag\n#nested/tag             Nested tag with hierarchy\n```\n\nTags can contain letters, numbers (not first character), underscores, hyphens, and forward slashes. Tags can also be defined in frontmatter under the `tags` property.\n\n## Comments\n\n```markdown\nThis is visible %%but this is hidden%% text.\n\n%%\nThis entire block is hidden in reading view.\n%%\n```\n\n## Obsidian-Specific Formatting\n\n```markdown\n==Highlighted text==                   Highlight syntax\n```\n\n## Math (LaTeX)\n\n```markdown\nInline: $e^{i\\pi} + 1 = 0$\n\nBlock:\n$$\n\\frac{a}{b} = c\n$$\n```\n\n## Diagrams (Mermaid)\n\n````markdown\n```mermaid\ngraph TD\n    A[Start] --> B{Decision}\n    B -->|Yes| C[Do this]\n    B -->|No| D[Do that]\n```\n````\n\nTo link Mermaid nodes to Obsidian notes, add `class NodeName internal-link;`.\n\n## Footnotes\n\n```markdown\nText with a footnote[^1].\n\n[^1]: Footnote content.\n\nInline footnote.^[This is inline.]\n```\n\n## Complete Example\n\n````markdown\n---\ntitle: Project Alpha\ndate: 2024-01-15\ntags:\n  - project\n  - active\nstatus: in-progress\n---\n\n# Project Alpha\n\nThis project aims to [[improve workflow]] using modern techniques.\n\n> [!important] Key Deadline\n> The first milestone is due on ==January 30th==.\n\n## Tasks\n\n- [x] Initial planning\n- [ ] Development phase\n  - [ ] Backend implementation\n  - [ ] Frontend design\n\n## Notes\n\nThe algorithm uses $O(n \\log n)$ sorting. See [[Algorithm Notes#Sorting]] for details.\n\n![[Architecture Diagram.png|600]]\n\nReviewed in [[Meeting Notes 2024-01-10#Decisions]].\n````\n\n## References\n\n- [Obsidian Flavored Markdown](https://help.obsidian.md/obsidian-flavored-markdown)\n- [Internal links](https://help.obsidian.md/links)\n- [Embed files](https://help.obsidian.md/embeds)\n- [Callouts](https://help.obsidian.md/callouts)\n- [Properties](https://help.obsidian.md/properties)",
  "applicable_domains": [
    "knowledge",
    "productivity",
    "notes"
  ],
  "invocation": [
    "/obsidian-markdown"
  ],
  "tags": [
    "obsidian",
    "markdown",
    "kepano",
    "knowledge-management"
  ],
  "authored_by": "kepano",
  "source_url": "https://github.com/kepano/obsidian-skills/blob/main/skills/obsidian-markdown/SKILL.md",
  "lifecycle": "stable",
  "category": "knowledge",
  "provenance": {
    "source": "kepano/obsidian-skills",
    "source_url": "https://github.com/kepano/obsidian-skills/blob/main/skills/obsidian-markdown/SKILL.md",
    "author": "Steph Ango (kepano)",
    "license": "MIT",
    "notes": "Imported by scripts/import-anthropic-skills.py."
  }
}