joplin-publisher

Publish Markdown content and mermaid diagrams into Joplin notes via the Joplin CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables you to publish Markdown documents and mermaid diagrams directly into Joplin notes using the Joplin CLI, streamlining knowledge capture and organization.

Core Features & Use Cases

  • Import Markdown content into Joplin notebooks and create or update notes via the CLI.
  • Render mermaid diagrams inside Joplin notes for visual documentation.
  • Use cases include exporting research notes, project documentation, and diagrams to a centralized Joplin knowledge base.

Quick Start

Install the Joplin CLI globally and verify installation. Then create or select a notebook and publish a note with Markdown content that may include mermaid diagrams. Example usage commands are provided below.

Frequently Asked Questions about joplin-publisher

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

FAQPage Schema
How do I publish markdown notes into Joplin using the CLI?

Publishing markdown notes into Joplin uses the Joplin CLI to create or update notes directly from markdown files. Install the Joplin CLI globally, select or create a target notebook, then run the CLI commands to push your markdown content as structured notes into Joplin.

Can I render mermaid diagrams inside Joplin notes?

Yes, mermaid diagrams render inside Joplin notes when included as mermaid blocks within your markdown content. The Skill processes mermaid syntax and publishes it as visual diagrams alongside your markdown text in Joplin.

What do I need to set up before publishing notes to Joplin?

You need the Joplin CLI installed globally and accessible from your command line. Ensure target notebooks exist in Joplin or are creatable via the CLI, and prepare your content as markdown files with optional mermaid diagram blocks.

How do I export research documentation and diagrams to a centralized knowledge base?

Export research and documentation by converting markdown and mermaid diagrams into Joplin notes through the CLI workflow. This centralizes your knowledge base in Joplin while preserving formatting, structure, and visual diagrams in organized notebooks.

Does this work with existing Joplin notebooks or do I need to create new ones?

The Skill works with both existing and new notebooks. You can target existing Joplin notebooks for note creation or updates, or the CLI workflow can create notebooks as part of the publishing process.

What file formats and content types can I publish to Joplin?

Publish markdown-formatted content and mermaid diagram blocks to Joplin notes. The Skill accepts markdown files with embedded mermaid syntax and converts them into structured Joplin notes preserving both text and visual diagram content.