最完善的markdown转html/pdf方法、带目录生成

最近小编需要写个SDK接入文档,用word调格式当然不如markdown来的舒服,写起来舒服了,但是.md没办法直接看效果,最终萌生出把markdown转成html形式的想法。

网上markdown转换html的方法有很多,包括在线转换和借助工具,最终小编选择了VisualStudio Code的插件Markdown Preview Enhanced

1.在线转换的网站

2.借助工具

2.1 typora

官网下载。很多人说好用。Q@Q原谅小编没使明白。

2.2 i5ting_toc

解析渲染ok,可自动生成侧边目录,不可以编写过程中实时预览,生成的侧边栏不更改本身.md文件,附带的样式太多。
依赖Node环境,通过npm install i5ting_toc -g安装,等待安装完成。

输入i5ting_toc -h回车查看帮助。
i5ting_toc -h

转换html,输入i5ting_toc -f [需要转换文件名].md默认在同级目录生成preview文件夹,打开preview下的同名.html文件或者直接i5ting_toc -o可预览。
生成preview
浏览器预览

2.3 VisualStudio Code插件

需要先安装。右键.md选择打开方式为VisualStudio Code。下载插件转换。
插件下载

插件1:copy Markdown as HTML

Ctrl+Shift+P(MacOS:cmd+shift+p)呼出命令面板。输入markdown:copy as html选中,复制到剪切板,新建一个.html文件,粘贴修改。转换结果比较理想,渲染需更改

插件2:Markdown+Math

Ctrl+Shift+P(MacOS:cmd+shift+p)呼出命令面板。输入markdown:clip markdown+math to html选中,同样复制到剪切板,需要新建一个.html文件,粘贴修改。转换结果比较理想,渲染需更改

插件3:Markdown Preview Enhanced (推荐)

历经千辛万苦,小编终于找到了懒人的福音,可以一键生成目录、输出html/pdf的强大markdown插件–Markdown Preview Enhanced。详细用法点击查看官网

多种特性:

  • 自动编辑器及预览滑动同步
  • 可导出的格式:漂亮的html、pandoc、电子书、幻灯片、PDF、 PNG、JPEG 。。
  • 支持LaTeX 数学、流程图 / 时序图 以及各种其他种类的图形,嵌入 LaTeX, 渲染 TikZ, Chemfig 等图形
  • 支持自定义预览 CSS
  • 生成目录。(TOC 生成)

这里小编介绍一下目录生成及输出html。
首先安装插件:点击侧边栏最后一个Extensions,在搜索框输入Markdown Preview Enhanced,点击Install等待安装完成。
安装插件

打开需要转换的.md文件,右键选择打开同步预览。
打开同步预览

生成目录:详细讲解 光标放置想要生成目录的输出位置,Ctrl+Shift+P(MacOS:cmd+shift+p)呼出命令面板,输入Markdown Preview Enhanced: Create Toc会生成一段类似
目录临时
然后Ctrl+s保存,就会生成目录。注意:必须要在预览打开的情况下生成操作,保存才能更新。

输出html:在右侧的预览界面,右键点击选择HTML->HTML(offline)。在当前.md文件的同级目录会生成一个同名.html文件,解析渲染都理想~
输出html

------------------本文结束------------------
生成的html是你想要的样式吗?或者你有更好的方法欢迎联系我

我的博客

更多好文欢迎关注我的公众号:
我的公众号

发布了25 篇原创文章 · 获赞 41 · 访问量 8866
展开阅读全文

没有更多推荐了,返回首页

©️2019 CSDN 皮肤主题: 编程工作室 设计师: CSDN官方博客

分享到微信朋友圈

×

扫一扫,手机浏览