markmap-cli
Convert markdown files into interactive, self-contained mindmap HTML files.
No server, no build step — run markmap file.md and get a single HTML file you can open in any browser. Pan, zoom, collapse, and explore your document structure visually.
pip install markmap-cli
# Convert a single file
markmap README.md
# Convert all markdown files in a directory
markmap notes/
# Watch for changes and auto-render
markmap --watch docs/
Features
- Self-contained HTML — everything inline, no external dependencies at runtime
- Interactive — pan, zoom, collapse/expand nodes
- Directory batch — convert every
.mdin a folder - Watch mode — re-render on save (great for live editing)
- Minified output — use
--minifyfor smaller files - Handles nested headings —
#,##,###become tree levels
How it works
Parses markdown headings (# → root, ## → child, etc.) and generates a JSON tree consumed by the markmap JavaScript library. Content between headings is attached as leaf nodes. The library is loaded from CDN in the generated HTML.
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file markmap_cli-0.1.0.tar.gz.
File metadata
- Download URL: markmap_cli-0.1.0.tar.gz
- Upload date:
- Size: 5.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.8 {"installer":{"name":"uv","version":"0.12.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
81cd8c994053cfb0dd8d90e4cde37bd9d5054fc035d79ee1f126e3c832dfac74
|
|
| MD5 |
b04066f520bb9daf7acd197b957135d3
|
|
| BLAKE2b-256 |
c9d5fb60789a09e22daff2ceb069206208a8831d988974e6672282cfe4002205
|
File details
Details for the file markmap_cli-0.1.0-py3-none-any.whl.
File metadata
- Download URL: markmap_cli-0.1.0-py3-none-any.whl
- Upload date:
- Size: 5.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.8 {"installer":{"name":"uv","version":"0.12.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4623fd4e29d481ecde8a805b9328a7fe7dde6cfd349e1744c4a76e7f8f7e73b5
|
|
| MD5 |
8fc5f76d6db04041564ee629b1b14f63
|
|
| BLAKE2b-256 |
d28b6feb7b71b4254820682200ada8519fccc01ee34ca08143396a1e196d73ea
|
