obsidian-markdown

The obsidian-markdown skill provides specialized support for managing notes within an Obsidian vault. It focuses on the extended syntax that makes Obsidian a powerful tool for Personal Knowledge Management (PKM), allowing agents to generate or refactor content that adheres to Obsidian’s unique formatting standards. This skill is designed for researchers, writers, and knowledge workers who utilize Obsidian for note-taking, project tracking, and complex documentation. It enables the creation of highly interconnected notes that leverage the graph view and advanced rendering features of the Obsidian application.

• Full support for internal wikilinks using [[Note Name]] and [[Note Name#Heading]] syntax, including block-level referencing with ^block-id.

• Comprehensive handling of Obsidian frontmatter (YAML properties) for metadata such as title, date, aliases, cssclasses, and custom user-defined fields.

• Integration of media and note embeds using the ![[link]] syntax for images, PDFs, and transcluded note sections.

• Advanced formatting capabilities including callouts (admonitions) with various types like note, warning, info, success, and danger, as well as foldable callout sections.

• Support for LaTeX math blocks, Mermaid diagrams, and specialized markdown extensions like highlighting (==text==) and internal comments.

• Automatic conversion of standard markdown links versus vault-internal wikilinks to ensure robust link integrity.

• Use this skill when generating content intended for an Obsidian vault to ensure correct compatibility with the Obsidian reading view.

• Always define frontmatter properties at the beginning of the file to ensure the vault correctly indexes tags, aliases, and metadata.

• Leverage block IDs to enable precise linking to individual paragraphs, lists, or quotes within larger documents.

• When creating diagrams or flowcharts, use the Mermaid code block support to ensure they render directly within the Obsidian interface.

• Ensure that all external references are clearly distinguished from internal vault links to maintain the reliability of the graph view. Note that this skill assumes basic CommonMark knowledge and focuses specifically on the features exclusive to the Obsidian ecosystem.