| 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 for this vault. Use this skill when the task is about note creation, metadata cleanup, wikilinks, embeds, callouts, tags, note cleanup, or note restructuring.
This skill keeps task rules and vault-specific conventions in the main body. Syntax tables and longer examples live in references/.
Workflow: Creating or Editing an Obsidian Note
- Inspect the note context: identify the note
kind, optional format, intended folder, nearby linked notes, and whether a matching template already exists.
- Look for relevant templates: first look for a template under this note's
kind. If that kind has multiple recurring expression shapes or stable template patterns, use the relevant format or descriptive subfolder subdivision. If no matching template exists, create a new note following the vault's naming and folder rules.
- Add or update frontmatter: prefer the vault's minimal property set. See PROPERTIES.md for property syntax details.
- Preserve prose: make minimal edits; do not rewrite prose just to normalize style.
- Add semantic connections: use wikilinks for internal notes (a unresolved link is allowed for future reference), Markdown links for external URLs, and add tags only when they improve retrieval.
- Use Obsidian features only when they serve the note: embeds, callouts, comments, highlights, math, Mermaid, and footnotes are available but should not be added mechanically.
- Validate before finishing: check YAML validity, wikilinks, embeds, callouts, and whether the note now follows the vault conventions below.
When choosing between wikilinks and Markdown links: use [[wikilinks]] for notes within the vault (Obsidian tracks renames automatically) and [text](url) for external URLs only.
Vault Policy
- Follow the vault-wide naming, metadata, tag, linking, and template rules defined in
AGENTS.md.
- Use this skill to apply those rules while editing notes; do not redefine them here.
Validation Checklist
- Frontmatter is valid YAML.
tags are topical keywords, not structured categories.kind is present when the note is meant to be maintained long-term.format is present when it adds retrieval, workflow, or template value.- Internal references use wikilinks and external references use Markdown links.
- Links added are semantic rather than decorative.
- File naming and attachment placement still follow the vault rules.
References
