obsidian-publisher

Write Markdown notes and Mermaid diagrams into Obsidian vault folders.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Obsidian users often manually create notes and diagrams across vaults, duplicating effort and risking inconsistent formatting. This Skill provides a simple way to programmatically write Markdown notes and Mermaid diagrams directly into an Obsidian vault, ensuring content lands in the correct location.

Core Features & Use Cases

  • Write Markdown notes to a specified vault folder, simplifying note creation for research, project documentation, and knowledge bases.
  • Generate Mermaid diagrams within notes, enabling clear visual representations of system designs, workflows, and mind maps.
  • Optional frontmatter support and structured notes to facilitate organization, templating, and later retrieval.

Quick Start

To publish a new note, provide vault_path, folder, filename, and content. Example: publish note to vault_path "/path/to/vault" in folder "projects/2026" with filename "System-Overview" and markdown content describing the architecture.

Frequently Asked Questions about obsidian-publisher

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

FAQPage Schema
How do I automate publishing markdown notes to my Obsidian vault?

You can programmatically write markdown notes directly to an Obsidian vault by specifying the vault path, target folder, filename, and content. This eliminates manual note creation and ensures consistent formatting across your vault.

Can I generate Mermaid diagrams and publish them into Obsidian notes?

Yes, this Skill generates Mermaid diagrams and embeds them within markdown notes written to your vault. This lets you create visual representations like system designs, workflows, and mind maps without manual diagram placement.

What's the best way to organize published notes with frontmatter in Obsidian?

You can add optional frontmatter to structured notes during publishing, enabling metadata like tags, dates, and custom fields. This facilitates organization, templating, and later retrieval within your Obsidian knowledge base.

Can I publish notes to specific folders and maintain vault structure?

You specify the vault path, folder hierarchy, and filename during publishing, so generated notes land in the exact location you define. This preserves your vault's organization across research, projects, and documentation folders.

Does this work for both research documentation and architecture diagrams?

Yes, the Skill handles research note publishing, project documentation, and architecture diagrams. It supports markdown content and embedded Mermaid visuals suited to knowledge work across multiple vault folders.