obsidian-publisher

Publish Markdown notes and Mermaid diagrams to Obsidian vaults.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/neverprepared/ink-bunny --skill obsidian-publisher-neverprepared
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-publisher
Source: https://github.com/neverprepared/ink-bunny/tree/main/reflex/plugins/reflex/skills/obsidian-publisher
Command: npx skills add https://github.com/neverprepared/ink-bunny --skill obsidian-publisher-neverprepared

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Obsidian vaults often require consistent publishing of notes and diagrams. This Skill streamlines writing Markdown notes and Mermaid diagrams directly into Obsidian vaults, reducing manual file management.

Core Features & Use Cases

  • Publish Markdown notes to a specified vault folder, including optional frontmatter such as title, date, and tags.
  • Render Mermaid diagrams inline within notes and ensure they are saved in the correct vault structure (attachments, templates).
  • Use case: a researcher exports weekly findings as notes with diagrams to a shared vault for team review.

Quick Start

Create a markdown note in the vault with a basic frontmatter block and an embedded Mermaid diagram.

Frequently Asked Questions about obsidian-publisher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish markdown notes and mermaid diagrams to an Obsidian vault?

To publish markdown notes and mermaid diagrams to an Obsidian vault, this Skill creates or updates Markdown files with optional frontmatter, handles folder structures, and preserves Mermaid diagrams within the specified vault directories.

Can I add frontmatter like title, date, and tags when saving notes to an Obsidian vault?

Yes, you can add frontmatter to notes saved in an Obsidian vault. This Skill supports including optional frontmatter blocks with metadata such as titles, dates, and tags when creating or updating Markdown files.

Does this method for publishing to Obsidian vaults preserve mermaid diagrams?

Yes, publishing to Obsidian vaults with this approach preserves mermaid diagrams. It renders Mermaid diagrams inline within notes and ensures they are saved correctly in the vault structure, including attachments and templates.

What is the best way to maintain folder structures when exporting markdown files to a knowledge graph?

The best way to maintain folder structures when exporting markdown files is using a publishing process that handles vault directories natively. This Skill manages folder structures automatically when creating or updating notes and documentation.

Is this Obsidian vault publishing approach suitable for team documentation and shared research notes?

Yes, this Obsidian vault publishing approach is suitable for team documentation and shared research notes. It is designed for researchers, students, and teams who maintain vaults for notes, documentation, and knowledge graphs.