obsidian-markdown
Skill6 starsChanged 44 days agoMITView on GitHub
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.
Files
Obsidian Markdown
Obsidian = CommonMark + GFM + extensions below. Standard markdown assumed; this covers only the Obsidian-specific parts. Adapted from kepano/obsidian-skills (MIT).
Wikilinks
[[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 headingIn-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:
![[Note Name]] full note
![[Note Name#Heading]] section
![[image.png|300]] image, width 300
![[document.pdf#page=3]] PDF pageMore (audio, bases, search embeds, external images) -> references/embeds.md.
Callouts
> [!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.
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.
Tags
#tag, #nested/tag. Letters, numbers (not first char), _, -, /. Frontmatter tags: list = same namespace.
Misc
==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
Other versions83 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 83
- kepano/obsidian-skills★ 49ksame name
- AgriciDaniel/claude-obsidian★ 16ksame name
- anbeime/skill★ 7.9ksame name
- breferrari/obsidian-mind★ 5.4ksame name
- Atmosphere/atmosphere★ 3.8ksame name
- heyitsnoah/claudesidian★ 2.6ksame name
- pedronauck/skills★ 641same name
- freestylefly/canghe-skills★ 461same name
- benoror/obsidianos_work★ 166same name
- kv0906/pm-kit★ 138same name
73 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
Used alongsideProjects with it also use defuddle, knap and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
HK-hubSkilldefuddle
Extract clean markdown content from web pages using Defuddle CLI, removing clutter and navigation to save tokens. Use instead of WebFetch when the user provides a URL to read or analyze, for online documentation, articles, blog posts, or any standard web page.
Also in 29 projects that use this
lucasmaher-hashSkillknap
Render Markdown from templates and structured data using Knap CLI. Use when the user asks to apply a Knap template, turn JSON or CSV data into notes, batch-generate Markdown files, or format Defuddle output into a note.
Also in 4 projects that use this
jykimSkillobsidian-cli
Interact with Obsidian using the official CLI to read, search, create, and manage notes, daily notes, tasks, properties, and more. Use when the user wants to query or manipulate vault content via the obsidian command.
Also in 36 projects that use this
BCS1037Skillmermaid-visualizer
Transform text content into professional Mermaid diagrams for presentations and documentation. Use when users ask to visualize concepts, create flowcharts, or make diagrams from text. Supports process flows, system architectures, comparisons, mindmaps, and more with built-in syntax error prevention.
Also in 3 projects that use this
0xHoneyJarSkillqmd
Local markdown search engine for knowledge bases, notes, and documentation. Combines BM25 full-text search, vector semantic search, and LLM re-ranking. Use when searching through markdown notes, retrieving documents, or managing knowledge collections.
Also in 3 projects that use this
seongjaeryuSkillsave
Complete and save your current thinking to Bindly
Also in 3 projects that use this
In this repository21 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- blog-writeSkill
- cloudflare-hygieneSkill
- git-branch-cleanupSkill
- git-branch-createSkill
- git-branch-syncSkill
- git-commitSkill
- git-issue-createSkill
- git-issue-startSkill
- git-issue-triageSkill
- git-pr-createSkill
- herdr-dispatchSkill
- humanizeSkill
- macos-cleanupSkill
- macos-maintenanceSkill
- spec-applySkill
- spec-archiveSkill
- spec-exploreSkill
- spec-proposeSkill
- spec-verifySkill
- vercel-hygieneSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

