Markdown转成带目录的Html(i5ting_toc)

Markdown无论在编程还是平时其他工作学习中都扮演着重要的角色,如:开发文档、产品说明,甚至是流程图......

但是有的时候需要我们以网页形式展示给他人阅读,当遇到这种场景时候我们需要从两个方面考虑该问题:1.是不是可以直接找个框架直接在线吧md文档转一下?2.是不是工具直接把md转成html文件,然后发布出去?相比较之下我选择了后者。

废话不多说上干货需要原料:git、node(此处不做赘述,自行百度安装)

需要一个开源库:i5ting_toc(github.com/i5ting/tocmd

步骤1:找个文件夹:如a文件夹,安装i5ting_toc,

        npm install -g i5ting_toc

      

v2-9b8a8c3405e3666a794d52f5a6debd5e_b.jpg

步骤2:把你的md文件拷至a文件夹下,如:b.md;

v2-0a3d8e69c0dbba5412c45ad9b46d763e_b.jpg

步骤3:cmd命令进入该文件下:

        i5ting_toc -f b.md is for sale! -o
      

npm 从5.2版开始,增加了 npx 命令,当执行上面语句不能用时候,可以使用

         npx i5ting_toc -f b.md is for sale! -o
      

到此已经生成

v2-ac27d967c146a32fa2cd34f134b87b18_b.png

preview文件夹下

v2-1efe6a9dec543a97625b63bd08669eba_b.jpg

-------------------------分割线-:下面是一些小拓展--------------------

1.生成到不同文件夹下面

找到i5ting_toc安装路径,node_modules

v2-eaab4b66f34cf86007d084277e0e70f9_b.jpg

打开

v2-c05cf752b2f0d13169896052c1f005b7_b.jpg

62行改一下你想要的的文件夹名称

v2-b18a1012eb9ead3f19f8f23c4d810d2c_b.jpg

改为

v2-4c3101dcce0c274af092730de2754ced_b.jpg

再打开

v2-a81e9dda4884716cc1ef4c0e3271d65f_b.jpg


v2-bc3fffe75fe115e135dde858fda9c0d3_b.jpg

改为

v2-370fc99660fcd863d6fc89dc40469ffe_b.jpg

cmd执行

        i5ting_toc -f sample.md -o
      

或者

        npx i5ting_toc -f sample.md -o
      

v2-6e46ba1238b972687a759b52cd093f48_b.jpg

v2-ef147a5234d65e9f077e738661541875_b.jpg

v2-594e459b9920b4237bbbb6399e086d12_b.jpg

代码没有高亮怎么办,下一章我会讲讲怎样修改

posted @ 2019-12-02 07:02  Forever.Sun  阅读(38)  评论(0)    收藏  举报