学习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,一试,发现这种方式很靠谱,