// Write correct Obsidian Flavored Markdown: wikilinks, embeds, callouts, properties, tags, and math. Reference when creating any wiki page.
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | obsidian-markdown |
| description | Obsidian Flavored Markdown syntax. Wikilinks, embeds, callouts, properties, tags, math. |
| allowed-tools | Read |
Reference when writing any wiki page. Obsidian Markdown: wikilinks, embeds, callouts, properties. Prefer kepano/obsidian-skills plugin if installed. Otherwise use reference below.
Internal links use double brackets. The filename without extension.
| Syntax | What it does |
|---|---|
[[Note Name]] | Basic link |
[[Note Name|Display Text]] | Aliased link (shows "Display Text") |
[[Note Name#Heading]] | Link to a specific heading |
[[Note Name#^block-id]] | Link to a specific block |
Rules:
[[Folder/Note Name]] to disambiguate.Embeds use ! before the wikilink. They display the content inline.
| Syntax | What it does |
|---|---|
![[Note Name]] | Embed a full note |
![[Note Name#Heading]] | Embed a section |
![[image.png]] | Embed an image |
![[image.png|300]] | Embed image with width 300px |
![[document.pdf]] | Embed a PDF (Obsidian renders natively) |
![[audio.mp3]] | Embed audio |
Callouts are blockquotes with a type keyword. They render as styled alert boxes.
> [!note] Default informational callout.
> [!note] Custom Title Callout with a custom title.
> [!note]- Collapsible (closed by default) Click to expand.
> [!note]+ Collapsible (open by default) Click to collapse.
| Type | Aliases | Use for |
|---|---|---|
note | : | General notes |
abstract | summary, tldr | Summaries |
info | : | Information |
todo | : | Action items |
tip | hint, important | Tips and highlights |
success | check, done | Positive outcomes |
question | help, faq | Open questions |
warning | caution, attention | Warnings |
failure | fail, missing | Errors or failures |
danger | error | Critical issues |
bug | : | Known bugs |
example | : | Examples |
quote | cite | Quotations |
contradiction | : | Conflicting information (wiki convention) |
Obsidian renders YAML frontmatter as a Properties panel. Rules:
---
type: concept # plain string
title: "Note Title" # quoted if it contains special chars
created: 2026-04-08 # date as YYYY-MM-DD (not ISO datetime)
updated: 2026-04-08
tags:
- tag-one # list items use - format
- tag-two
status: developing
related:
- "[[Other Note]]" # wikilinks must be quoted in YAML
sources:
- "[[source-page]]"
---
Rules:
YYYY-MM-DD, not 2026-04-08T00:00:00.- item, not inline [a, b, c]."[[Page]]".tags field: Obsidian reads this as the tag list, searchable in vault.Two valid forms:
#tag-name : inline tag anywhere in the body #parent/child-tag : nested tag (shows hierarchy in tag pane)
In frontmatter:
tags:
- research
- ai/obsidian
Do not use # inside frontmatter tag lists. Just the tag name.
Standard Markdown plus Obsidian extensions:
| Syntax | Result |
|---|---|
**bold** | Bold |
*italic* | Italic |
~~strikethrough~~ | Strikethrough |
==highlight== | Highlighted text (yellow in Obsidian) |
`inline code` | Inline code |
Obsidian uses MathJax/KaTeX:
Inline math:
$E = mc^2$
Block math:
$$
\int_0^\infty e^{-x} dx = 1
$$
Standard fenced code blocks. Obsidian highlights all common languages:
```python
def hello():
return "world"
```
Standard Markdown tables:
| Column A | Column B | Column C |
| -------- | -------- | -------- |
| Value | Value | Value |
| Value | Value | Value |
Obsidian renders tables natively. No plugin needed.
Obsidian renders Mermaid natively:
```mermaid
graph TD
A[Start] --> B{Decision}
B -->|Yes| C[End]
B -->|No| D[Loop]
D --> A
```
Supported: graph, sequenceDiagram, gantt, classDiagram, pie, flowchart.
This sentence has a footnote.[^1]
[^1]: The footnote text goes here.
[text](path.md) for internal links; use [[Note Name]]## inside callout bodytags: [a,b,c] inline; use list formatYYYY-MM-DD