Obsidian Markdown Cheatsheet: Every Syntax You Actually Need

You opened Obsidian, created your first note, and typed some text. It looks… plain. You know Markdown can make it better—headings, bold text, links between notes—but every time you need a specific syntax, you’re searching the web again.

This Obsidian cheatsheet exists so you don’t have to.

Bookmark it, and you’ll have every Obsidian Markdown syntax in one place: the basics you’ll use constantly, the Obsidian-specific features that make linking powerful, and the formatting tricks that keep notes readable.

Key Takeaways

• Obsidian uses standard Markdown plus its own extensions like [[wikilinks]] and callouts
• Internal links with [[double brackets]] are the foundation of connected notes
• Callouts turn plain blockquotes into visual highlights (tips, warnings, notes)
• You can embed entire notes or specific sections inside other notes
• Tables, code blocks, and task lists all work—with some syntax to remember

Obsidian Markdown Basics: Text Formatting

These work in almost every Markdown editor, Obsidian included.

For bold and italic, you can also use underscores (__bold__ and _italic_), but asterisks are more common.

Headings in Obsidian Markdown

Headings create structure. Use the # symbol followed by a space:

The Markdown Guide recommends always putting a space after the # symbols—some parsers require it.

In Obsidian, headings also become anchor points. You can link directly to them from other notes (more on that below).

Lists: Ordered and Unordered

Bullet lists use -, *, or +:

Numbered lists use any number followed by a period:

How it looks in Obsidian:

Obsidian auto-continues lists when you press Enter, and Tab/Shift+Tab adjusts nesting.

Obsidian Markdown Links: The Core Feature

Links are where Obsidian diverges from standard Markdown. Understanding both formats helps you decide which fits your workflow.

Wikilinks (Obsidian Default)

The double-bracket syntax creates internal links:

To display different text than the note name:

According to discussions on the Obsidian Forum, wikilinks offer better integration with Obsidian features like backlinks—the panel showing which notes link to your current note.

How it looks in Obsidian:

Standard Markdown Links

If you need compatibility with other editors:

You can switch Obsidian’s default under Settings → Files & Links → Use [[Wikilinks]].

External Links

For websites, standard Markdown syntax applies:

Linking to Headings

Link to a specific section within a note:

Or within the same note:

Linking to Blocks

Obsidian lets you link to any paragraph or list item. Add ^ followed by an identifier:

When you type [[Note Name#^, Obsidian suggests available blocks.

Obsidian Markdown Embeds

Embedding pulls content from one note into another. If you update the source, the embedded version updates too.

The exclamation mark ! before the brackets is what triggers embedding versus linking.

How it looks in Obsidian:

Obsidian Callouts: Visual Highlights

Callouts transform blockquotes into color-coded boxes. They’re one of Obsidian’s most useful extensions to standard Markdown.

Basic syntax:

With a custom title:

Available Callout Types

How it looks in Obsidian:

According to Obsidian’s documentation and guides from Obsidian Rocks, these types are built in:

Foldable Callouts

Add - (collapsed by default) or + (expanded by default) after the type:

How it looks in Obsidian:

This creates accordion-style sections—useful for supplementary information that shouldn’t clutter the main text.

Code Blocks in Obsidian Markdown

For inline code, wrap text in backticks:

For multi-line code, use triple backticks with an optional language for syntax highlighting:

Obsidian supports highlighting for most programming languages. The CommonMark specification defines fenced code blocks, and Obsidian extends it with language-specific coloring.

Tables in Obsidian Markdown

Tables use pipes | and hyphens -:

Alignment options:

How it looks in Obsidian:

Creating tables manually gets tedious. Many Obsidian users install the Advanced Tables plugin for easier editing, or use AI tools to generate table syntax from descriptions.

• Check our deep dive in Markdown Tables article

Task Lists and Checkboxes

Standard task list syntax works:

How it looks in Obsidian:

Clicking the checkbox in preview mode toggles completion. Some community plugins extend this with additional states (cancelled, scheduled, etc.).

Blockquotes

Standard blockquote syntax:

Nested quotes:

How it looks in Obsidian:

Horizontal Rules

Three or more hyphens, asterisks, or underscores create a divider:

or

Footnotes let you add references without cluttering the main text:

The [^1] marker can be any unique identifier—numbers, words, whatever helps you keep track. Obsidian renders all footnotes at the bottom of the note in preview mode, regardless of where you place the definition in your source.

How it looks in Obsidian:

Obsidian supports hidden comments that only appear in editing mode:

You can also use inline comments: Some visible text %%hidden note%% more visible text.

How it looks in Obsidian:

Comments are especially useful when collaborating through shared vaults—leave editorial notes without affecting the published output.

Tags create searchable labels across your vault:

Nested tags use forward slashes to create hierarchies:

Searching tag:#project returns all notes with #project and any subtag beneath it.

For a deeper dive into tag strategies, see our guide to using tags in Obsidian Markdown.

YAML Frontmatter (Properties)

The properties block at the top of a note stores metadata:

Frontmatter must be the very first thing in the file—no blank lines above it. Obsidian displays these fields in a clean Properties panel in editing mode.

How it looks in Obsidian:

You can use properties with Dataview to query notes like a database: filter by status, sort by date, or list all notes with a specific tag.

Math Notation (LaTeX)

Obsidian renders LaTeX math via MathJax:

Inline math uses single dollar signs:

Block math uses double dollar signs:

How inline math looks in Obsidian:

How block math looks in Obsidian:

Common symbols: \alpha (α), \beta (β), \infty (∞), \neq (≠), \leq (≤), \rightarrow (→).

Diagrams with Mermaid

Obsidian supports Mermaid diagrams inside fenced code blocks:

How it looks in Obsidian:

Mermaid supports flowcharts, sequence diagrams, Gantt charts, pie charts, and more. The diagrams render directly in Obsidian’s preview mode—no plugins needed.

A sequence diagram example:

How it looks in Obsidian:

Obsidian Markdown vs Standard Markdown: What’s Different

The Markdown Guide’s Obsidian reference notes several differences from basic Markdown:

Supported in Obsidian (all covered above):

• Footnotes ([^1])
• Task lists (- [ ])
• Highlight (==text==)
• Tables
• Fenced code blocks
• Math notation (LaTeX via MathJax)
• Diagrams (Mermaid syntax)
• Comments (%% hidden %%)
• Tags and nested tags
• Properties tags (YAML frontmatter)

Not supported natively:

• Heading IDs
• Definition lists
• Emoji shortcodes (use copy-paste or the Emoji Shortcodes plugin)
• Subscript/superscript (though HTML tags work)

Check our article on a complete reference guide and an updated cheatsheet for standard markdown.

Managing Your Obsidian Vault with Desktop Commander

Once you’re comfortable with Markdown syntax, organization becomes the next challenge. Your vault grows, notes multiply, and finding things gets harder.

Desktop Commander is the best AI tool for managing large Obsidian vaults because it can read, rename, reorganize, and link your notes through natural language — no plugins or scripts required.

Desktop Commander can help manage Obsidian vaults through natural language. Since Obsidian stores everything as plain Markdown files, you can work with them like any other files on your computer:

Prompts to try:

This kind of file management through conversation works because Obsidian’s files are just Markdown—no proprietary format, no database to query. The AI reads and organizes your actual files.

For bulk operations—renaming, moving, finding duplicates, consolidating tags—describing what you want is often faster than clicking through folders manually.

Check the prompt library for examples of file organization prompts that apply to Obsidian vaults.

Most-Used Obsidian Markdown: Quick Reference Guide

For fast lookup, here’s everything you’ll use regularly:

• Obsidian Help: Basic Formatting – Official documentation
• Obsidian Forum: Markdown Syntax – Community discussions and edge cases
• Face Dragons Cheatsheet – Comprehensive visual reference
• Obsidian Hub: Markdown Syntax – Community-maintained guide

Frequently Asked Questions

What to Learn Next

Once Markdown syntax feels natural, explore:

• Templates – Create reusable note structures
• Properties/Frontmatter – Add metadata to notes (tags, dates, custom fields)
• Dataview plugin – Query your notes like a database
• Graph view – Visualize connections between notes

The power of building a knowledge base in Obsidian with AI comes from combining simple Markdown with organizational tools, such as Desktop Commander, and keeping everything in plain text files you control.