obsidian-markdown

The obsidian-markdown skill enables agents to generate, format, and manipulate notes within an Obsidian vault using its proprietary syntax. It is designed for knowledge workers, researchers, and writers who rely on the Obsidian ecosystem to maintain a connected knowledge base. By understanding the distinction between standard CommonMark/GFM and Obsidian-specific extensions, the agent can effectively manage vault files, internal references, and structured metadata. This skill is essential for maintaining the integrity of bidirectional links and visual organization features inherent to Obsidian.

• Full support for wikilink syntax including [[Note Name]], [[Note Name|Display Text]], headings, and block-level references via ^block-id.

• Advanced embedding capabilities for images, PDFs, audio, video, and cross-note content using the ![[link]] syntax.

• Structured data management through YAML frontmatter (properties), supporting types like text, numbers, dates, lists, and boolean checkboxes.

• Semantic block styling with callouts, allowing for various types like note, tip, warning, danger, and success for improved readability.

• Integration of mathematical notation via LaTeX, diagramming via Mermaid, and hidden comments for internal note-taking.

• Formatting extensions including text highlights, nested tags, and complex footnotes.

• Always prefer wikilinks ([[...]]) for internal vault connections to leverage Obsidian's automatic renaming and link tracking.

• Use standard Markdown links text exclusively for external URLs to distinguish between local vault structure and web resources.

• When creating notes, include frontmatter at the top of the file to define essential properties such as tags, aliases, and status to ensure the note is discoverable in the graph view.

• Ensure complex embeds like Mermaid diagrams or nested callouts maintain proper indentation and syntax to render correctly in Obsidian’s reading view.

• The skill assumes the user has basic knowledge of standard Markdown; it specifically handles the 'Obsidian-flavored' layer that transforms a simple text file into a networked knowledge entity.