Visual Studio Code 折腾记:Markdown 集成编辑环境

嘛……之前已经写过一篇用 Visual Studio Code 编辑 LaTeX 的文章,这回来把拖了很久的编辑 Markdown 的文章补一补。

Markdown 是个好东西,作为一种轻量级的标记语言,很适合用来写一些简单的文章,并输出成 HTML 或者 PDF 格式。在不少情况下,我们不需要 LaTeX 这样重量级的排版工具,用 Markdown 就能完成很漂亮的文章。

Markdown 语法

我觉着 Markdown 语法没啥写的必要……随便搜一下都能搜到很多的介绍,这里随便列几个写的不错的:

软件安装

VS Code 的安装没啥需要说的,Markdown All in One 这个插件在应用商店中可以直接安装。和这个插件的名字一样,这个插件几乎把编写 Markdown 需要的所用功能都囊括进去了。

一些玩耍技巧

用 VS Code 编辑

嘛……Markdown All in One 这个插件提供了不少快捷键和代码补全的功能,请仔细阅读 README。

这个插件提供了对数学公式的支持,但需要注意,使用行内公式时,$ 与公式内容间不能有空格。

编辑器的右上角有预览按钮,点开之后可以实时显示渲染结果。

生成 PDF 文件

以纸质印刷品为目标的文档,最后都得转化为 PDF 格式。从 Markdown 文件生成 PDF 文件一般都要先生成 HTML 文件,再通过浏览器打印成 PDF 文件。下面是具体步骤

  1. 打开命令面板(Ctrl + Shift + P查看/命令面板),输入 HTML 找到 Markdown All in One: Print current document to HTML 一项,回车执行。
  2. 在 Markdown 文件所在文件夹下会生成对应的 HTML 文件,用 Chrome 浏览器打开它,打开打印窗口(Ctrl + P),选择目标打印机为 另存为 PDF,点击保存。

一般来说,插件给出的 CSS 样式已经足够好了,直接另存为 PDF 就可以。当然,你也可以根据自己的需要调整 CSS 样式。

似乎 Chrome 在导出 PDF 的功能上比 Firefox 要好用一点,唯一不方便的是页脚不能自定义。

如果需要在文件的某个位置分页,可以在 Markdown 文件的对应位置添加下面的 HTML 代码:

<div style="page-break-after: always;"></div>

其他的玩耍技巧还请大家边玩耍边摸索。(总算水了一篇博客,逃)

本作品采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。
本文链接:https://blog.ceba.tech/2020/01/Visual-Studio-Code-Markdown/