学习md语言，快速生成md文档的目录及生成doc文档，及期间遇到一些问题

正文

如何生成目录

网上一堆教程说如何生成快速生成目录，但是其实都没有讲明白，今天在用vscode看代码的时候灵机一动，在vscode中的插件商城里搜索了关键字*TOC*，果然被我发现了，确实有相关的插件，按照插件页面的操作说明：

首先先在插件商店里搜索到插件，然后安装
安装完以后，在md文件里，要生成目录的地方，右键，出现了markdown TOC insert一些，看需求选择，然后就完成了目录生成

遇见的问题——auto字样乱码

更新VSCode之后打开已经生成目录的Markdown文件，TOC标签格式异常出现auto的文字字样
点击界面左下方的设置按钮，然后选择设置进入到用户设置界面
打开用户设置之后在搜索设置里面搜索Eol
找到文件的Eol可以看到默认行尾字符设置为auto 点击选项框然后将auto更改为\n换行符即可。
回到Markdown编辑界面然后重新生成Markdown目录就能显示正常了。

如何将md文档转为pdf

利用pandoc

这里就是主要记录一下最近在探索把markdown转为PDF时候的一些历程，以及最终找到的一种比较优雅的方式。

pandoc是一个软件，是一个能把千奇百怪的文档格式互相转换的神器，是一把文档转换的瑞士军刀（swiss-army knife）

下载pandoc

官网下载链接
根据自己的操作系统位数下载合适的msi安装包,我下载的是：pandoc-2.7-windows-x86_64.msi

安装pandoc

下载pandoc安装包之后，像安装普通软件一样点开安装就可以了。安装完成之后，打开cmd命令行，输入pandoc -v，如果正常显示出类似下面的信息就表明安装成功：

C:\Users\Administrator.PC-20170728DWIF>pandoc -v
pandoc 2.2
Compiled with pandoc-types 1.17.4.2, texmath 0.10.1.2, skylighting 0.7.0.2
Default user data directory: C:\Users\Administrator.PC-20170728DWIF\AppData\Roaming\pandoc
Copyright (C) 2006-2018 John MacFarlane
Web:  http://pandoc.org
This is free software; see the source for copying conditions.
There is no warranty, not even for merchantability or fitness
for a particular purpose.

使用pandoc

在vscode的插件商店中，搜索pandoc，安装vscdoe-pandoc，然后在插件介绍页面下，阅读使用发法
然后点击所需要转换的md文件，press F1 on Windows (shift+cmd+P on Mac), type pandoc, press Enter Or - press the key chord ctrl+K then P (cmd+K then P on Mac)，
转换目标，先从md文件生成docx文档，再通过生成的docx文档，生成pdf文档，因为从md直接到odf需要安装一个文档渲染工具，里面有跟多坑，所以采用：md->docx->PDF，一试，发现这种方式很靠谱，

快速生成md文档目录及生成doc文档

目录

正文