2023-02-02
Using Markmap Mindmap Diagrams in Pelican Blog
Embedding a markmap mindmap in a Pelican blog post written in Markdown requires a few steps:
-
Install the markmap library by running
npm install -g markmap
in your command line. -
Create a mindmap file in the
.mm
format using a tool such as Markmap or Vim Markmap -
Add the following code to the head of your Pelican HTML template:
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/markmap@2.4.2/dist/markmap.css" integrity="sha256-f1gjK1a7DwY52ePb7Jf0e9cKd26aOiZaN0Z1zKjH1Dc=" crossorigin="anonymous">
<script src="https://cdn.jsdelivr.net/npm/markmap@2.4.2/dist/markmap.min.js" integrity="sha256-1Q2bZgxjPf5bW80MvAq3SP1KjGg8Xl1V7vGjKg5V7e0=" crossorigin="anonymous"></script>
-
In your Markdown file, add a
div
element where you want the mindmap to appear, and give it an id:<div id="mindmap"></div>
-
Add a script to your Markdown file that loads the mindmap file and renders it in the div element:
<script>
const mindmap = markmap.create('#mindmap', {
renderer: 'svg',
openOnClick: true
});
mindmap.load('path/to/your/mindmap.mm');
</script>
-
Make sure that your
mindmap.mm
file is in the same directory as your pelican project and the path to it is correct. -
Build and run your Pelican project to see the mindmap in your blog post.
Note that, you could also use a plugin to add the necessary links and script to your HTML template.
Please keep in mind that, Depending on the theme you are using, you might need to make some adjustments to the HTML and CSS to ensure that the mindmap is properly displayed.