MkDocs plugin and extension to creates mindmaps from markdown using markmap
Project description
mkdocs-markmap
Beautiful and simple mindmaps written in markdown.
This is a plugin and an extension for mkdocs to add markmap.
Prerequisits
This plugin was tested with, but is not limited to:
- Python 3.8
- mkdocs 1.1
Quickstart
Install
pip install mkdocs-markmap
Configure
Add this to mkdocs.yml
:
plugins:
- markmap
Usage
This plugin supports code blocks of markdown as follows:
```markmap
# Root
## Branch 1
* Branchlet 1a
* Branchlet 1b
## Branch 2
* Branchlet 2a
* Branchlet 2b
```
It can also make use of file includes to keep your markdown tidy:
Look at this beautiful mindmap:
{!mindmap.mm.md!}
Advanced Settings
There are more options available for mkdocs.yml
(shown values are defaults):
plugins:
- markmap:
base_path: docs
encoding: utf-8
file_extension: .mm.md
d3_version: 6.7.0
lib_version: 0.11.5
view_version: 0.2.6
In addition, feel free to define your favourite source urls like this:
extra_javascript:
- https://unpkg.com/d3@6.7.0/dist/d3.min.js
- https://unpkg.com/markmap-lib@0.11.5/dist/browser/index.min.js
- https://unpkg.com/markmap-view@0.2.6/dist/index.min.js
:warning: The urls need to contain one of these keywords to be considered as deviation from default:
d3
markmap-lib
markmap-view
Credits :clap:
Some of the development approaches are based on implementations provided by the following projects:
- markmap (key feature of this project)
- markdown-include (basis for extension support)
- mkdocs-mermaid2-plugin (basis for plugin support)
Project details
Release history Release notifications | RSS feed
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
Hashes for mkdocs_markmap-2.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | df6a4369e235ded8aa0b55d3e2a14ed7ef1df4f83d41a0375761690e0a7ce05d |
|
MD5 | 51dbfc629932a1e8159dc7046d332609 |
|
BLAKE2b-256 | b5b8663d870f5df74eb695cf53d19e4fd2ac7627f139809b40991875575970cb |