# Obsidian Flavored Markdown [[Obsidian]] parses CommonMark plus GitHub Flavored Markdown (tables, task lists, strikethrough, autolinks), and adds its own extensions on top. Knowing which is which matters the moment your notes leave Obsidian: standard [[Markdown]] travels everywhere, the extensions don't. ## Obsidian-specific extensions | Syntax | Feature | | --- | --- | | `[[Note]]`, `[[Note#Heading]]`, `[[Note#^block]]` | [[Obsidian Wikilinks]] | | `![[Note]]` | [[Obsidian Embeds]] | | `^block-id` | [[Block references]] | | `> [!note]` | [[Obsidian Callouts]] | | `%% hidden %%` | Comments, invisible in Reading view | | `==text==` | Highlight | | `#tag`, `#nested/tag` | [[Obsidian Tags]] | | `---` block at the top | [[Obsidian Properties\|Properties]] (YAML frontmatter) | | ` ```mermaid ` | [[Mermaid]] diagrams | | ` ```query ` | Embedded [[Obsidian Search]] results | | `$... and `$...$` | Math via MathJax/LaTeX | | `[^1]` and `^[inline]` | [[Obsidian Footnotes]] | ## Good to know - Frontmatter, comments, highlights, and footnotes are shared with other Markdown dialects; wikilinks, embeds, callouts, and block IDs are the truly Obsidian-flavored parts. - Publishing pipelines (like mine to Ghost) must convert or strip the extensions; that conversion step is where most "why does my post look broken" issues come from. - Obsidian can write standard Markdown links instead of wikilinks if portability is a priority (see [[Obsidian Wikilinks]]). ## References - Obsidian Flavored Markdown: https://help.obsidian.md/Editing+and+formatting/Obsidian+Flavored+Markdown - Basic formatting syntax: https://help.obsidian.md/Editing+and+formatting/Basic+formatting+syntax - Advanced formatting syntax: https://help.obsidian.md/Editing+and+formatting/Advanced+formatting+syntax ## Related - [[Markdown]] - [[Obsidian]] - [[Obsidian Wikilinks]] - [[Obsidian Embeds]] - [[Obsidian Callouts]] - [[Obsidian Tags]] - [[Obsidian Properties]] - [[Obsidian Footnotes]] - [[Obsidian Editing Modes]] - [[Block references]] - [[Mermaid]]