Typecho安装支持生成目录、流程图（Mermaid）、数学公式（MathJax）Markdown解析器插件Parsedown

• 需求
• 安装
  • 下载插件到插件目录
  • 解压，修改插件目录名
  • 启用插件
  • 修改文章，查看效果
  • 一些其他设置
• 总结

需求

安装完成Typecho以后，使用Markdown写完博客发现页面不会自动生成文章的目录，google了一会，于是就找到这款Markdown解析器Parsedown。

下面介绍一下该解析器相比于默认解析器额外功能：

• 支持[TOC] 语法，生成文章目录
• 支持 MathJax 数学公式的$和$$语法
• 支持 Mermaid各种图表语法

安装

• 作者GitHub地址： https://github.com/mrgeneralgoo/typecho-markdown
• 作者博客地址： https://www.chengxiaobai.cn/php/markdown-parser-library.html
• 作者给的示例地址： https://www.chengxiaobai.cn/record/markdown-concise-grammar-manual.html

下载插件到插件目录

[root@iZ2zeb2i87ctar29rg4v28Z ~]# curl -SL https://github.com/mrgeneralgoo/typecho-markdown/archive/master.zip -O ~/typecho/php-fpm/typecho/usr/plugins/master.zip
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0     0    0     0    0     0      0      0 --:--:--  0:01:33 --:--:--     0

可以看到，我们已经等待了1分33秒，但是仍然没有下载一点。这是就不要等等待了，直接ctrl + c 取消吧（因为从github.com下载不使用科学上网会非常慢，有时还会失败）。

还是挂上科学上网， 在本地下载下载完成（直接将上面的下载链接复制到浏览器URL栏即可）。

下载完成以后，上传到typecho部署的插件目录：

(base) iMac-2:~ xx$ scp -r ~/Downloads/typecho-markdown-master.zip root@99:~/typecho/php-fpm/typecho/usr/plugins
typecho-markdown-master.zip                                                                                                                 100%   20KB 721.8KB/s   00:00    
(base) zxys-iMac-2:~ zxy$ 

解压，修改插件目录名

[root@iZ2zeb2i87ctar29rg4v28Z plugins]# pwd
/root/typecho/php-fpm/typecho/usr/plugins
[root@iZ2zeb2i87ctar29rg4v28Z plugins]# 
[root@iZ2zeb2i87ctar29rg4v28Z plugins]# unzip typecho-markdown-master.zip 
Archive:  typecho-markdown-master.zip
e5dc8b7c6d7fb544e87da617b99a8febf0993264
   creating: typecho-markdown-master/
  inflating: typecho-markdown-master/CHANGELOG.md  
  inflating: typecho-markdown-master/LICENSE.md  
  inflating: typecho-markdown-master/Parsedown.php  
  inflating: typecho-markdown-master/ParsedownExtension.php  
  inflating: typecho-markdown-master/ParsedownExtra.php  
  inflating: typecho-markdown-master/Plugin.php  
  inflating: typecho-markdown-master/README.md  
[root@iZ2zeb2i87ctar29rg4v28Z plugins]# ll 
总用量 36
drwxr-xr-x 2   82   82  4096 11月 21 16:00 HelloWorld
drwxr-xr-x 2 root root  4096 6月  17 2022 typecho-markdown-master
-rw-r--r-- 1 root root 20861 11月 21 19:44 typecho-markdown-master.zip
[root@iZ2zeb2i87ctar29rg4v28Z plugins]# 
[root@iZ2zeb2i87ctar29rg4v28Z plugins]# mv typecho-markdown-master MarkdownParse
[root@iZ2zeb2i87ctar29rg4v28Z plugins]# 

启用插件

访问Typecho后台地址： https://timewentby.com/admin/plugins.php

找到MardownParsr， 然后点击启用 :

修改文章，查看效果

修改任意Markdown文章，在文章第一行新增： [TOC] 保存， 可以看到会自动生成文章目录。

比如这篇文章： https://timewentby.com/docker/install-docker-and-docker-compose-on-linux.html

文章内容：

[TOC]

## 环境说明

- 阿里云云主机（99元一年，新老客户都可以）：  https://www.aliyun.com/minisite/goods?userCode=ej7w2qnx

- 系统(内核)： 
    - 系统： Alibaba Cloud Linux release 3 (Soaring Falcon) 
    - 内核： 5.10.134-15.al8.x86_64

..... 省略很多文字

文章目录预览：

一些其他设置

• 查看设置

• 设置页面
  • 默认开启[TOC]语法（文章目录）
  • 默认开启MathJax支持
  • 默认关闭Mermaid

总结

这款插件满足了我的需求，生成了文章目录，解决了问题。 另外，还额外支持数学公式和图表功能， 以后可以探索。 哈哈。