Markdown 语法完全指南
Markdown 语法完全指南
什么是 Markdown?
Markdown 是一种标记语言,使用简单的符号来标记文本,就像你拿不同类型的笔在纸上,给文字做不同形式的标注一样。
不仅能通过标记来改变文本的样式,还能改变文章的结构和排版方式,让文章更加美观、更具阅读性。
更多介绍
他的排版语法非常简洁,可以让人们更多地关注内容本身而非排版。
Markdown 使用易读易写的纯文本格式编写文档,可与部分HTML标签混合编写,而且可以导出成 HTML、PDF 、Word 以及其他常用格式的文件。
因为简洁、高效、易读、易写的特点,Markdown被大量使用,如Github、Wikipedia 等网站。当然他也不仅限在网站上使用,像VSCode、Typora 等软件也同样支持使用 Markdown 来编写你的文档。
引言
可千万别被 「标记」或「语言」 吓到,其实 Markdown 的语法十分简单,他不像是专业语言有复杂的语法规则。你只需要记住一些常用的方法,把他当成一支功能很多的画笔来使用就行了。
如果这是你第一次接触 Markdown,别担心,这只会花费你大约30分钟,我会带着你,跟着我一步步的学习 Markdown 的基本语法。
在学习的过程中,我会补充一些比较高级的使用方法,这可能会多花费一些时间,但你完全不必担心,因为 Markdown 的语法并不复杂。当然你也可以选择跳过,在你后续有空余时间的时候再回来看看。
当然如果你以前接触过 Markdown,你也可以利用本篇文章来回顾或查找他的语法。
我希望我能用通俗易懂,但是又不失深度的讲解方式,帮助你快速上手 Markdown。如果我有遗漏或错误的地方,还请在评论区指出,我会及时更新。
OK,废话太多了,Let's Go !
基本语法
1. 标题
如果要创建一个标题,那么我们需要在标题文字前面加上 #
(井号)。
#
的数量代表着标题的级别,#
的数量越少,表示该标题的级别也越高,对应显示的字体也会越大。
注意
#
后面必须有一个空格,否则 Markdown 不会识别为标题。
假如说,我们要创建一个三级标题, 那么,我们的写法应该是:
### 这是一个三级标题
标签分为1~6级别,写法如下:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
对应的效果如下:
Markdown语法 | HTML | 效果预览 |
---|---|---|
# 一级标题 | <h1>一级标题</h1> | 一级标题 |
## 二级标题 | <h2>二级标题</h2> | 二级标题 |
### 三级标题 | <h3>三级标题</h3> | 三级标题 |
#### 四级标题 | <h4>四级标题</h4> | 四级标题 |
##### 五级标题 | <h5>五级标题</h5> | 五级标题 |
###### 六级标题 | <h6>六级标题</h6> | 六级标题 |
警告
这里有一些错误示例
错误写法 | HTML | 效果 | 错误原因 |
---|---|---|---|
##这是一个二级标题吗 | <p>这是一个二级标题吗</p> | 这是一个二级标题吗 | # 后面没有加一个空格,不会识别为标题 |
####### 有七级标题吗 | <p>有七级标题吗</p> | 有七级标题吗 | 没有七级标题,超出1~6级别的标题都是不合法的,不会被正常渲染 |
拓展
1. 标题
快捷键(部分编辑器支持):
<Ctrl> + [1-6]
:按下 Ctrl 键和对应数字,光标所在那一行会变为对应级别的标题格式。<Ctrl> + 0
:按下该组合快捷键,光标所在那一行会清除标题格式。
标题的另一种写法是:
使用 ===
(等于号) 和 ---
(减号)来创建标题,效果与 #
和 ##
相同。
如果我们要创建一个二级标题,那么,我们的写法应该是:
二级标题
---
一级标题和二级标题的写法如下:
一级标题
===
二级标题
---
Markdown语法 | HTML | 效果预览 |
---|---|---|
一级标题 === |
| 一级标题 |
二级标题 --- |
| 二级标题 |
Markdown 文件
Markdown 文件通常以 .md
文件后缀结尾,也少有以 .markdown
后缀结尾的。