obsidian-markdown

star 1

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.

lucasbenevinuto By lucasbenevinuto schedule Updated 3/3/2026
play_arrow Run Skill in Manus View GitHub

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.

PATH DO VAULT DO OBSIDIAN: /home/lucas/Documents/Dev

Obsidian Flavored Markdown Skill

This skill enables skills-compatible agents to create and edit valid Obsidian Flavored Markdown using the Obsidian CLI and Obsidian-specific syntax.

CLI Commands

ALWAYS prefer CLI commands over direct file manipulation. The CLI interacts with the running Obsidian instance, ensuring proper indexing, syncing, and plugin processing.

Run commands via: obsidian <command> [options]

  • Target a specific vault: obsidian <command> vault="Vault Name"
  • File resolves by name (like wikilinks), path is exact (folder/note.md)
  • Most commands default to the active file when file/path is omitted
  • Quote values with spaces: name="My Note"
  • Use \n for newline, \t for tab in content values

File Operations

# Create a new note
obsidian create name="Note Name" content="# Title\n\nContent here"
obsidian create path="Folder/Note.md" content="Content" template="Template Name"
obsidian create name="Note" content="Content" open        # Open after creating
obsidian create name="Note" content="Content" open newtab  # Open in new tab

# Read a note
obsidian read file="Note Name"
obsidian read path="Folder/Note.md"

# Append content to a note
obsidian append file="Note Name" content="\n## New Section\n\nContent"
obsidian append path="Folder/Note.md" content="Appended text" inline  # No newline

# Prepend content to a note
obsidian prepend file="Note Name" content="Prepended text"
obsidian prepend path="Folder/Note.md" content="Text" inline

# Open a note
obsidian open file="Note Name"
obsidian open path="Folder/Note.md" newtab

# Move/rename a note
obsidian move file="Note Name" to="New Folder/"
obsidian move path="Old/Note.md" to="New/Path/Note.md"
obsidian rename file="Note Name" name="New Name"

# Delete a note
obsidian delete file="Note Name"              # Move to trash
obsidian delete path="Folder/Note.md" permanent  # Permanent delete

# File info
obsidian file file="Note Name"
obsidian files                           # List all files
obsidian files folder="Folder" ext=md    # Filter by folder and extension
obsidian files total                     # File count
obsidian folders                         # List all folders
obsidian recents                         # Recently opened files

Properties (Frontmatter)

# Set a property on a file
obsidian property:set name="status" value="active" file="Note Name"
obsidian property:set name="tags" value="[project, active]" type=list file="Note"
obsidian property:set name="priority" value="5" type=number file="Note"
obsidian property:set name="done" value="true" type=checkbox file="Note"
obsidian property:set name="due" value="2026-03-15" type=date file="Note"

# Read a property
obsidian property:read name="status" file="Note Name"

# Remove a property
obsidian property:remove name="status" file="Note Name"

# List properties
obsidian properties                                  # All vault properties
obsidian properties file="Note Name"                 # Properties of a file
obsidian properties file="Note" format=json          # JSON output
obsidian properties sort=count counts                # Sorted by frequency
obsidian properties active                           # Active file properties

Tags

# List all tags in vault
obsidian tags
obsidian tags counts sort=count           # With counts, sorted
obsidian tags file="Note Name"            # Tags in a specific file
obsidian tags format=json                 # JSON output
obsidian tags active                      # Active file tags
obsidian tags total                       # Tag count

# Get tag info
obsidian tag name="project"               # Tag occurrence count
obsidian tag name="project" verbose        # Include file list
obsidian tag name="project" total          # Just the count

Links and Backlinks

# Outgoing links from a file
obsidian links file="Note Name"
obsidian links file="Note Name" total     # Link count

# Backlinks to a file
obsidian backlinks file="Note Name"
obsidian backlinks file="Note Name" counts          # Include link counts
obsidian backlinks file="Note Name" format=json     # JSON output
obsidian backlinks file="Note Name" total           # Count only

# Find orphans and dead ends
obsidian orphans                           # Files with no incoming links
obsidian orphans total                     # Orphan count
obsidian deadends                          # Files with no outgoing links
obsidian unresolved                        # Unresolved links in vault
obsidian unresolved verbose counts         # With source files and counts

Search

# Search vault
obsidian search query="search text"
obsidian search query="search text" path="Folder" limit=10
obsidian search query="text" format=json
obsidian search query="text" case                   # Case sensitive
obsidian search query="text" total                  # Match count only

# Search with context (matching lines)
obsidian search:context query="search text"
obsidian search:context query="text" path="Folder" format=json

# Open search UI
obsidian search:open query="search text"

Tasks

# List tasks
obsidian tasks                             # All tasks
obsidian tasks todo                        # Incomplete tasks only
obsidian tasks done                        # Completed tasks only
obsidian tasks file="Note Name"            # Tasks in a file
obsidian tasks verbose                     # Group by file with line numbers
obsidian tasks format=json                 # JSON output
obsidian tasks active                      # Active file tasks
obsidian tasks daily                       # Daily note tasks
obsidian tasks total                       # Task count
obsidian tasks status="/"                  # Filter by custom status character

# Manage a specific task
obsidian task file="Note Name" line=5 toggle    # Toggle status
obsidian task file="Note Name" line=5 done      # Mark as done
obsidian task file="Note Name" line=5 todo      # Mark as todo
obsidian task ref="Folder/Note.md:5" toggle     # Using ref shorthand
obsidian task daily line=3 done                 # Daily note task

Daily Notes

# Open daily note
obsidian daily
obsidian daily paneType=tab               # Open in new tab

# Read daily note
obsidian daily:read

# Get daily note path
obsidian daily:path

# Append to daily note
obsidian daily:append content="- New entry"
obsidian daily:append content="inline text" inline

# Prepend to daily note
obsidian daily:prepend content="# Morning\n\nNotes here"

Templates

# List templates
obsidian templates
obsidian templates total

# Read a template
obsidian template:read name="Template Name"
obsidian template:read name="Template Name" resolve title="Note Title"

# Insert template into active file
obsidian template:insert name="Template Name"

Aliases and Outline

# Aliases
obsidian aliases                           # List all aliases
obsidian aliases file="Note Name"          # Aliases for a file
obsidian aliases verbose                   # Include file paths

# Outline (headings)
obsidian outline file="Note Name"                  # Tree format
obsidian outline file="Note Name" format=md        # Markdown format
obsidian outline file="Note Name" format=json      # JSON format
obsidian outline file="Note Name" total            # Heading count

Bookmarks

# Add bookmarks
obsidian bookmark file="Folder/Note.md"
obsidian bookmark file="Note.md" subpath="#Heading"
obsidian bookmark folder="Projects"
obsidian bookmark search="query text"
obsidian bookmark url="https://example.com" title="Example"

# List bookmarks
obsidian bookmarks
obsidian bookmarks verbose                 # Include types
obsidian bookmarks format=json

Word Count

obsidian wordcount file="Note Name"
obsidian wordcount file="Note" words          # Words only
obsidian wordcount file="Note" characters     # Characters only

History and Versions

# File history
obsidian history file="Note Name"              # List versions
obsidian history:list                          # Files with history
obsidian history:read file="Note" version=1   # Read a version
obsidian history:restore file="Note" version=2  # Restore a version

# File diff (local/sync versions)
obsidian diff file="Note Name"                 # List versions
obsidian diff file="Note" from=1 to=3         # Diff between versions

Vault Info

obsidian vault                             # Vault info
obsidian vault info=name                   # Just vault name
obsidian vault info=path                   # Just vault path
obsidian vaults                            # List all vaults
obsidian version                           # Obsidian version

Plugins and Themes

# Plugins
obsidian plugins                           # List all plugins
obsidian plugins:enabled                   # Enabled plugins only
obsidian plugin id="plugin-id"             # Plugin info
obsidian plugin:enable id="plugin-id"
obsidian plugin:disable id="plugin-id"
obsidian plugin:install id="plugin-id" enable

# Themes
obsidian themes                            # List themes
obsidian theme                             # Active theme
obsidian theme:set name="Theme Name"
obsidian theme:install name="Theme Name" enable

# CSS Snippets
obsidian snippets                          # List snippets
obsidian snippet:enable name="snippet"
obsidian snippet:disable name="snippet"

Commands and Hotkeys

obsidian commands                          # List all commands
obsidian commands filter="editor"          # Filter by prefix
obsidian command id="command-id"           # Execute a command
obsidian hotkeys                           # List hotkeys
obsidian hotkey id="command-id"            # Get hotkey for command

Sync

obsidian sync:status                       # Sync status
obsidian sync on                           # Resume sync
obsidian sync off                          # Pause sync
obsidian sync:history file="Note Name"     # Sync history for file
obsidian sync:read file="Note" version=1   # Read sync version
obsidian sync:restore file="Note" version=1  # Restore sync version
obsidian sync:deleted                      # Deleted files in sync

Tabs and Workspace

obsidian tabs                              # List open tabs
obsidian tabs ids                          # Include tab IDs
obsidian tab:open file="Note.md"           # Open file in new tab
obsidian workspace                         # Show workspace tree

Miscellaneous

obsidian random                            # Open random note
obsidian random:read                       # Read random note
obsidian reload                            # Reload vault
obsidian restart                           # Restart app

Obsidian Flavored Markdown Reference

Obsidian uses a combination of:

Internal Links (Wikilinks)

[[Note Name]]
[[Note Name|Display Text]]
[[Note Name#Heading]]
[[Note Name#^block-id]]
[[#Heading in same note]]

Embeds

![[Note Name]]
![[Note Name#Heading]]
![[image.png]]
![[image.png|300]]
![[document.pdf#page=3]]
![[audio.mp3]]

Callouts

> [!note]
> This is a note callout.

> [!info] Custom Title
> This callout has a custom title.

> [!faq]- Collapsed by default
> Hidden until expanded.

> [!faq]+ Expanded by default
> Visible but collapsible.

Supported types: note, abstract/summary/tldr, info, todo, tip/hint/important, success/check/done, question/help/faq, warning/caution/attention, failure/fail/missing, danger/error, bug, example, quote/cite

Task Lists

- [ ] Incomplete task
- [x] Completed task
- [/] In progress (custom status)

Properties (Frontmatter)

---
title: My Note Title
date: 2024-01-15
tags:
  - project
  - important
aliases:
  - My Note
cssclasses:
  - custom-class
status: in-progress
---

Property types: Text, Number, Checkbox, Date, Date & Time, List, Links (related: "[[Other Note]]")

Tags

#tag
#nested/tag
#tag-with-dashes

# In frontmatter:
tags:
  - tag1
  - nested/tag2

Block IDs

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

> A quote block
> with multiple lines

^quote-id

Math (LaTeX)

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

Block:
$$
\begin{vmatrix}a & b \\ c & d\end{vmatrix} = ad - bc
$$

Diagrams (Mermaid)

```mermaid
graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Do this]
    B -->|No| D[Do that]
```

Comments

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

%%
This entire block is hidden in reading view.
%%

Footnotes

This has a footnote[^1].

[^1]: This is the footnote content.

Inline footnotes also work.^[This is inline.]

Text Formatting

Style Syntax
Bold **text**
Italic *text*
Bold + Italic ***text***
Strikethrough ~~text~~
Highlight ==text==
Inline code `code`

Embed Search Results

```query
tag:#project status:done
```

References

Install via CLI
npx skills add https://github.com/lucasbenevinuto/orbit-backend --skill obsidian-markdown
Repository Details
star Stars 1
call_split Forks 0
navigation Branch main
article Path SKILL.md
Occupations
Office Clerks General 439061
More from Creator
lucasbenevinuto
lucasbenevinuto Explore all skills →