目录
一、Markdown 的定义
Markdown 是一种简单的标记语言,它可以被编译成 HTML 页面,或者也可以单独以纯文本的形式呈现。
- Markdown 的目标是实现“易读易写”
- 兼容 HTML
二、Markdown 的基本语法
1. 标题
Markdown 语法中,标题有两种:Atx 方式 和 Setext 方式。但是,Setext方式很多的Markdown编辑器并不支持,因此,只需要了解Atx 方式方式即可。
以 # 符开头,共六级,一级就以一个 # 开头,二级就以两个#开头(写成##),其余依此类推。
# 1级标题
## 2级标题
### 3级标题
#### 四级标题
##### 五级标题
###### 六级标题
2. 文本
(1)斜体
前后各一个 *
(星号)或各一个 _
(下划线符)包围的文本是倾斜文本。
也可以使用 Html 标签 <em>倾斜</em>
(2)加粗
前后各两个 *(星号)或各两个 _(下划线符)包围的文本是加粗文本。
也可以使用 Html 标签 <b>加粗</b> 或 <strong>加粗</strong>
(3)删除线
前后各两个 ~(波浪号)会在文本上显示删除线。
(4)标记文本
前后各两个 =(等号)会在文本上标记。
3. 代码段
代码块有两种,一种在行内,另一种可以跨行。
行内代码块编译后会被 Html 的 <code></code>标签对包围;
而跨行代码块会被编译到<pre><code></code></pre>标签对中。
跨行代码块的快速输入
每一行以四个半角空格(或以至少一个Tab符)开头,以两个半角空格结尾。
例如:
□□□□function DeleteText()□□
□□□□{□□
□□□□□□□□string s = "示例文本";□□
□□□□□□□□...□□
□□□□□□□□ClipBoard.Delete();□□
□□□□}□□
[Tab]function DeleteImage()□□
[Tab]{□□
[Tab][Tab]Image img = new Image();□□
[Tab][Tab]...□□
[Tab][Tab]ClipBoard.Delete();□□
[Tab]}□□
转译后会显示为:
function DeleteText()
{
string s = "示例文本";
...
ClipBoard.Delete();
}
function DeleteImage()
{
Image img = new Image();
...
ClipBoard.Delete();
}
4. 列表
列表分为无序列表和有序列表。
(1)无序列表
以 -、+
、*
这三个字符开头的行是无序列表项。这三个字符使用任意一个字符都可以,编译后的结果是一样的。
注意:但是使用 *
作为列表开头会与加粗、倾斜
这两种效果冲突,所以尽可能不要用!
(2)有序列表
有序列表由数字开头,后跟句点(或.,也可以是、)。
5. 表格
标准 Markdown 语法一开始并没有支持文字表,但后来不少定制版本都添加了对文字表的支持,其中有些功能还很丰富。
基本格式如下:
| Column 1 | Column 2 |
|:--------:| -------------:|
| centered 文本居中 | right-aligned 文本居右 |
例如:
项目 | Value
-------- | -----
电脑 | $1600
手机 | $12
导管 | $1
6. 块引用
块引用一般用于注释,以 > (大于号加空格)开头。
也可以使用 Html 标签 <blockquote></blockquote>
7. 水平线
由三个以上连续的减号组成的文本会被视为水平线。
8. 链接
链接主要分两种:文字超链接、图像超链接
(1)文字超链接
文字超链接的使用较为常见。基本格式如下:
[我的小窝](http://www.lunarsf.club "我的个人网站")
(2)图像超链接
![找不到图像文件时显示的文本](图像路径)
当然还有一种自动链接,语法如下:
<http://www.baidu.com>
电子邮件地址也可以这样做。例如:
<lunarsf@163.com>
三、Markdown 的快捷键
撤销 | Ctrl/Command + Z |
重做 | Ctrl/Command + Y |
加粗 | Ctrl/Command + B |
斜体 | Ctrl/Command + I |
标题 | Ctrl/Command + Shift + H |
无序列表 | Ctrl/Command + Shift + U |
有序列表 | Ctrl/Command + Shift + O |
检查列表 | Ctrl/Command + Shift + C |
插入代码 | Ctrl/Command + Shift + K |
插入链接 | Ctrl/Command + Shift + L |
插入图片 | Ctrl/Command + Shift + G |
查找 | Command + F |
替换 | Command + G |
补充:在 Markdown 中使用 HTML 标签
Markdown 没有定义的 HTML 标签,都可以直接在 Markdown 文档中书写。
但是一些 HTML 区块元素――比如 <div>、<table>、<pre>、<p> 等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。
例子如下,在 Markdown 文件里加上一段 HTML 表格:
这是一个普通段落。
<table>
<caption>表格示例标题</caption>
<tr>
<th>表头01</th>
<th>表头02</th>
</tr>
<tr>
<td>单元格01</td>
<td>单元格02</td>
</tr>
<tr>
<td>单元格03</td>
<td>单元格04</td>
</tr>
</table>
这是另一个普通段落。
编译成 HTML 网页,会显示成这样:
表头01 | 表头02 |
---|---|
单元格01 | 单元格02 |
单元格03 | 单元格04 |
注意:在 HTML 区块标签间的 Markdown 格式语法将不会被处理,Markdown 语法在 HTML 区块标签间是有效的。
如果是上述简单的二维文字表,还可以用更加简单的 Markdown 语法,下面的代码产生的效果和使用 HTML 语法的效果是等价的。
| 表格示例标题 |
| 表头01 | 表头02 |
|:------|:-------|
|单元格01|单元格02|
|单元格03|单元格04|
来源:CSDN
作者:Fighting_初心
链接:https://blog.csdn.net/qq_34519487/article/details/104340303