Skip to content

Support mind map rendering in Markdown preview (Mermaid mindmap / Markmap) #13

Description

@Chaoticyeung

First of all, thank you for building ColaMD. It is a really nice Markdown app, and I have already made it my default local Markdown editor.

Feature request

Mind map diagrams do not currently render in the Markdown preview. It would be great if ColaMD could add support for mind map rendering, either through Mermaid's mindmap syntax, Markmap, or another recommended approach.

Example

mindmap
  root((ColaMD))
    Markdown
      Preview
      Slides
    Diagrams
      Mind map
Loading

Another common option could be Markmap-style rendering from a Markdown outline:

# ColaMD
## Markdown
### Preview
### Slides
## Diagrams
### Mind map

Expected behavior

The preview renders the mind map as a diagram, ideally with good live-preview behavior while editing.

Actual behavior

In my local preview, the mind map content does not render as a mind map.

Possible implementation direction

If ColaMD already uses Mermaid internally, enabling Mermaid's mindmap support may be the smallest path. If the goal is a more Markdown-native mind map experience, Markmap could be a good fit because it turns regular Markdown heading/list structure into an interactive SVG mind map.

For real-time preview quality, a few details may help:

  • Render diagram blocks independently instead of re-rendering the whole document every keystroke.
  • Debounce diagram rendering, for example around 150-300 ms after edits.
  • Cache rendered diagrams by content hash so unchanged blocks do not re-render.
  • Use a Web Worker or idle-time rendering for heavier diagrams when possible.
  • Preserve pan/zoom state across updates for interactive mind maps.
  • Optionally support static SVG export for exported slides or HTML.

Environment

  • ColaMD: 1.5.0
  • macOS: 26.4.1
  • Architecture: arm64

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions