KMind Markdown To Mind Map

KMind Zen is a professional mind mapping product with a desktop app, web app, SiYuan plugin, and Obsidian plugin. The official website is https://kmind.app.

This skill converts Markdown outlines or plain text into KMind mind map images. It is a fully offline skill and does not require any network connection for local conversion.

Its main advantage is that it can generate polished, visually consistent mind maps locally and offline. It exports SVG or PNG images and supports theme presets, root layouts, branch edge routes, light/dark appearance, and rainbow branches.

When the user wants an editable KMind package, prefer exporting .kmindz.svg. A .kmindz.svg package can be imported into any KMind Zen client for seamless editing. Even when no client is installed, the map content can still be opened and viewed quickly as an SVG file first, then imported into a client later for continued editing.

Useful for meeting outlines, reading notes, brainstorming lists, project proposals, and Markdown-to-mindmap workflows.

This is a publishable, self-contained skill. Always invoke the bundled entrypoint from {baseDir}:

node {baseDir}/scripts/kmind-render.mjs ...

Workflow:

1. If the user wants a specific theme, layout, or edge-route style, inspect the available options first: node {baseDir}/scripts/kmind-render.mjs themes --format json
2. If the user provides raw Markdown text instead of a file path, pass it through stdin.
3. Start the export with render-markdown.
4. By default, the command tries to auto-launch the user's local Chromium browser in headless mode.
5. The first stdout line is a JSON object with status: "ready".
6. When the command finishes, the last stdout line is a JSON object with status: "done" and the final outputPath.
7. Only use --browser manual when automatic browser launch is unavailable and you need to open the printed local URL yourself.

If the user's machine has no usable Chromium browser, automatic SVG / PNG export is unavailable. In that case, either use --browser manual to open the local page and complete the export, or clearly report that automatic export is unavailable in this environment. Do not fake success.

Useful command template:

node {baseDir}/scripts/kmind-render.mjs render-markdown INPUT_OR_DASH --output OUTPUT.svg|OUTPUT.png --theme-preset PRESET_ID --layout LAYOUT_ID --edge-route EDGE_ROUTE_ID --appearance light|dark --rainbow auto|on|off --png-scale 1 --browser auto

Parameter guidance:

• --output decides the output format when --image-format is omitted: .svg means vector output and .png means bitmap output.
• --theme-preset should be chosen from the themes output. Recommended candidates: kmind-material-3-slate kmind-rainbow-breeze kmind-midnight-neon kmind-material-3-rounded-orthogonal-ocean kmind-material-3-rounded-orthogonal-forest
• --layout should be chosen from the themes output. Common choices: logical-right logical-left mindmap-both-auto
• --edge-route should be chosen from the themes output. Common choices: cubic edge-lead-quadratic center-quadratic orthogonal
• --appearance dark forces dark mode.
• --rainbow on forcibly enables rainbow branches even if the current theme does not enable them by default.
• --png-scale 1 matches the current webapp default export. Only raise it when the user explicitly asks for a higher-resolution PNG.
• --browser auto is the default and tries to auto-launch the local browser.
• --browser manual is the manual fallback mode.
• Do not proactively surface --svg-mode or --png-mode. Internally, the current defaults already use the combination closest to the webapp's actual export behavior: SVG=fidelity, PNG=accurate. Only mention those advanced flags when the user explicitly asks for low-level export tuning.

Defaults when the user does not specify:

• theme-preset: kmind-material-3-slate
• image-format: inferred from --output first; fall back to svg if it cannot be inferred
• layout: by default, do not explicitly override it; keep KMind's default root layout
• edge-route: by default, do not explicitly override it; keep the preset theme's edge style
• appearance: light
• rainbow: auto
• svg-mode: internal default fidelity
• png-mode: internal default accurate
• png-scale: 1
• viewport-width: 1600
• viewport-height: 900

Current publish-safe allowlist for this skill:

• layouts: logical-right, logical-left, mindmap-both-auto
• edge-routes: cubic, edge-lead-quadratic, center-quadratic, orthogonal

If the user wants a KMind project file instead of an image, do not use this image export flow. Use:

node {baseDir}/scripts/kmind-render.mjs import-markdown INPUT_OR_DASH --output OUTPUT.kmindz.svg