npx skills add ...
npx skills add davila7/claude-code-templates --skill obsidian-markdown
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.
npx skills add davila7/claude-code-templates --skill obsidian-markdown
This skill enables Claude Code to create and edit valid Obsidian Flavored Markdown, including all Obsidian-specific syntax extensions.
Obsidian uses a combination of Markdown flavors:
| Style | Syntax | Example | Output |
|---|---|---|---|
| Bold | **text** or __text__ | **Bold** | Bold |
| Italic | *text* or _text_ | *Italic* | Italic |
| Bold + Italic | ***text*** | ***Both*** | Both |
| Strikethrough | ~~text~~ | ~~Striked~~ | |
| Highlight | ==text== | ==Highlighted== | ==Highlighted== |
| Inline code | `code` | `code` | code |
Use backslash to escape special characters:
Common characters to escape: \*, \_, \#, \`, \|, \~
Define a block ID by adding ^block-id at the end of a paragraph:
For lists and quotes, add the block ID on a separate line:
Note: Spaces must be URL-encoded as %20 in Markdown links.
Where the list has been defined with a block ID:
| Type | Aliases | Description |
|---|---|---|
note | - | Blue, pencil icon |
abstract | summary, tldr | Teal, clipboard icon |
info | - | Blue, info icon |
todo | - | Blue, checkbox icon |
tip | hint, important | Cyan, flame icon |
success | check, done | Green, checkmark icon |
question | help, faq | Yellow, question mark |
warning | caution, attention | Orange, warning icon |
failure | fail, missing | Red, X icon |
danger | error | Red, zap icon |
bug | - | Red, bug icon |
example | - | Purple, list icon |
quote | cite | Gray, quote icon |
Use more backticks or tildes for the outer block:
Escape pipes with backslash:
Properties use YAML frontmatter at the start of a note:
| Type | Example |
|---|---|
| Text | title: My Title |
| Number | rating: 4.5 |
| Checkbox | completed: true |
| Date | date: 2024-01-15 |
| Date & Time | due: 2024-01-15T14:30:00 |
| List | tags: [one, two] or YAML list |
| Links | related: "[[Other Note]]" |
tags - Note tagsaliases - Alternative names for the notecssclasses - CSS classes applied to the noteTags can contain:
_-/ (for nesting)Obsidian supports HTML within Markdown:
\*This won't be italic\*
\#This won't be a heading
1\. This won't be a list item[[Note Name]]
[[Note Name.md]]
[[Note Name|Display Text]][[Note Name#Heading]]
[[Note Name#Heading|Custom Text]]
[[#Heading in same note]]
[[##Search all headings in vault]][[Note Name#^block-id]]
[[Note Name#^block-id|Custom Text]]This is a paragraph that can be linked to. ^my-block-id> This is a quote
> With multiple lines
^quote-id[[##heading]] Search for headings containing "heading"
[[^^block]] Search for blocks containing "block"[Display Text](Note%20Name.md)
[Display Text](Note%20Name.md#Heading)
[Display Text](https://example.com)
[Note](obsidian://open?vault=VaultName&file=Note.md)![[Note Name]]
![[Note Name#Heading]]
![[Note Name#^block-id]]![[image.png]]
![[image.png|640x480]] Width x Height
![[image.png|300]] Width only (maintains aspect ratio)
![[audio.mp3]]
![[audio.ogg]]![[document.pdf]]
![[document.pdf#page=3]]
![[document.pdf#height=400]]![[Note#^list-id]]- Item 1
- Item 2
- Item 3
^list-id| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1 | Cell 2 | Cell 3 |
| Cell 4 | Cell 5 | Cell 6 || Left | Center | Right |
|:---------|:--------:|---------:|
| Left | Center | Right || Column 1 | Column 2 |
|----------|----------|
| [[Link\|Display]] | ![[Image\|100]] |This is inline math: $e^{i\pi} + 1 = 0$$$
\begin{vmatrix}
a & b \\
c & d
\end{vmatrix} = ad - bc
$$$x^2$ Superscript
$x_i$ Subscript
$\frac{a}{b}$ Fraction
$\sqrt{x}$ Square root
$\sum_{i=1}^{n}$ Summation
$\int_a^b$ Integral
$\alpha, \beta$ Greek letters