因为需求升级了,原本的markdown笔记基本满足要求。但最近为小孩做一份汇总的数学公式思维导图,发现数学公式无法全部完整显示输出。以下是分享经过实战的一个操作方法。
一、用 Node.js + markmap 实现思维导图 + 数学公式 + 导出 SVG/PDF
1. 安装 Ubuntu 22.04 官方正确完整的 Node.js
sudo apt update
sudo apt install nodejs npm -y
2. 升级 node 到最新稳定版(关键!)
sudo npm install -g n
sudo n stable
如果没有执行这一步升级的话,可能转换思维导图时会遇到以下错误 ;
internalBinding('errors').triggerUncaughtException( ^
Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'fs' imported from /usr/local/lib/node_modules/markmap-cli/dist/cli.js
所以记得执行升级版本,保证版本够新。
3. 重启终端(必须)
关闭终端,重新打开一个。
4. 验证版本
node -v
npm -v
必须出现:
- node ≥ v20.x
- npm ≥ v10.x
5. 重新安装 markmap-cli
sudo npm install -g markmap-cli
6. 测试运行(成功!)
markmap --version
二、现在可以正常生成思维导图了
新建 test.md(保存文件为markdown格式)
# 数学公式思维导图
## 方程
- 一元二次方程 $ax^2+bx+c=0 (a\neq0)$
- 求根公式 $x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$
## 不等式
- $a\neq b$
- $a\leq b$
- $a\geq b$
注:执行命令导出 SVG(此处遇到问题了,系统无法正常识别导出的图,可能是软件版本有关,有待解决)

markmap test.md -o 数学公式.svg
导出 HTML(可查看、可缩放、公式完美渲染)
直接执行时会以html方式打开一个页面,效果杠杠的。
markmap test.md
nodejs为什么要升级新版本?
markmap 官方只支持新版 Node.js,我之前的 Node 环境损坏、版本过旧、不支持 ESM,而错误提示中fs 是 Node 内置模块,找不到 = Node 坏了。
三、结合vs code编辑markdown更直观看到效果
1、安装code(一条命令)
sudo apt update
sudo apt install code -y
二、打开 VS Code,安装思维导图插件
- 打开软件
- 左边点 扩展(方块图标)
- 搜索
mindmap - 安装 第一个:Mindmap (下载量最高,最稳定)
vs code看到的效果

总结:
- 经过使用发现目前导出svg图片时无法正常显示,应该是导出时就有异常了
- 导出Html格式的的思维导图效果非常好,放大缩小完美
- 熟练的可以直接命令行执行转换,使用code一边看一边编辑更方便