SKILL.md 2.3 KB
name: obsidian-markdown description: Create and edit Obsidian-specific Markdown syntax, including wikilinks, embeds, block references, callouts, properties, tags, and comments. Use for Obsidian notes when these extensions matter; ordinary Markdown is assumed knowledge. license: MIT metadata: copilot-enabled-agents: opencode, claude, codex copilot-builtin-version: "1"
copilot-upstream-revision: "a1dc48e681"
Obsidian Markdown
Use Obsidian-specific syntax accurately. Do not spend tokens explaining ordinary CommonMark or GFM unless the user asks.
Workflow
- Preserve existing frontmatter keys and formatting when editing a note.
- Use wikilinks for vault notes and Markdown links for external URLs.
- Use embeds, callouts, properties, tags, comments, and block references only when they improve the requested note.
- Check link targets, YAML validity, and block IDs after editing.
- Read the focused reference file when the task needs more syntax detail.
Wikilinks and block references
[[Note Name]]
[[Note Name|Display Text]]
[[Note Name#Heading]]
[[Note Name#^block-id]]
[[#Heading in this note]]
This paragraph is addressable. ^block-id
Put a block ID on its own line after a list or quote block.
Embeds
Prefix a wikilink with !:
![[Note Name]]
![[Note Name#Heading]]
![[image.png|300]]
![[document.pdf#page=3]]
See Embeds for media, PDF, and query forms.
Callouts
> [!warning] Custom title
> Important content.
> [!faq]- Collapsed by default
> Foldable content.
See Callouts for types, aliases, folding, and nesting.
Properties, tags, and comments
---
title: My Note
date: 2026-07-21
tags:
- project
aliases:
- Alternate Name
related: "[[Other Note]]"
---
Quote wikilinks used as YAML values. See Properties for supported property types and tag rules.
Use #nested/tag for inline tags. Hide content from reading view with
%%inline comments%% or a matching pair of %% markers on
separate lines.
Attribution
Adapted from kepano/obsidian-skills at revision
a1dc48e68138490d522c04cbf5822214c6eb1202. See LICENSE.