Markdown实用技巧（持续更新）

Markdown Application Skills

---

1. 检索

1.1 Headings检索

通过VSCode的检索功能，可以对任意Markdown文章中的标题进行检索。具体操作方式如下：

在VSCode中呼叫控制台，快捷键为 cmd(Ctrl)+p，然后输入要检索的标题名称。如果知道标题等级，还可以输入相应舒数量的 # 字符。

2. 常用文本功能

• 快捷键

  • 加粗：Ctrl+B
  • 斜体：Ctrl+I
  • 开启LaTex数学公式编写：Ctrl+M

• 高亮：==文字==（效果：文字）

• 删除线：~~文字~~（效果：文字）

• 勾选/取消勾选任务清单项目：- [ ] Task A

  • Task A
  • Task B

• emoji：例如:camel: : blush: :smile: ;
  🐫 😊 😄

3. 字体、颜色设置

通过 Markdown Preview Enhanced 插件，可以实现对最终PDF字体的设定。设置界面启动方式为：

打开命令界面 Ctrl+P，输入 Customize CSS， 打开 style.less文件。

然后，在 style.less 文件中增加相应代码。在MPE的帮助文档里找到了示例：

.markdown-preview.markdown-preview {
  // please write your custom style here
  // eg:
  //  color: blue;          // change font color
  //  font-size: 14px;      // change font size
  // custom pdf output style
  @media print {
  }

  // custom prince pdf export style
  &.prince {
  }

  // custom presentation style
  .reveal .slides {
    // modify all slides
  }

  .slides > section:nth-child(1) {
    // this will modify `the first slide`
  }
}

.md-sidebar-toc.md-sidebar-toc {
  // sidebar TOC style
}

为了更好的对 style.less 文件进行修改，这里记录一下各种不同的标签：

• 普通文本段落（Paragraph）：p
• 加粗：strong
• 加斜（emphasize）：em
• 各级标题（headings）：h1 ~ h6
• 分割线（horizontal rule）：hr
• 引用：blockquote
• 无序列表（unordered list）：ul（列表框架）+ li（嵌套在内的列表项）
• 有序列表（ordered list）：ol（列表框架）+ li（嵌套在内的列表项）
• 代码块：行内采用code，行间采用pre
• 链接（锚点anchor）：a
• 图片（image）：img

参考资料：一个关于CSS的零基础教程（菜鸟教程）

3. 目录

在文章中想要插入目录的位置添加[TOC]即可。如果哪一级不想纳入目录，如文章主标题，则可以在改标题后秒增加{ignore=true}。

4. 表格

• 构建表格：

  aa	bb	cc
  1		2
  3		4
  5	6
  	7	8

5. 图片

• 插入图片
  • 默认插入图片操作：![图片名称](图片地址)；
  • 有了MPE插件以后，可以直接通过import命令插入：@import "文件地址"

如果想要居中，清按照以下方式操作

<div align="center">
<img width=300 src="" >
![图片名称](img.png)
</div>

6. 导出

.md文件可以借助Pandoc导出为LaTex或docx文件。

首先是Pandoc的安装，在Pandoc的官网提供了2种安装方式：

1. 通过Github获得安装包，但由于Github被墙，必须有好用的梯子才能下载。

2. 通过chocolatey下载。首先，登录chocolatey安装页面，在PowerShell下根据网页指引安装 choco。安装完毕后，再输入choco install pandoc命令安装Pandoc。

有了Pandoc以后，文件类型转换地具体操作方式为：

1. 在.md文件当前目录下，按 shift+鼠标右键，选择 在此处打开PowerShell窗口；

2. 制作一个.docx格式的模板文件，定义好各级标题以及正文的格式等；

3. 在窗口中输入命令pandoc 文件名.md -o 文件名.docx --reference-doc=模板文件名.docx。

注意：这里的模板必须为.docx格式，如果是.doc格式会报错。

Pandoc的手册：终端下输入man pandoc

这里再给出一个一键导出指令：

pandoc --filter pandoc-fignos --filter pandoc-tablenos --citeproc --bibliography=test.bib --metadata link-citations=true --metadata reference-section-title="参考文献" --csl=chinese-gb7714-2005-numeric.csl --reference-doc demo.docx test.md -o test.docx

用pandoc转换以后的文档里，引号默认是按照英文字体来写的，会篇小。因此要在Word中将包含引号的文本内容选中，右键选择字体，将所选文字标记为「中文」，最后点击「确定」即可。

为了图片和表格能够正确引用，还要在文件开头加上以下内容：

---
fignos-cleveref: True
fignos-plus-name: 图
fignos-caption-name: 图
fignos-number-by-section: True
tablenos-cleveref: True
tablenos-caption-name: 表
tablenos-number-by-section: True
...

7. 交叉引用

7.1 引用同一文件的某一标题

[title](#title)

注意事项：
a. 使用#选中章节
b. 将大写字母改成小写
c. 去掉特殊符号，如 () 。 . 等
d. 空格用 - 替代

7.2 引用另一个文件

[title](./dir/file.md)

注意事项：
a. 可以用相对文件路径
b. 其他注意事项同上

7.3 引用另一个文件的某一标题

[title](./dir/file.md#title)

注意事项：
a. 可以用相对文件路径
b. 其他注意事项同上

8 公式

Markdown完全支持LaTex的公式语法，这里只想说一些体会。

8.1 关于各种括号

LaTex中写括号一定要用标准的语法形式，如小括号应该是\left(\right)，而不是简单的()。下面用一个例子展示一下两种方式在行间公式中效果上的区别：

• 如果使用\left(\right)，则效果为
  $$\left(\left(\left(\frac{1}{2}\right)\right)\right)$$
• 如果使用()，则效果为
  $$(((\frac{1}{2})))$$

能看得出来，第一种复杂的方式才能得到我们想要的效果。