ubuntu系统中用 Node.js + markmap 实现思维导图带数学公式

因为需求升级了,原本的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,安装思维导图插件

  1. 打开软件
  2. 左边点 扩展(方块图标)
  3. 搜索 mindmap
  4. 安装 第一个:Mindmap (下载量最高,最稳定)

vs code看到的效果

Mindmap效果图

总结:

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

将本页面加入收藏夹

      如果觉得本文对您有用。建议按下 Ctrl+D (Windows) 或 Cmd+D (Mac) 收藏本页,以便在下次需要时快速查阅解决方案。

发表评论

粤ICP备10052831号 | © 2026 58Linux 技术笔记. All Rights Reserved. | 联系我们 | 关于本站
本站内容开放共享,仅供学习交流 | 专注 Ubuntu & Linux 实战教程
Built with GeneratePress