markdown语法

Markdown 语法详细指南
Markdown 是一种轻量级标记语言,设计用于创建格式化文本,同时保持易读性。以下是一份详细的 Markdown 语法指南:
基础语法
标题
使用 #
符号创建标题,#
的数量表示标题级别:
1 | # 一级标题 |
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
文本格式
1 | *斜体文本* 或 _斜体文本_ |
斜体文本 或 斜体文本
粗体文本 或 粗体文本
粗斜体文本 或 粗斜体文本
删除线文本
列表
无序列表:
1 | - 项目1 |
- 项目1
- 项目2
- 子项目2.1
- 子项目2.2
有序列表:
1 | 1. 第一项 |
- 第一项
- 第二项
- 子项2.1
- 子项2.2
链接和图片
链接:
1 | ``` |
链接文本
链接文本
https://www.example.com
图片:
1 |  |
引用
1 | > 这是一段引用文本 |
这是一段引用文本
这是引用的第二段
这是嵌套引用
代码
行内代码:
1 | `代码` |
代码
代码块:
1 | ```python |
1 | def hello_world(): |
高级语法
表格
1 | | 表头1 | 表头2 | 表头3 | |
表头1 | 表头2 | 表头3 |
---|---|---|
单元格1,1 | 单元格1,2 | 单元格1,3 |
单元格2,1 | 单元格2,2 | 单元格2,3 |
对齐方式: |
1 | | 左对齐 | 居中对齐 | 右对齐 | |
左对齐 | 居中对齐 | 右对齐 |
---|---|---|
文本 | 文本 | 文本 |
文本较长 | 文本较长 | 文本较长 |
任务列表
1 | - [x] 已完成任务 |
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 另一个未完成任务
水平分割线
1 | --- |
脚注
1 | 这里有一个脚注引用[^1] |
这里有一个脚注引用[^1]
[^1]: 这里是脚注内容。脚注内容可以很长,可以包含多行文本和格式化的内容,比如 斜体 或 粗体。
转义字符
使用反斜杠转义特殊字符:
1 | \* 这不是斜体 \* |
* 这不是斜体 *
自动链接
1 | <https://www.example.com> |
https://www.example.com
[email protected]
扩展语法(注意:部分平台可能不支持)
定义列表
1 | 术语1 |
术语1
: 定义1,这是术语1的定义。
术语2
: 定义2.1,这是术语2的第一个定义。
: 定义2.2,这是术语2的第二个定义。
上标和下标
1 | 水的化学式是 H~2~O |
水的化学式是 H~2~O
平方公式是 x^2^
E = mc^2^
高亮文本
1 | ==高亮文本== |
==高亮文本==
删除线(另一种方式,更常见)
1 | ~~要删除的文本~~ |
要删除的文本
目录生成
1 | [TOC] |
[TOC]
更多用法和技巧
Emoji 表情符号
Markdown 支持使用 Emoji 表情符号,可以通过字符码或直接插入表情符号:
1 | :smile: |
:smile:
😄
使用 HTML 标签
虽然 Markdown 主要使用自身的语法,但也支持嵌入 HTML 标签,用于更复杂的格式化:
1 | <p style="color:blue;">这是一段蓝色的文字。</p> |
这是一段蓝色的文字。
LaTeX 公式 (需要支持 LaTeX 的 Markdown 渲染器)
行内公式: $E=mc^2$
1 | 行内公式: `$E=mc^2$` |
行内公式:$E=mc^2$
块级公式:
1 | $$ |
$$
E=mc^2
$$
嵌套使用
Markdown 的各种语法可以嵌套使用,创造更复杂的格式。
例如:
1 | > 这是一个包含**粗体**和[链接](https://www.example.com)的引用。 |
这是一个包含粗体和链接的引用。
- 这是一个嵌套的列表项
- 带缩进的子列表
实用技巧
- 空行: 段落之间需要空行分隔
- 行内HTML: Markdown 支持混合使用 HTML
- 缩进: 在列表项下缩进至少两个空格来创建子项
- 换行: 在行末添加两个空格然后回车可以创建硬换行
- 长文本自动换行: 一些 Markdown 编辑器支持长文本自动换行,确保阅读体验。可以根据需要禁用或启用。
- 使用 Markdown 编辑器: 选择一款功能强大的 Markdown 编辑器,例如 Typora, VS Code (配合 Markdown 插件), Obsidian 等,可以极大地提高写作效率。 许多编辑器支持实时预览、语法高亮、自动补全等功能。
常见注意事项
- Markdown 实现可能因平台而异
- 某些扩展语法需要特定处理器支持
- 嵌套列表通常需要适当缩进
- 特殊字符可能需要转义
希望这份指南能够帮助你更好地使用 Markdown!
评论
评论插件加载失败
正在加载评论插件