Metadata-Version: 2.4
Name: markmap-cli
Version: 0.1.0
Summary: Convert markdown files into interactive, self-contained mindmap HTML files
Author: Martin Uhlmann
License: MIT
Project-URL: Homepage, https://github.com/martinu/markmap-cli
Project-URL: Repository, https://github.com/martinu/markmap-cli
Project-URL: BugTracker, https://github.com/martinu/markmap-cli/issues
Keywords: markdown,mindmap,markmap,cli,knowledge
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Text Processing :: Markup :: HTML
Classifier: Topic :: Office/Business :: News/Diary
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-Extra: dev

# 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.

```bash
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 `.md` in a folder
- **Watch mode** — re-render on save (great for live editing)
- **Minified output** — use `--minify` for 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](https://markmap.js.org/) JavaScript library. Content between headings is attached as leaf nodes. The library is loaded from CDN in the generated HTML.

## License

MIT
