Obsidian Markdown Cheat Sheet

Complete guide to Obsidian-specific Markdown syntax including wikilinks, callouts, and embeds

Obsidian supports all standard Markdown syntax plus the extensions below. See our Markdown Cheat Sheet for standard syntax.

Wikilinks

Basic Link

Link to another note

[[Page Name]]

Link with Alias

Link with custom text

[[Page Name|Display Text]]

Link to Heading

Link to specific heading

[[Page Name#Heading]]

Link to Block

Link to specific block

[[Page Name#^block-id]]

Embeds

Embed Note

Embed entire note

![[Note Name]]

Embed Heading

Embed specific section

![[Note#Heading]]

Embed Image

Embed image from vault

![[image.png]]

Embed PDF

Embed PDF file

![[document.pdf]]

Callouts

Note

Information callout

> [!note]
> Content here

Tip

Helpful tip

> [!tip]
> Content here

Warning

Warning message

> [!warning]
> Content here

Important

Important info

> [!important]
> Content here

Collapsible

Collapsed by default

> [!note]- Title
> Hidden content

Formatting

Highlight

Highlight text

==highlighted text==

Comments

Hidden comments

%%This is hidden%%

Strikethrough

Strike through text

~~strikethrough~~

Math & Code

Inline Math

Inline LaTeX

$E = mc^2$

Block Math

Math block

$$
\sum_{i=1}^n x_i
$$

Mermaid

Diagrams

```mermaid
graph TD
  A --> B
```

Metadata

YAML Frontmatter

Note metadata

---
title: My Note
tags: [tag1, tag2]
---

Aliases

Alternative names

aliases: [alias1, alias2]

Useful Shortcuts

Cmd/Ctrl + NNew note

Cmd/Ctrl + OOpen quick switcher

Cmd/Ctrl + PCommand palette

Cmd/Ctrl + EToggle edit/preview

Cmd/Ctrl + ClickOpen link in new pane

[[Start wikilink

Frequently Asked Questions

What is Obsidian?

Obsidian is a powerful knowledge base and note-taking application that stores Markdown files locally on your device, with features like wikilinks, graph view, and extensive plugins.

How are wikilinks different from regular Markdown links?

Wikilinks use double brackets [[like this]] and automatically link to other notes in your vault by name, without needing the full file path.

Can I use regular Markdown in Obsidian?

Yes! Obsidian supports all standard Markdown syntax plus its own extensions like wikilinks, callouts, and embeds.