什么是 Markdown
Markdown 是一种用纯文本编写带格式文档的方法。在普通文字周围输入几个符号,就能标记出标题、强调、列表、链接和代码,而且文本在转换之前依然清晰易读。
它被用于 README 文件、技术文档、笔记应用、聊天消息以及许多博客工具。上方的编辑器会在您输入时显示每种语法的渲染效果。
通过速查表学习标题、列表、链接、表格和代码块的 Markdown 语法,并在实时预览编辑器中动手尝试。
预览
Markdown 可以把纯文本变成带格式的文本。这一段里有 粗体、斜体 和 删除线 文字,还有一些 行内代码。
第一项
第二项
嵌套项
第一步
第二步
已完成的任务
待办任务
简单的事情就应该简单。
更多内容请访问 example.com。
| 水果 | 价格 |
|---|---|
| 苹果 | 1.20 |
| 梨 | 0.90 |
function greet(name) {
return "Hello, " + name;
}示例图片
预览在您的浏览器中运行。原始 HTML 会显示为文本,图片显示为占位符,并且只有 http、https 和 mailto 链接可以点击。
**bold text***italic text****bold and italic***~~crossed out~~First paragraph.
Second paragraph.First line\
Second line\*not italic\*# Heading 1## Heading 2### Heading 3###### Heading 6Heading 1
=========
Heading 2
---------- First item
- Second item
- Third item1. First item
2. Second item
3. Third item- Parent item
- Child item
- Child item- [x] Finished task
- [ ] Open task[link text](https://example.com)[link text](https://example.com "Tooltip")<https://example.com>`inline code``` code with a ` backtick `````
code block
``````js
console.log("Hi");
```> Quoted text> Quoted text
>> Nested quote---| Name | Qty |
| --- | --- |
| Apple | 3 |
| Pear | 5 || Left | Center | Right |
| :--- | :---: | ---: |
| a | b | c || Markdown | 作用 |
|---|---|
**bold text** | 粗体文本。两侧各用两个下划线也可以。 |
*italic text* | 斜体文本。两侧各用一个下划线也可以。 |
***bold and italic*** | 同时加粗和倾斜,使用三个星号。 |
~~crossed out~~ | 带删除线的文本,两侧各用两个波浪号。 |
First paragraph.
Second paragraph. | 在文本块之间留一个空行,即可开始新的段落。 |
First line\
Second line | 在行尾加一个反斜杠或两个空格,即可在同一段落内另起一行。 |
\*not italic\* | 在 Markdown 符号前加一个反斜杠,就会显示该符号本身。 |
# Heading 1 | 最高一级的标题。井号后面要加一个空格。 |
## Heading 2 | 二级标题,用于主要章节。 |
### Heading 3 | 三级标题,用于小节。 |
###### Heading 6 | 最小的标题。标题级别对应一到六个井号。 |
Heading 1
=========
Heading 2
--------- | 另一种写法:在文字下方加一行等号表示 1 级标题,加一行连字符表示 2 级标题。 |
- First item
- Second item
- Third item | 无序列表。每行以连字符、星号或加号开头。 |
1. First item
2. Second item
3. Third item | 有序列表。每行以数字和英文句点开头。 |
- Parent item
- Child item
- Child item | 将列表项缩进两个或更多空格,即可把它嵌套在上一项之下。 |
- [x] Finished task
- [ ] Open task | 带有已勾选和未勾选复选框的清单。 |
[link text](https://example.com) | 链接。方括号内是显示的文字,圆括号内是地址。 |
[link text](https://example.com "Tooltip") | 带提示文字的链接,提示文字写在地址后面的引号内。 |
<https://example.com> | 尖括号可以把网址变成链接。 |
| 尖括号可以把电子邮件地址变成邮件链接。 | |
 | 图片。写法与链接相同,只是前面多一个感叹号;方括号内的文字用于描述图片。 |
`inline code` | 句子中的代码,用反引号括起来。 |
`` code with a ` backtick `` | 当代码本身包含反引号时,请使用双反引号。 |
```
code block
``` | 代码块,写在两行三个反引号之间。其中的文本会按输入的原样保留。 |
```js
console.log("Hi");
``` | 在开头的反引号后面加上语言名称,编辑器就能高亮显示代码。 |
> Quoted text | 引用文本。在行首加一个大于号。 |
> Quoted text
>> Nested quote | 再加一个大于号,即可在引用中嵌套引用。 |
--- | 分隔线。在单独的一行写三个或更多连字符、星号或下划线。 |
| Name | Qty |
| --- | --- |
| Apple | 3 |
| Pear | 5 | | 表格。用竖线分隔各列,并在表头下方加一行连字符。 |
| Left | Center | Right |
| :--- | :---: | ---: |
| a | b | c | | 分隔行中的冒号可以让一列左对齐、居中或右对齐。 |
Markdown 是一种用纯文本编写带格式文档的方法。在普通文字周围输入几个符号,就能标记出标题、强调、列表、链接和代码,而且文本在转换之前依然清晰易读。
它被用于 README 文件、技术文档、笔记应用、聊天消息以及许多博客工具。上方的编辑器会在您输入时显示每种语法的渲染效果。
大多数问题出在空格和空行上,而不是符号本身。
基本语法是一样的。标题、强调、列表、链接和代码几乎在所有地方都遵循 CommonMark 标准。表格、任务列表和删除线是因 GitHub 而流行起来的扩展语法,所以少数应用并不支持。
预览是有意加以限制的。原始 HTML 会显示为文本,图片显示为带标签的占位符而不会被下载,并且只有 http、https 和 mailto 链接可以点击。
不会。预览在您的浏览器中生成,文本不会被上传或保存。