| name | obsidian-markdown |
| description | Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes. |
Obsidian Flavored Markdown Skill
Create and edit valid Obsidian Flavored Markdown. Obsidian extends CommonMark and GFM with wikilinks, embeds, callouts, properties, comments, and other syntax.
Workflow: Creating an Obsidian Note
- Add frontmatter with properties (
title, tags, aliases) at the top. See PROPERTIES.md.
- Write content using standard Markdown.
- Link related notes with wikilinks (
[[Note]]) for internal links.
- Embed notes/files with
![[...]] syntax. See EMBEDS.md.
- Add callouts with
> [!type] syntax. See CALLOUTS.md.
- Verify rendering in Obsidian reading view.
Use [[wikilinks]] for vault notes and [text](url) for external links.
Internal Links (Wikilinks)
[[Note Name]]
[[Note Name|Display Text]]
[[Note Name#Heading]]
[[Note Name#^block-id]]
[[#Heading in same note]]
Define a block ID by appending ^block-id:
This paragraph can be linked to. ^my-block-id
Embeds
![[Note Name]]
![[Note Name#Heading]]
![[image.png]]
![[image.png|300]]
![[document.pdf#page=3]]
Callouts
> [!note]
> Basic callout.
> [!warning] Custom Title
> Callout with custom title.
> [!faq]- Collapsed by default
> Foldable callout.
Common types: note, tip, warning, info, example, quote, bug, danger, success, failure, question, abstract, todo.
Properties (Frontmatter)
---
title: My Note
date: 2024-01-15
tags:
- project
- active
aliases:
- Alternative Name
cssclasses:
- custom-class
---
Tags
#tag
#nested/tag
Comments
This is visible %%but this is hidden%% text.
%%
This block is hidden in reading view.
%%
Obsidian-Specific Formatting
==Highlighted text==
Math (LaTeX)
Inline: $e^{i\pi} + 1 = 0$
$$
\frac{a}{b} = c
$$
Diagrams (Mermaid)
```mermaid
graph TD
A[Start] --> B{Decision}
B -->|Yes| C[Do this]
B -->|No| D[Do that]
```
Footnotes
Text with a footnote[^1].
[^1]: Footnote content.
Inline footnote.^[This is inline.]
References
Local references:
Official docs:
