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

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

网上markdown转换html的方法有很多，包括在线转换和借助工具，下面把方法汇总分享一下。

• 目录
  • 1.在线转换的网站
    
  • 2.借助工具
    
    • 2.1 typora
      
    • 2.2 i5ting_toc
      
    • 2.3 VisualStudio Code插件
      
      • 插件1：copy Markdown as HTML
        
      • 插件2：Markdown+Math
        
      • 插件3：Markdown Preview Enhanced （推荐）
        

1.在线转换的网站

• http://www.bejson.com/convert/html2markdown/ ：不支持表格，不推荐
• http://www.atool9.com/html2markdown.php ：不支持表格，不推荐
• https://www.zai17.com/md2html/ ：```{代码}```包含的代码处理不太理想，不推荐
• https://github.com/markedjs/marked ：转换结果比较理想，渲染需更改。可以用Demo Page查看效果。渲染可以使用github-markdown-css，github风格。
• …（在线的还有很多，反正没有找到理想的）

2.借助工具

2.1 typora

官网下载，试用1个月；充值购买89元三终端。

旧版本0.9.xx 不联网升级可以一直用。很多人说好用。

可以直接导出html（还有其他多种格式），就是不带导航， 不支持表格，小的网页够用；

本地图片注意路径，发布替换为相对地址、网络地址或者图床地址。 

2.2 i5ting_toc

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

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

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

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文件，解析渲染都理想~