给想学Markdown的你的一个简单的Markdown语法教程

给想学Markdown的你的一个简单的Markdown语法教程

这篇文章是对我所知道的常用、兼容性较好的Markdown语法的一个简单的总结，文中所有的语法在Typora编辑器和简书上都可以正确显示，如有错漏之处，烦请指正。

本文同时也发表在我的个人网站：www.wendev.site，欢迎前往我的个人网站阅读。

什么是Markdown？

我觉得对HTML比较熟悉的同学可能会很容易地回答出这个问题——Markdown其实就是一个轻量级、用来编写文档的更易用的HTML。

当然，对于没有基础的同学，可以暂时这么认为：Markdown是一门标记语言，可以算是简化版的Word，但是你不需要为了设置各种格式而用鼠标点来点去了，一切格式的控制都像HTML一样，用代码就可以完成。

Markdown文件的扩展名是.md，建文件的时候不要建错了。

注意：Markdown的各种符号都是英文符，尤其要注意圆括号也是英文的圆括号。

Markdown编辑器推荐

在开始学习之前，肯定需要一份趁手的工具。

Markdown最好用专门编辑Markdown的编辑器来写。这里推荐几个我比较喜欢的Markdown编辑器，在学习Markdown语法之前可以先了解一下它们：

Typora

说到Markdown编辑器，肯定首推Typora了，用过的人都知道它有多好用，而且还支持写HTML，而且颜值非常高，还支持换主题。我这篇教程就是使用Typora写出来的。

Typora跟绝大多数左边编辑右边预览的Markdown编辑器都不同，是实时全屏预览的——你打完之后，立马就可以看到效果，看起来跟Word一样，却比Word简洁的多。如果不满意，也可以进源代码模式再去改，当然有些格式也是可以直接改的。

Typora还带大纲功能，真的是十分方便，我用过的Markdown编辑器里除了带目录插件的VSCode和语雀之外还没见过有哪个可以实时生成大纲的。

最重要的是：Typora是跨平台的！跨平台！跨平台！跨平台！重要的事情说三遍！带Linux玩的都是好朋友！

Visual Studio Code

没错，大名鼎鼎的VSCode也是可以写Markdown的（好像没有VSCode做不到的事情），而且语法高亮还挺完备的，相关插件也有很多。个人感觉使用体验仅次于Typora。

推荐装一个Markdown Preview Enhanced插件，这样就可以实时预览了，还有个神器Markdown All in One也很好用，但是需要额外记一些快捷键。强烈建议装一个markdownlint做语法规范检查，毕竟Markdown的编码规范还是挺重要的。

使用体验上，除了不是实时全屏预览以外，使用体验跟Typora几乎没什么差别，就是VSCode的使用体验。

最重要的是：VSCode也是跨平台的！跨平台！跨平台！跨平台！重要的事情说三遍！带Linux玩的都是好朋友！

简书

了解我的人应该都知道我在简书上写了多少东西。客观来说，作为在线的编辑器，虽然没有语法高亮，但是简书还是挺不错的，容错能力很强（比如标题的#号后面不打空格、段内换行不打空格这种不规范的写法都能正确识别），实时预览也做得很不错。很多时候有些比较短的文章我不想在本地开Typora写，就直接在简书上写了，还是挺舒服的。

最主要的还是简书自带图床，不用为把图片保存在哪里而发愁。

另外，简书的广告比CSDN少多了，界面也是我喜欢的风格，这也是我推荐它而不是CSDN的原因。

简书也支持富文本。

当然，简书也是跨平台的！毕竟Web应用从来都不会受平台限制，只要有浏览器就能访问。

Md2All

官网：http://md.aclickall.com/

这个东西比较冷门，本来的作用是将Markdown格式转换为富文本，但是单纯用来编辑Markdown也是挺不错的，如果你对CSS比较熟悉的话，你还可以把它生成的富文本变得非常漂亮。

不支持云同步，写完之后记得保存到本地。

最大的缺点就是不带语法高亮了。坦白来说，写Markdown没语法高亮是真的难受。

印象笔记/为知笔记

说到有云同步功能的，除了本来就是Web应用、自带云同步的简书就是这两个了吧。这两个作为笔记类的软件，也是很出名的。

虽然印象笔记是最近才有的Markdown功能，但是语法高亮还是挺不错的，比为知笔记舒服一些，也可以实时预览，我发在简书上那篇Maven学习笔记就是用印象笔记写的。为知笔记不是很推荐，没高亮也没实时预览。

但是印象笔记那个Markdown。。。也是有够难受的，支持很有限，而且……真的太丑了，比不上Typora不说，毕竟人家太无敌了，但是连VSCode甚至Markdown Pad都比不上，就有点说不过去了……

总之这俩不建议用，想要云同步的话直接用简书就行了，还顺便开通了个个人博客。当然你也可以“曲线救国”，用坚果云、iCloud、OneDrive做云同步。比较邪门的玩法还可以在GitHub上建一个仓库存你的笔记（论GitHub的错误正确用法）。

想看正经推荐的到这里就可以往下翻去看教程了，以下几个都是不正经推荐。

Markdown Pad

Windows独享。

我18年入门Markdown的时候使用的第一个编辑器，可以说是麻雀虽小五脏俱全吧，比较简陋，但是功能还是比较完善的。

一个很大的亮点就是自带图床了，对图片很友好，毕竟Markdown最大的短板应该就是图片了。

可以试试，但是不推荐日常使用。

Xcode

macOS独享。

这是你没见过的船新玩法。

一开始我以为这么玩的都是大佬，但是macOS默认打开Markdown文件的方式居然真的是Xcode，真是无力吐槽了。。。

不过客观上来讲，除了没实时预览，Xcode写Markdown感觉还是挺不错的，毕竟语法高亮比较完备，颜值也是真的高。虽然本身是个跟Visual Studio一样的超重量级的IDE，但是平常使用的话还是感觉不大到。

真的会有人日常用这玩意写Markdown吗……

Vim

macOS/Linux独享，Windows有移植版本不过巨难用。

这是你没见过的船新玩法*2。

嗯，不用多说，玩Vim的都是大佬。

反正我玩不动，各种命令和快捷键都快记疯了，也就写代码的时候开个Vim模拟器玩玩了。

但是有一说一，Vim带语法高亮，确实可以写Markdown。

标题

Markdown一共支持六级标题，与HTML的<h1>到<h6>作用相同。

写法：是第几级标题就在前面写几个#，#后面打一个空格，然后再跟上标题内容。

一级标题还有一种比较冷门的写法，就是在标题行的下一行打-，几个都可以。Typora需要进入源代码模式才能打出。因为实在太麻烦了，所以这种写法不建议大家用，用刚才说的#就可以了。

不打空格的话大多数编辑器识别不了，但也有能识别的，比如简书和Markdown Pad，Typora老版本好像也可以。但是出于标准、规范而言，大家还是应该打一个空格。

注意：标题前后都应该有一个空行。

例如：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

注意：有的编辑器只支持四级标题（例如语雀），所以建议大家最好不要使用超过四级标题。

注意2：严格意义上，一篇Markdown只可以有一个一级标题，但是看了许多人的Markdown，遵守这个规定的人实在是不多啊～~~（反正我也不遵守）~~

正文

Markdown的正文与HTML的<p>标签类似。但是在Markdown里不用任何标识符，直接写就是一个段落。

<