markdown使用详解

Markdown是一种轻量级的标记语言，旨在简化文本格式化，使得作者能够专注于内容创作，而不必过多关注排版细节。它使用简洁易记的符号和字符组合来表示文本样式和结构，使得纯文本文档具有良好的可读性和可编写性，同时又能轻松转换为HTML、PDF等多种格式。以下是对Markdown主要使用规则和功能的详细解释：

基础文本格式

段落与换行

• 段落：连续的文本行被视为一个段落，段落之间应保持一个空行以区分。

换行：

• 软换行：在同一段落内，希望在显示时强制换行，可在行尾输入两个或以上的空格，然后回车。
• 硬换行：如果需要在源码中立即换行，而不影响显示效果，可以使用反斜杠\作为行尾，即在行尾输入\后回车。

空格：

• 一般情况下，Markdown会合并连续的空格为一个。若需要显示多个连续空格，可以使用HTML实体 来表示一个非合并空格。

标题

使用特定数量的#符号（井字号）来表示不同级别的标题。#符号后面紧跟一个空格，然后是标题文本：

Markdown

1# 一级标题
2## 二级标题
3### 三级标题
4#### 四级标题
5##### 五级标题
6###### 六级标题

文本样式

粗体与斜体

• 粗体：使用两个星号**或下划线__包围文本。
• 斜体：使用一个星号*或下划线_包围文本。

示例：

Markdown

1**粗体文本** 或 __粗体文本__
2*斜体文本* 或 _斜体文本_

删除线

使用两个波浪线~~包围文本：

Markdown

1~~删除线文本~~

代码

• 行内代码：使用反引号（键盘左上角的）包裹代码片段，如 inline code`。
• 代码块：使用三个反引号（```）起始和结束，并在起始的三个反引号后面指定编程语言（可选），如：

Markdown

1```python
2def hello_world():
3    print("Hello, World!")

Code

1
2### **列表**
3
4#### **无序列表**
5
6使用`-`、`+`或`*`作为列表项标记，后跟一个空格，然后是列表项内容：
7
8```markdown
9- 列表项1
10- 列表项2
11  - 子列表项
12+ 列表项3
13* 列表项4

有序列表

使用数字加英文句点1.作为列表项标记，后跟一个空格，然后是列表项内容：

Markdown

11. 列表项1
22. 列表项2
33. 列表项3
4   1. 子列表项

引用

使用大于号>（可连续使用表示嵌套引用）和一个空格开始每行引用文本：

Markdown

1> 这是一段引用。
2>
3>> 这是嵌套引用。

链接

内联链接

使用方括号[]包裹链接文本，后跟圆括号()包裹链接地址：

Markdown

1[Google](https://www.google.com)

参考式链接

将链接定义放在文档任意位置，使用方括号加尖括号[]<>的形式标记，然后在实际引用处使用方括号包裹链接文本：

Markdown

1[Google][google-link]
2
3...
4
5[google-link]: https://www.google.com "Google"

图片

与链接类似，使用感叹号!代替方括号[]，并在括号内提供图片描述和URL：

Markdown

1![Alt text](https://example.com/image.jpg)

水平线

使用三个或更多连续的短横线---或***来创建一条水平分割线：

Markdown

1---
2
3***

表格

使用竖线|分隔列，使用-或:（用于设定对齐方式）分隔表头和主体：

Markdown

1| Column 1 | Column 2 | Column 3 |
2|----------|:--------:|---------:|
3| Text     | Centered | Right    |

表情符号

直接输入Unicode表情符号（如😀）或使用:emoji_name:形式（如:smile:）插入表情。

其他

• 转义字符：使用反斜杠\对特殊字符进行转义，如\*、\(、\\等，以避免它们被解析为Markdown语法。

扩展语法

不同的Markdown解析器或编辑器可能支持额外的扩展语法，如数学公式、脚注、TOC（目录）、自定义标签等。这些特性可能需要查阅具体工具的文档以了解如何使用。

通过熟练掌握以上Markdown基本语法和常见扩展，您就能高效地使用Markdown编写美观、结构清晰的文档，并轻松转换为各种格式进行发布和分享。