【原】Markdown 使用手册

Stone_sy 2020-03-22

展开全文

1. Markdown 是什么？

1.1 认识Markdown

Markdown是一种轻量级的 [ 标记语言 ] ，Markdown 是一个 Web 上使用的文本到HTML的转换工具，可以通过简单、易读易写的文本格式生成结构化的HTML文档。目前面向开源及私有软件项目的托管平台—GitHub、中国专业IT社区—CSDN、优质的创作社区—简书等网站均支持这种格式。

GitHub基于搜狗微信搜索的微信公众号爬虫接口

1.2兼容 HTML

Markdown 语法的目标是：成为一种适用于网络的书写语言。

Markdown 不是想要取代 HTML，甚至也没有要和它相近，它的语法种类很少，只对应 HTML 标记的一小部分。Markdown 的构想不是要使得 HTML 文档更容易书写。Markdown 的理念是，能让文档更容易读、写和随意改。HTML 是一种发布的格式，Markdown 是一种书写的格式。

2. Markdown 适合做什么？

Markdown 文本编辑器，在快速文字排版以及代码编辑方面的效率是显而易见的。使用人群方面，适合那些对码字手速和排版顺畅度有要求的人群，譬如码农、网站小编……

2.1 使用 Markdown 的优点

专注你的文字内容而不是排版样式，安心写作。
轻松的导出 HTML、PDF 和本身的 .md 文件。
纯文本内容，兼容所有的文本编辑器与字处理软件。
可读、直观、学习成本低。

2.2 使用 Markdown 的误区

We believe that writing is about content, about what you want to say – not about fancy formatting.
我们坚信写作写的是内容，所思所想，而不是花样格式。

Typora 也不是没有缺点。相较于老牌的Word ，在功能方面Typora 还稍显稚嫩，一些功能尚且不足。比如对于插入的图片，Typora 不能对其设置样式、裁剪等，而Word 则表示笑而不语。

但换一个角度来说，这也不是 Typora 的问题，因为它和 Word 完全是两个不同定位的文本编辑器，只能说各有侧重。

虽然功能的丰富并没有什么本质的缺点，但终归有些背离初衷，何况在编写的过程中很费神，不如使用专业的工具撰写来的更有效率，所以如果你需实现复杂功能，专业的图形界面工具会更加方便。

3. Markdown 编辑器推荐

3.1 Typora

如果你是一个内心文艺、热爱写文的程序员，那么你可能会想，到底有没有一款既接近程序员码字风格，又可以用于普通文本排版的编辑器呢？答案肯定是有的，它就是 Typora [' tɪ pɔ:ra] 。

Typora删除了预览窗口，以及所有其他不必要的干扰。实时渲染的特点「所见即所得」（What You See Is What You Mean）。Typora 同样支持 Windows、OS X 和 Linux。

官网下载下载合适的版本，并傻瓜式安装即可

3.2 其他平台

3.2.1 macOS 平台

在 macOS 上可以使用 Ulysses[ 尤利西斯 ]，其次还有很多同类选择。

3.2.2 iOS、Android 、Web 平台

iOS、Android端已有相当多的APP支持Markdown 语法编辑，例如 Drafts、Day One、iA Writer 等。
Web 端，简书，CSDN，微信公众号等。

参考：

各个平台的编辑器

推荐几款Mac平台上不错的Markdown软件

4. Markdown 语法

4.1 Typora 的 markdown 语法

看到这里请不要被 [ 标记 ] 、[ 语言 ] 所迷惑，Markdown的语法十分简单。常用的标记符号也不超过十个，这种相对于更为复杂的HTML 标记语言来说，Markdown 可谓是十分轻量的，学习成本也不需要太多，且一旦熟悉这种语法规则，加上高效的快捷键操作，会有一劳永逸的效果。

Markdown由约翰·格鲁伯创建。但是，其语法在不同的解析器或编辑器之间有所不同。

1、标题

ctrl + 数字键
用#空格表示，依次增加#，对应标题1-6号标题
效果：

2、引用

Ctrl + Shift + Q
> + 空格 + 内容
效果：

此处是引用
无限次嵌套引用

3、有序列表

Ctrl + Shift + [
1. + 空格 + 内容
效果：

4、无序列表

Ctrl + Shift + ]
-或+或* + 空格 + 内容
效果：

5、任务清单

支持GFM任务列表。能够在markdown文件中管理简单的待办事项。

- + 空格 + [ 空格 ] + 空格 + 内容
效果：

6、代码块

Typora支持 java，python 等多种编程语言，并且在代码区域进行语法高亮，用Typora记编程笔记，看得一清二楚！

Ctrl + Shift + K
``` + 语言名 + 回车
效果：

7、公式块

7.1 Typora 原生支持 Tex / LaTeX 美[ˈleɪteks] 语法，可用来渲染普通数学、化学方程式。渲染过程由MathJax处理。

LaTeX 是一种基于 TeX 的排版系统，由于它易于快速生成复杂表格和数学公式，非常适用于生成高印刷质量的科技和数学类文档。如果你常阅读数学、计算机等领域的学术论文，一定对 LaTeX 不陌生。

7.2 Typora 可绘制流程图、时序图(顺序图)、甘特图

Ctrl + Shift + M
$$ + 回车，可输入各种公式
$x^2+\cos(\theta)$
效果：
内联公式：

8、生成表格

Ctrl + T
在一般的 Markdown 编辑器中，你可以通过以下的格式插入表格：

| 第一个标题 | 第二个标题 | 第三个标题|

| -----------------| -----------------| ---------------|

| 单元格 | 单元格 | 单元格 |

上面的麻烦，但好在 Typora 为我们提供了图形界面的插入表格的功能，你只需要在行内鼠标右键 - 插入 - 表格 ，并输入行数和列数，Typora 就会自动生成一张样式不错的空表格。
调整Markdown文件中表格大小的最快步骤：只需拖动鼠标即可。
效果：

9、字体加粗

Ctrl + B
**两边各两个星号**
__两边各两个下划线__
效果：字体加粗
字体加粗

10、字体倾斜

Ctrl + I
*内容*
_内容_
效果：字体倾斜
字体倾斜

粗斜体文本
粗斜体文本

11、下划线

Ctrl + U
<u>内容</u>
效果：下划线

12、删除线

Alt + Shift + 5
~~内容~~
效果：删除线

13、分割线

可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。

-------------------
效果：

14、插入链接

Ctrl + K
[显示的文字](链接 "链接标题")
允许您插入URL作为链接 <显示的网址>

效果：

链接
链接
www.google.com

15、插入图片

Ctrl + Shift + I
![显示的文字](路径 "图片标题")

本地直接拖拉图片到编辑页面。
如果使用markdown构建网站，配合 MPic，上传图床并复制链接到编辑页面。（推荐）

16、视频

可以使用HTML标签嵌入视频。

<video src="xxx.mp4">

17、插入脚注

第一行：内容+[^1]+回车

第二行：[^1]: + 脚注内容

(注意：在英文半角的输入法下输入符号，输入脚注内容后，可移动鼠标到第一行脚注上可看到脚注内容)

效果：今天还好吗？¹²

[1] 好着来，😄

[2] 那么你如何？

17、插入目录(TOC)

[toc] + 回车

18、下标、上标、高亮

H~2~O
X^2^2
==高亮==

效果：

H₂O
X²
高亮

19、反斜杠

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号。

20、表情符号😄

英文状态下的引号，输入字母自动显示表情符号

win10快捷键：win + .
微软输入法快捷键：Ctrl + Shift + B

以上语法不用刻意记，在Typora中的右键菜单都有，常用功能基本上都有快捷键。

4.2 Typora特色

4.2.1 文件

快速打开：Ctrl + P
自动保存(注：需在文件->偏好设置->通用打开该功能)
md 文件导出

Typora 支持十余种文本格式的导出，默认的有 PDF、HTML，此外它还支持主流的 Word文档，小众一些有 Epub、RTF 格式…等等，同时它还支持把文本导出为图片，方便快捷。你可以根据软件内提示安装 Pandoc 插件来导出更多例如 docx，LaTeX 等格式。
对于Typora，Pandoc的安装是可选的，如果您不需要Typora中的高级导入/导出支持，则不必在计算机上安装Pandoc安装和使用Pandoc

4.2.2 主题

为了让文档更美观，我们可以为其加上 CSS style。我认为 Typora 对 CSS 的支持让它成为一众桌面笔记应用中最与众不同的一个。在 Typora 中 CSS 被称为「主题」，但其本质仍是 CSS 文件。你可以在 文件 - 偏好设置 - 主题 - 打开主题文件夹 看到这些 CSS 文件。

选择不同的主题可以使文档拥有不同的外观，但不会影响内容。Typora 自带了若干主题，你也可以在官方主题下载更多的主题。