目录
掌握并熟记一些常用的Markdown的标记语法,简单、有趣、实用
【图1 Markdown编辑器自带的标记语法说明和提示】
【▲ 部分图片截自Ulysses软件和MacDown软件】
通过这些软件里的简要语法说明,大家也能够很快的学会Markdown的标记语法并应用到实际的文字工作中去。
同时网络上也有很多的标记语法语法讲解,有Markdown官方的语法介绍网站(文末附录有链接),也有很多其他人分享的Markdown标记语法教程。
这里我给大家做了一张「简单明了」的标准的Markdown标记语法速查图,一图即可看懂Markdown语法标记:
【图2 标准的Markdown标记语法速查图】
可能图片上传后压缩失真模糊了,可以关注我们的公众号「远怀学堂」,回复209即可下载到此图的高清1080P大图,方便快速查询学习标准的Markdown标记语法
如果你看上面这张图就已经完全懂了,那你可以不需要继续阅读下去了,下文是对这些语法做更加详细的解读,内容较细,建议看下去,你也可以只看你关心的那部分「标记语法」。
我会结合实际的应用场景给大家细讲这些标记语法,本系列教程中会给大家讲到应用非常广泛的两种Markdown标记语法:「标准的Markdown标记语法」和「GFM(GitHub Flavored Markdown)语法」,同时会对实际应用中的重难点标记语法「图片、链接」给大家做更加详细、明了、深入的讲解,让大家完全学透Markdown。
3.1 不同的语法之分
Markdown语言是John Gruber 在 2004 年创造的,由他一开始提出来的Markdown标记语言规则可以看做是「标准的Markdown标记语法」。
标准的Markdown中提供的标记语法相对简单且较少,后来随着时间的推移,使用Markdown的人越来越多,不同的人有不同的使用需求,最初提出来的Markdown标记语法已经满足不了很多人不同的需求了,因此有很多人提出了对最初的Markdown标记语法进行扩展并进行标准化,但是Markdown的创始人Gruber认为不应完全标准化。
“不同的网站(和人们)有不同的需求。没有一种语法可以让所有人满意。” —Gruber
所以后来很多的组织自行的在「标准的Markdown」的标记语法上进行扩展,增加了些新的标记语法,其中最有名的当属GitHub发布的基于CommonMark的GitHub Flavored Markdown(GFM)标记语法。
「标准的Markdown标记语法」和「GFM标记语法」在我们这个系列教程中都会给大家讲到。
3.2 好吧,那我们开始标准的标记语法学习
首先强调一点的是:所有的标记语法都是在英文输入法状态下输入的,这点一定要注意。
Markdown格式的文档的后缀名一般为.md或者.markdown
3.2.1 最常用到的标记
「标题」、「加粗」、「强调」
每当我们去写一篇文章时,经常需要构思出这篇文章的目录层次结构:文章的一级大标题、二级标题、三级标题、四级标题等。
【图 本篇教程的大纲目录层次结构】
【▲ 由本Markdown文档导出成Word后截的大纲图示】
拥有良好的目录层次结构的文章编写和阅读起来都很清晰,在Markdown中可以使用「标题」标语语法来实现这种文章的目录层次结构。
「标题」
【标记语法】
# 文章大标题(一级标题)
## 第1章节 章节名(二级标题)
### 1.1 小节名(三级标题)
## 第2章节 章节名(二级标题)
### 2.1 小节名(三级标题)
#### 2.1.1 小节名(四级标题)
注意标记符号 # 号后面需要有个空格
对应的最终渲染显示效果:
标记语法显示效果是在MacDown软件运行的,下同
一篇文章应该有且只有一个「一级标题」,为该文章的大标题,「一级标题」下面可以有多个「二级标题」,「二级标题」下面可以有多个「三级标题」,「三级标题」下面可以有多个「四级标题」,以此类推下去,在Markdown中最多使用6个#号代表「六级小标题」,这6个层级的目录标记语法也够我们平时做文章用了,一般也用不了那么多层级的。
当我们想要对文章中的某些文字加以强调,可以使用「加粗」和「强调」的标记语法。
「加粗」
【标记语法】
**需要加粗的文字** 或者__需要加粗的文字__
对应的最终渲染显示效果:
「强调」(「斜体」)
【标记语法】
*需要强调显示的问题* 或者 _需要强调显示的问题_
对应的最终渲染显示效果:
3.2.2 最清晰的标记
「有序列表」、「无序列表」、「分隔线」
当我们有一项一项的条目需要列出来表达时,可以试试Markdown中的「列表」标记语法,其中也分为「有序列表」、「无序列表」。
「有序列表」
【标记语法】
1. 有序列表项1
2. 有序列表项2
3. 有序列表项3
以数字开头,后面紧跟一个.号,再加上一个空格(1. )就组成了「有序列表」的标记语法
标记语法的开头的数字并非一定要1 2 3这样次序下去,只要是数字即可,也可以使用下面的表达方式
1. 有序列表项1
1. 有序列表项2
6. 有序列表项3
对应的最终渲染显示效果:
「 无序列表」
【标记语法】
- 无序列表项1
- 无序列表项2
- 无序列表项3
以-开头,加上一个空格构成了「无序列表」的标记语法,其中-也可以使用*或+代替
* 无序列表项1
* 无序列表项2
* 无序列表项3
对应的最终渲染显示效果:
「有序列表」和「无序列表」都能够通过一个一个列表项的效果很清晰、有条理的表达出意思。
这两者最大的区别就是「有序列表」标记语法最终显示时每个列表项前面有个有次序的数字,「无序列表」标记语法最终显示时是以小黑点作为列表项的开头,以表示无序的意思。
「 列表的嵌套」
「有序列表」和「无序列表」也可以实现列表嵌套:
【标记语法】
1. 有序列表项1
- 无序列表1
- 无序列表2
- 无序列表3
2. 有序列表项2
3. 有序列表项3
- 无序列表1
1. 吃饭
2. 睡觉
3. 打豆豆
- 无序列表2
> 我是一个引用
- 无序列表3
我是一个段落
对应的最终渲染显示效果:
使用一个TAB(制表符)或者4个空格来实现在某个列表项下面嵌套其他内容,同时需要在该列表项下加上一个空行(有些软件