什么是 Markdown
Markdown 是一种「 轻量级标记语言 」,用途广泛,使用简洁的语法代替常见排版格式,从而能使我们专心于写作,在最大程度上提高效率。Markdown 的语法十分简单,常用的标记符号也不超过十个,学习成本极低,一旦熟悉这种语法规则,将会有一劳永逸的效果。
We believe that writing is about content, about what you want to say – not about fancy formatting.
我们坚信写作写的是内容,所思所想,而不是花样格式。
使用 Markdown 的优点
- 专注你的文字内容而不是排版样式。
- 纯文本内容,兼容所有的文本编辑器。
- 可读、直观、通用性高、学习成本低。
- 轻松导出
HTML
、PDF
等格式的文件。 - 随时可修改
.md
文件,不会因版本问题导致格式混乱。
Markdown 语法规则
标题
标记符:#
标题是文章最常用的格式,在 Markdown 中,如果一段文字被定义为标题,只需在这段文字前加 #
标记符。
例如:
# 一级标题
## 二级标题
## 三级标题
- ……
以此类推,共六级标题,对应 HTML
的 H1 ~ H6。
注意:#
和文字之间需加一个空格。
字体加粗
标记符:**
或 __
在需要表示为粗体的文字内容,用两个 **
或 __
标记符包裹。
例如:**字体加粗**
或 __字体加粗__
斜体
标记符:*
或 _
在需要表示为斜体的文字内容,用两个 *
或 _
标记符包裹。
例如:*斜体*
或 _斜体_
引用
标记符:>
只需在引用的文字内容前面加上 >
标记符,就可以出现引用的效果。
例如:> 我是引用的句子哦
列表
无序列表
标记符:-
或 +
或 *
在需要表示为无序列表的文字前加 -
或 +
或 *
标记符。
有序列表
标记符:1.
或 2.
或 3.
……
在需要表示为有序列表的文字前面添加加 1.
或 2.
或 3.
…… 标记符。
链接
标记符:[]()
在 Markdown 中,插入链接,例如:[XPoet Blog](https://xtpoet.cn)
图片
标记符:![]()
图片示例:![aliyun](https://img.alicdn.com/tfs/TB1Ly5oS3HqK1RjSZFPXXcwapXa-238-54.png)
代码
单行代码
标记符:` `
需要引用代码时,如果引用的代码只有一行,可以用两个 ` 标记符将代码包裹起来。例如:
多行代码
标记符:``` ```
多行代码,用两个 ``` 标记符将代码块包裹起来。例如:
分割线
标记符:***
或 ---
或 ___
插入分割线,在一行中用三个以上的 *
或 -
或 _
标记符来建立一个分隔线,行内不能有其他内容,分隔符独占一行。
删除线
标记符:~~
在需要添加删除线的文字内容,用两个 ~~
标记符包裹。
例如:~~ABC~~
ABC
换行
标记符: 两个空格符
加 回车
在 Markdown 中进行换行,需在文字后面键入 两个空格符
加 回车
。
表格
在 Markdown 中插入表格的标记符比较复杂,大家直接看效果,需要用到时过来复制代码。
默认表格样式
参考代码:
1 | ColName1 | ColName2 | ColName3 |
效果如下:
ColName1 | ColName2 | ColName3 |
---|---|---|
ColValue | ColValue | ColValue |
ColValue | ColValue | ColValue |
ColValue | ColValue | ColValue |
ColValue | ColValue | ColValue |
表格列调整
表格的列位置调整(默认左对齐,:------:
居中,------:
右对齐)
参考代码:
1 | |ColName1 | ColName2 | ColName3| |
效果如下:
ColName1 | ColName2 | ColName3 |
---|---|---|
ColValue | ColValue | ColValue |
ColValue | ColValue | ColValue |
ColValue | ColValue | ColValue |
ColValue | ColValue | ColValue |
由于不同平台的 Markdown CSS 存在差异,实际显示效果跟本文也会有所不同。