Typora不支持最新Mermaid语法的解决办法
Typora是一款Markdown编辑器,可以用来写文章,同时还集成了Mermaid库,可以很方便地画一些基础的图表,例如流程图、甘特图、饼图等。但是由于Typora和Mermaid是不同的项目,独立维护,因此Typora中集成的Mermaid可能不是最新的版本,同时也不支持最新的图表和特性。因此,我们就需要通过一些修改来让Typora支持最新版本的Mermaid。
问题场景示例
假设我们使用的是 0.9.89
版本的Typora,我们在编辑器内通过以下Markdown代码创建一个ER图:
其中,第1行中 mermaid
表示该代码块是一个Mermaid图表,第2行中 erDiagram
表示该图表是一个ER图(这是截至文章编辑时,Mermaid最新版本 8.5.1
中所支持的一种图表),第3到5行定义了该ER图的具体内容。
但是,插入以上Markdown代码后,Typora中却无法正确地展示该ER图,并且还会报以下错误信息(在 0.9.86
及以前版本的Typora中,只展示空白图表,没有错误信息):
上面的报错是因为Mermaid语法解析失败,这就是由于其中集成的Mermaid版本太低导致的,我们可以在编辑器内通过以下代码来查看Typora所集成的Mermaid版本:
插入以上Markdown代码后,编辑器展示如下:
可见,我们当前用的Typora集成的是 8.4.0
版本的Mermaid,而这一版本还未支持ER图。那么,接下来我们就通过一个简单的修改,来让Typora集成最新版本的Mermaid。
处理办法(Windows)
下载Mermaid最新版本的js文件
由于Typora本质是一个js实现的Markdown编辑器,Mermaid也是一个js实现的图表库,Typora通过js引用的方式集成了Mermaid。因此,为了集成最新版本的Mermaid,我们首先需要下载Mermaid最新版本的js文件:
- 在Mermaid官方文档中找到CDN地址
- 下载最新版本的
mermaid.min.js
文件到本地(例如8.5.1
版本地址:https://unpkg.com/mermaid@8.5.1/dist/mermaid.min.js)
除了官方提供的CDN下载方式,通过其他渠道下载也可以。
打开Typora的window.html文件
假设我们Typora的安装目录在 D:/Typora
,那么在其中的 resources/app
目录下可以找到一个 window.html
文件,打开这个文件。
引用Mermaid的js文件
在 window.html
文件中的 </body>
前插入以下代码并保存:
上面代码会在Typora窗口打开后定时检查自带的Mermaid是否已集成,如果已集成,那么就通过jQuery从本地加载我们前面下载的js文件。第7行需要将<>及其中的内容替换成实际的js文件存储位置,例如我之前把js文件下载到了 D:/Typora/mermaid.min.js
位置,那么替换以后的代码就如下:
重新打开Typora
修改并保存 window.html
文件后,我们重新打开Typora,就发现问题场景示例中的ER图已经可以成功展示了:
查看Mermaid的版本,也可以看到已经成功替换成了最新版:
处理办法(macOS)
下载Mermaid最新版本js文件
同处理办法(Windows)/下载Mermaid最新版本的js文件。
替换Mermaid原先引用的js文件
首先进入到Typora的应用程序包内(在应用图标上点右键,然后选择“显示包内容”):
然后依次进入 Contents
、Resources
、TypeMark
、lib
、diagram
目录中,可以发现该目录中有一个名为 diagram.min.js
的文件。
我们用之前下载好的新版本js文件替换 diagram.min.js
文件,注意替换后的文件名必须还是 diagram.min.js
。
重新打开Typora
完成替换以后,我们只需要重新打开Typora,就可以发现问题场景示例中的ER图已经可以成功展示了:
查看Mermaid的版本,也可以看到已经成功替换成了最新版: