obsidian-markdown

Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, and properties. Covers Obsidian-specific syntax extensions: wikilinks ( [[Note]] ), embeds ( ![[Note]] ), callouts ( > [!type] ), block IDs, and frontmatter properties Supports internal vault linking with automatic rename tracking, plus embeds for notes, images, PDFs, and external media Includes callout types (note, warning, tip, danger, etc.), inline and block comments, highlights, LaTeX math, and Mermaid diagrams Assumes standard Markdown knowledge (headings, lists, tables, code blocks); focuses only on Obsidian extensions

INSTALLATION
npx skills add https://github.com/kepano/obsidian-skills --skill obsidian-markdown
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

$2a

[[Note Name]]                          Link to note

[[Note Name|Display Text]]             Custom display text

[[Note Name#Heading]]                  Link to heading

[[Note Name#^block-id]]                Link to block

[[#Heading in same note]]              Same-note heading link

Define a block ID by appending ^block-id to any paragraph:

This paragraph can be linked to. ^my-block-id

For lists and quotes, place the block ID on a separate line after the block:

> A quote block

^quote-id

Embeds

Prefix any wikilink with ! to embed its content inline:

![[Note Name]]                         Embed full note

![[Note Name#Heading]]                 Embed section

![[image.png]]                         Embed image

![[image.png|300]]                     Embed image with width

![[document.pdf#page=3]]               Embed PDF page

See EMBEDS.md for audio, video, search embeds, and external images.

Callouts

> [!note]

> Basic callout.

> [!warning] Custom Title

> Callout with a custom title.

> [!faq]- Collapsed by default

> Foldable callout (- collapsed, + expanded).

Common types: note, tip, warning, info, example, quote, bug, danger, success, failure, question, abstract, todo.

See CALLOUTS.md for the full list with aliases, nesting, and custom CSS callouts.

Properties (Frontmatter)

---

title: My Note

date: 2024-01-15

tags:

  - project

  - active

aliases:

  - Alternative Name

cssclasses:

  - custom-class

---

Default properties: tags (searchable labels), aliases (alternative note names for link suggestions), cssclasses (CSS classes for styling).

See PROPERTIES.md for all property types, tag syntax rules, and advanced usage.

Tags

#tag                    Inline tag

#nested/tag             Nested tag with hierarchy

Tags can contain letters, numbers (not first character), underscores, hyphens, and forward slashes. Tags can also be defined in frontmatter under the tags property.

Comments

This is visible %%but this is hidden%% text.

%%

This entire block is hidden in reading view.

%%

Obsidian-Specific Formatting

==Highlighted text==                   Highlight syntax

Math (LaTeX)

Inline: $e^{i\pi} + 1 = 0$

Block:

$$

\frac{a}{b} = c

$$

Diagrams (Mermaid)

graph TD

A[Start] --> B{Decision}

B -->|Yes| C[Do this]

B -->|No| D[Do that]

To link Mermaid nodes to Obsidian notes, add class NodeName internal-link;.

Footnotes

Text with a footnote[^1].

[^1]: Footnote content.

Inline footnote.^[This is inline.]

Complete Example

---

title: Project Alpha

date: 2024-01-15

tags:

  - project

  - active

status: in-progress

---

# Project Alpha

This project aims to [[improve workflow]] using modern techniques.

> [!important] Key Deadline

> The first milestone is due on ==January 30th==.

## Tasks

- [x] Initial planning

- [ ] Development phase

  - [ ] Backend implementation

  - [ ] Frontend design

## Notes

The algorithm uses $O(n \log n)$ sorting. See [[Algorithm Notes#Sorting]] for details.

![[Architecture Diagram.png|600]]

Reviewed in [[Meeting Notes 2024-01-10#Decisions]].

References

BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card