Markdown与 $\LaTeX$ 公式的使用入门指南

一、Markdown是什么？

Markdown是一种轻量级标记语言，创始人为约翰·格鲁伯（英语：John Gruber）。 它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

由于Markdown的轻量化、易读易写特性，并且对于图片，图表、数学式都有支持，目前许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。 如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等，甚至还能被使用来撰写电子书¹。

相对其它文字编辑工具而言，Markdown相对html、$\text{LATEX}$ 都要简单很多，但又尽可能地保留了类似专业标记语言的一些特性。由于其简便、美观且功能强大，目前已被广泛用于笔记甚至于一些网络页面的制作。

二、Markdown编辑工具

• 桌面工具：Typora

官网：https://www.typora.io/

安装：目前提供了Windows 32位、64位和MAC OS系统的安装文件，直接下载安装即可。

常用配置：

1、自定义图片保存位置

在菜单栏中依次进入文件-->偏好设置-->图象 中提供了插入图片时的几种操作，一般来说建议选择直接保存到指定路径：

这个指定路径最好弄一个专门的地方存放，方便自己管理。

当然也可以选择上传图片，不过这个需要云服务或者是购买云空间。通常如果只是自己用的话也可以选择直接放到GITHUB上，相关操作方法可以参考博客：https://blog.csdn.net/xiaozecheng/article/details/105197126

2、开启内联公式

同样是在偏好设置中，选择Markdown选项，再勾上：

这个操作主要是让 $ 符号之间的latex代码可以直接被渲染为公式，比较方便。

3、安装Pandoc

在Typora里面这个操作非常简单，直接点击文件-->导出，再任选一种文件格式就会自动提示安装Pandoc，而这时只需要点击同意，等待安装即可。装好Pandoc之后就可以轻松地将自己的文档转换成许多其它格式了。

另外，Typora里提供的格式转换功能只取了很少一部分非常常用的Pandoc功能，如果觉得不够用的话还可以直接去安装Pandoc用指令来操作，也非常简单。

Pandoc地址：https://pandoc.org/

• 在线工具：MDNice

该工具直接在线使用：https://www.mdnice.com/

除了可以实时渲染markdown的内容之外，还提供了一些十分方便的功能：

• 支持常用快捷键：比如加粗、斜体等

• 自动整理代码

• 可直接导入导出Markdown文件

• 可直接导出知乎、微信公众号等平台支持的格式

当然，相关的工具还有很多，但初学时不建议在工具上耗费太多时间 。

三、Markdown基本语法简介

类似的介绍随便度娘都能找到，所以不多细说，这里只提几个比较重要的点：

1、文档结构相关

标题：用#号

字体：加粗、斜体、高亮（==这是一段高亮== 这是一段高亮)

列表：无序用“-”， 有序用“数字.空格”

2、表格

语法：

| a    | b    | c    |
| ---- | ---- | ---- |
|      |      |      |

结果：

a	b	c

3、图片

图片一般直接粘贴、拖拽即可。但特别要注意的是图片存放的位置，一般来说可以有2种：

• 直接存在本地
• 直接使用外链图片地址（不过有时可能被会屏蔽，或者可能面临过期的情况）

4、插入代码

大段代码：

​```python
# 这是一段python代码
​```
效果：

# 这是一段python代码

5、添加脚注

添加脚注标记：[^脚注名称]

添加脚注内容：[^脚注名称]:(脚注内容)

示例：

这段文字有一个脚注²。

这样就可以实现脚注内容的跳转。

6、文档目录

markdown生成目录非常简单，直接在任意一行顶格敲入代码[TOC] 即可（“目录”的英文是：Table of Content)，比如本文的目录：

目录的生成是根据文本的标题级别来区分的，并且自带页内跳转，使用体验非常好。

7、与html的兼容

markdown本身是对html兼容的，也就是说可以使用html的代码来改变markdown的样式。比如：

• 修改文字颜色

代码：<a style='color:red'> 这是一段红色文字 </a>

效果： 这是一段红色文字

图片的位置、大小也可以用html代码来调整。

<div align=left>
   <img src= "图片地址" style="zoom:50%;" width=240/>
</div>

效果：

还有就是目录的样式其实也可以使用hmtl代码的css样式表来调整（这个说法不太专业）。不过对于没有基础的同学而言无非又太鸡肋，所以没有特别需求的时候也不用考虑。

8、其它

其实绝大多数markdown的语法和操作在Typora和mdnice工具中都有对应的图形操作方式，有这俩工具的加持，入门markdown实际上基本无门槛。遇到特别的问题再去查询即可。

除上述语法之外，markdown还提供了很多高级用法，比如在文字中插入音频、视频，像$\text{LATEX}$ 添加参考文献（可自动跳转等），添加流程图(mermaid)功能。不过这些内容也都只有在一些比较特殊的场景才会用到，所以本文不再赘述。有兴趣的同学可以自行度娘。

四、在Ｍarkdown中使用数学公式

1、基本用法

在Markdown里使用 $\text{LATEX}$ 公式和在$\text{LATEX}$中使用的方法几乎一模一样，都是用 $ 符号来标记公式区域。

• 内联公式

即是在文字内容中含有公式，这种公式就在公式代码左右两端加上　两个$$符号。例如：

我们初中的时候学过一元二次方程　$ax^2+bx+c=0$ 的万能公式为$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a},\quad(\Delta\ge0)$。

我们初中的时候学过一元二次方程　$a{x}^2+bx+c=0$ 的万能公式为$x=\frac{-b\pm \sqrt{b^2-4ac}}{2a},(\Delta \ge 0)$。

• 独立公式

单独起一行的公式，语法为在公式上、下两行加上两个$符号。例如：

$$
\int u \frac{\mathrm{d}v}{\mathrm{d}x}\,\mathrm{d}x=uv-\int \frac{\mathrm{d}u}{\mathrm{d}x}v\,\mathrm{d}x
$$ 

$$\int u\frac{\mathrm{d}v}{\mathrm{d}x}\mathrm{d}x=uv-\int \frac{\mathrm{d}u}{\mathrm{d}x}v\mathrm{d}x$$

关于$\text{LATEX}$公式的语法直接参考妈叔文档：https://latexlive.com/help

2、高级用法

公式编号及引用。公式的引用和$\text{LATEX}$ 的引用方式是一样的。不同的是markdown里必须要加上$ 符号才能表明这是一个$\text{LATEX}$ 命令。

• 编号相对简单，直接在公式区域中添加\tag{1}即可，比如：

$$
y=kx+b
\tag{1}
$$

$$y=kx+b\text{\hspace{1em}(1)}$$

• 公式引用则相对麻烦。简单地说，这里\tag{1}只表示给它打了一个显示标签，而并不代表它是一个可以被引用的位置。而真正能标记它的位置的是\label。这里头的原理太多，多说也无益，直接上一个例子就能明白。

$$
y=kx+b
\tag{2}
\label{eq:linear}
$$

$$y=kx+b\text{\hspace{1em}(2)}$$

标记好这个公式之后，再用\eqref命令就可以引用这个公式了。\eqref{eq:linear}，引用效果： (2)。（如果在Typora中使用，这个（2)是高亮的，点击直接跳转到公式（2）的位置。

这个功能在自己做笔记时非常有用。不过不同的markdown版本不一定支持。比如像某道云笔记就基本上不支持LATEX公式。而目前绝大多数博客平台基本都不支持这种文内公式引用，很讨厌。

3、全世界最好用的在线免费 $\text{LATEX}$ 辅助工具

妈叔开发的在线免费$\text{LATEX}$ 工具：https://latexlive.com/

该工具是目前全世界最好用最良心的在线 $\text{LATEX}$ 工具，没有之一。 它的主要功能有这些：

• 在线编辑$\text{LATEX}$
• 下载svg, png, pdf图片
• 直接转mathML编码
• 提供在线敲好的公式的在线链接
• 提供免费的mathpix接口，实现公式图片转latex源码的功能

最后这个功能是最良心的功能没有之一。Mathpix对个人账户每月只提供50次的免费识别服务，年卡大概也要300多RMB。但妈叔的这个工具直接帮大家承担了所有的费用。当然他也要挂些广告在网站上，别的不说，至少在目前为止是一点也没有影响使用。完全免费能良心到这种程度是真的情怀！

另外，妈叔也提供了这个工具的完整介绍，有兴趣可以去B站搜：如何优雅的编辑数学公式？LaTeX公式入门

综合上述的简单介绍，配上这个辅助工具，即便从未用过 $\text{LATEX}$ 的人应该也可以秒上手。当然如果想要长期使用 $\text{LATEX}$ 还是建议去专门学习一下。

五、Markdown与其它类型文件的转换

Markdown可以轻松地转换为许多文档类型。目前支持最好的就是html，而效果最差的莫过于epub和 word。

转换方式非常简单，通常我们直接使用pandoc即可。而在Typora中只需要点击导出，就会自动提示是否安装pandoc，安装好之后直接点击转换即可，非常方便。

另外值得一提的是，许多其它类型的文件转为markdown非常轻松，带来许多便利。比如jupyter notebook 的ipnb文件就可以直接转为markdown文件，这就对我们做笔记、写技术文档提供了极大的便利。而这个功能则直接使用nbconverter工具即可。

写在最后

学习工具最快的办法就是边用边学，用得越多，就学得越快、学得越好！

---

1. (以上内容来自百度百科) ↩︎

2. (这是“这段文字有一个脚注”的脚注内容) ↩︎