n8n-nodes-markmap

This is an n8n community node that converts Markdown text into a self-contained, interactive markmap mind-map HTML page.

markmap is a library that visualizes Markdown documents as interactive mind maps.

Note: This node supports both CDN and Local rendering modes. By default, it uses CDN for faster loading. You can switch to Local mode for offline use.

Installation

Follow the n8n community nodes installation guide.

npm install n8n-nodes-markmap

Operations

Markdown to HTML

Takes Markdown text as input and produces a fully self-contained HTML page with an interactive mind-map visualization.

Inputs:

Options:

Node Spacing Options:

Table Spacing Options:

Screenshot Options:

Output:

The node adds a field (default: html) to each item containing the complete HTML page string. You can then:

• Write it to a file using the Write Binary File node
• Send it as an email attachment
• Return it as an HTTP response
• Store it in a database

When screenshot is enabled, the node will also output:

• Binary mode: A binary field named screenshot containing the PNG image
• Base64 mode: JSON fields screenshotBase64 and screenshotMimeType containing the base64-encoded image

Markdown Format Specification

The node uses standard Markdown syntax to build the mind-map hierarchy:

• # Title - Root node (level 1 heading), represents the main topic
• ## Branch - Second-level node (level 2 heading), represents main branches
• ### Sub-branch - Third-level node (level 3 heading), represents sub-branches
• - List item - Leaf nodes (bullet points), represents end content

Example Structure:

# Project Plan (root)
## Phase 1 (branch)
### Task A (sub-branch)
- Detail 1 (leaf)
- Detail 2 (leaf)
## Phase 2 (branch)
- Summary (leaf)

The hierarchy is: # Root → ## Branch → ### Sub-branch → - Leaf

Supported Markdown Features

Frontmatter Configuration

You can configure markmap options using YAML frontmatter at the beginning of your Markdown:

---
title: My Mindmap
markmap:
  colorFreezeLevel: 2
  maxWidth: 300
---

# Your content here

Text Formatting

• Bold text: **strong**
• Strikethrough: ~~del~~
• Italic: *italic*
• ==Highlight==: ==highlight==
• Inline code: `inline code`

Lists

• Unordered lists with - or *
• Ordered lists with 1. 2. 3.
• Nested lists by indentation
• Checkbox support: [x] for checked, [ ] for unchecked

- Parent item
  - Child item 1
  - Child item 2
- [x] Completed task
- [ ] Pending task

Code Blocks

Syntax highlighted code blocks:

```javascript
console.log('Hello, World!');

### Tables

Markdown tables are fully supported:

```markdown
| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Data 1   | Data 2   | Data 3   |
| Data 4   | Data 5   | Data 6   |

Math (Katex)

Mathematical expressions using Katex:

- $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$ <!-- markmap: fold -->

Links

• External links: https://markmap.js.org/
• GitHub links: https://github.com/gera2ld/markmap

Images

![](https://markmap.js.org/favicon.png)

Important Notes

• If blocks (like code blocks, tables) and lists appear at the same level, the lists will be ignored
• Use the maxWidth option to wrap very long text
• Add <!-- markmap: fold --> comment to fold specific nodes by default

Example Workflows

Basic HTML Generation

[Manual Trigger] -> [Set node with Markdown] -> [Markmap] -> [Write Binary File]

With Screenshot

[Manual Trigger] -> [Set node with Markdown] -> [Markmap with Screenshot enabled] -> [Write Binary File for HTML] -> [Write Binary File for Screenshot]

With Custom Spacing

[Manual Trigger] -> [Set node with Markdown] -> [Markmap with Node Spacing (Horizontal: 120, Vertical: 15)] -> [Write Binary File]

Changelog

v0.1.5 (2026-02-20)

New Features

• Node Spacing Options: Added configurable spacing parameters for better control over mindmap layout
  • Horizontal Spacing: Control horizontal distance between nodes (default: 80px)
  • Vertical Spacing: Control vertical distance between nodes (default: 5px)
  • Node Min Height: Set minimum height for nodes (default: 16px)
  • Padding X: Set horizontal padding inside nodes (default: 8px)
• Table Spacing Options: Added styling options for tables in mindmaps
  • Table Cell Padding: Customize padding inside table cells (default: 4px 8px)
  • Table Margin: Customize margin around tables (default: 8px 0)

v0.1.4 (2025-02-12)

Features

• Initial release
• Markdown to HTML conversion
• CDN and Local rendering modes
• Screenshot generation with Puppeteer
• Color freeze level configuration
• Initial expand level control
• Zoom and pan controls

Related Projects

• markmap-cli - CLI version
• coc-markmap - For Neovim
• markmap-vscode - For VSCode
• eaf-markmap - For Emacs

Compatibility

• n8n >= 1.0.0
• Node.js >= 18

License

MIT