{"id":103486,"plugin_id":"plugins_6aee4fde227881919d61b034b1c31096","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-11-18T06:20:18.773Z","digest":"2a1e5cf169e00a132bfe285aca12b98269bcb3a97fe2c2d7a836f07e7a76a8ba","against":null,"payload":{"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.","included_files":[{"relative_path":"references/CALLOUTS.md","size_in_bytes":1238},{"relative_path":"references/EMBEDS.md","size_in_bytes":861},{"relative_path":"references/PROPERTIES.md","size_in_bytes":1461}],"name":"obsidian-markdown","skill_md_contents":"---\nname: obsidian-markdown\ndescription: 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.\n---\n\n# 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```\nInside Markdown tables, escape wikilink alias pipes as `[[Note\\|Alias]]` so the alias separator is not parsed as a table cell delimiter. When a table follows a paragraph, leave a blank line above it, or it renders as plain text.\n\nLinks resolve by file name, not by the `aliases` property. A bare `[[Alias]]` stays unresolved; write `[[Note|Alias]]` to show an alias.\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 names offered in link suggestions; links still use the file name), `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, underscores, hyphens, and forward slashes, but must include at least one non-numerical character (`#1984` is invalid, `#1984book` is valid). A space ends a tag, so `#my tag` is the tag `#my`. 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==🔴Highlighted text==                 Colored highlight (Obsidian 1.14.1 and later)\n```\n\nA colored highlight starts with 🔴, 🟠, 🟡, 🟢, 🔵 or 🟣 (or the matching square) right after `==`. Other emoji stay as text.\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)\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}