markdown语法
zhouzhou Lv3

Markdown 语法详细指南

Markdown 是一种轻量级标记语言,设计用于创建格式化文本,同时保持易读性。以下是一份详细的 Markdown 语法指南:

基础语法

标题

使用 # 符号创建标题,# 的数量表示标题级别:

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

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

文本格式

1
2
3
4
*斜体文本*_斜体文本_
**粗体文本**__粗体文本__
***粗斜体文本***___粗斜体文本___
~~删除线文本~~

斜体文本斜体文本
粗体文本粗体文本
粗斜体文本粗斜体文本
删除线文本

列表

无序列表:

1
2
3
4
- 项目1
- 项目2
- 子项目2.1
- 子项目2.2
  • 项目1
  • 项目2
    • 子项目2.1
    • 子项目2.2
      有序列表:
1
2
3
4
1. 第一项
2. 第二项
1. 子项2.1
2. 子项2.2
  1. 第一项
  2. 第二项
    1. 子项2.1
    2. 子项2.2

链接和图片

链接:

1
2
3
4
5
6
```
[链接文本带标题](https://www.example.com "标题文本")
```markdown
[链接文本](https://www.example.com)
[链接文本](https://www.example.com)
<https://www.example.com>

链接文本
链接文本
https://www.example.com
图片:

1
![替代文本](https://zhouzhou12203.github.io/picx-images-hosting/0.99thukglgj.webp "图片标题")

image

引用

1
2
3
4
> 这是一段引用文本
>
> 这是引用的第二段
>> 这是嵌套引用

这是一段引用文本

这是引用的第二段

这是嵌套引用

代码

行内代码:

1
`代码`

代码
代码块:

1
2
3
4
5
```python
def hello_world():
print("Hello, world!")
hello_world()
```
1
2
3
def hello_world():
print("Hello, world!")
hello_world()

高级语法

表格

1
2
3
4
| 表头1 | 表头2 | 表头3 |
|-------|-------|-------|
| 单元格1,1 | 单元格1,2 | 单元格1,3 |
| 单元格2,1 | 单元格2,2 | 单元格2,3 |
表头1 表头2 表头3
单元格1,1 单元格1,2 单元格1,3
单元格2,1 单元格2,2 单元格2,3
对齐方式:
1
2
3
4
| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:-------:|-------:|
| 文本 | 文本 | 文本 |
| 文本较长 | 文本较长 | 文本较长 |
左对齐 居中对齐 右对齐
文本 文本 文本
文本较长 文本较长 文本较长

任务列表

1
2
3
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 另一个未完成任务
  • [x] 已完成任务
  • [ ] 未完成任务
  • [ ] 另一个未完成任务

水平分割线

1
2
3
---
***
___



脚注

1
2
这里有一个脚注引用[^1]
[^1]: 这里是脚注内容。脚注内容可以很长,可以包含多行文本和格式化的内容,比如 *斜体* 或 **粗体**。

这里有一个脚注引用[^1]
[^1]: 这里是脚注内容。脚注内容可以很长,可以包含多行文本和格式化的内容,比如 斜体粗体

转义字符

使用反斜杠转义特殊字符:

1
\* 这不是斜体 \*

* 这不是斜体 *

自动链接

1
2
<https://www.example.com>
<[email protected]>

https://www.example.com
[email protected]

扩展语法(注意:部分平台可能不支持)

定义列表

1
2
3
4
5
术语1
: 定义1,这是术语1的定义。
术语2
: 定义2.1,这是术语2的第一个定义。
: 定义2.2,这是术语2的第二个定义。

术语1
: 定义1,这是术语1的定义。
术语2
: 定义2.1,这是术语2的第一个定义。
: 定义2.2,这是术语2的第二个定义。

上标和下标

1
2
3
水的化学式是 H~2~O
平方公式是 x^2^
E = mc^2^

水的化学式是 H~2~O
平方公式是 x^2^
E = mc^2^

高亮文本

1
==高亮文本==

==高亮文本==

删除线(另一种方式,更常见)

1
~~要删除的文本~~

要删除的文本

目录生成

1
[TOC]

[TOC]

更多用法和技巧

Emoji 表情符号

Markdown 支持使用 Emoji 表情符号,可以通过字符码或直接插入表情符号:

1
2
:smile:
😄

:smile:
😄

使用 HTML 标签

虽然 Markdown 主要使用自身的语法,但也支持嵌入 HTML 标签,用于更复杂的格式化:

1
<p style="color:blue;">这是一段蓝色的文字。</p>

这是一段蓝色的文字。

LaTeX 公式 (需要支持 LaTeX 的 Markdown 渲染器)

行内公式: $E=mc^2$

1
2
行内公式: `$E=mc^2$`
块级公式:

行内公式:$E=mc^2$
块级公式:

1
2
3
$$
E=mc^2
$$

$$
E=mc^2
$$

嵌套使用

Markdown 的各种语法可以嵌套使用,创造更复杂的格式。
例如:

1
2
3
4
> 这是一个包含**粗体**和[链接](https://www.example.com)的引用。
>
> - 这是一个嵌套的列表项
> - 带缩进的子列表

这是一个包含粗体链接的引用。

  • 这是一个嵌套的列表项
    • 带缩进的子列表

实用技巧

  1. 空行: 段落之间需要空行分隔
  2. 行内HTML: Markdown 支持混合使用 HTML
  3. 缩进: 在列表项下缩进至少两个空格来创建子项
  4. 换行: 在行末添加两个空格然后回车可以创建硬换行
  5. 长文本自动换行: 一些 Markdown 编辑器支持长文本自动换行,确保阅读体验。可以根据需要禁用或启用。
  6. 使用 Markdown 编辑器: 选择一款功能强大的 Markdown 编辑器,例如 Typora, VS Code (配合 Markdown 插件), Obsidian 等,可以极大地提高写作效率。 许多编辑器支持实时预览、语法高亮、自动补全等功能。

常见注意事项

  • Markdown 实现可能因平台而异
  • 某些扩展语法需要特定处理器支持
  • 嵌套列表通常需要适当缩进
  • 特殊字符可能需要转义
    希望这份指南能够帮助你更好地使用 Markdown!
 评论
评论插件加载失败
正在加载评论插件
由 Hexo 驱动 & 主题 Keep
访客数 访问量