文章目录
- Markdown 基本语法
- 列表与引用
- 链接与图片
- 代码与表格
- 其他功能
- 高级表格控制
- 嵌套列表与任务列表
- 内联 HTML 与 CSS
- 脚注与注释
- 数学公式与图表
- 扩展语法支持
- 代码高亮与 diff 显示
- 自动链接与引用式链接
Markdown 基本语法
Markdown 是一种轻量级标记语言,用于格式化文本内容。其语法简洁直观,适合快速编写文档、博客或笔记。
段落与换行
段落之间用一个空行分隔。若需强制换行,在行尾添加两个空格或使用<br>标签。
标题
通过#数量表示标题层级,最多支持六级:
# 一级标题 ## 二级标题 ### 三级标题强调文本
用*或_包裹文本实现斜体或加粗:
*斜体* 或 _斜体_ **加粗** 或 __加粗__列表与引用
无序列表
使用-、*或+创建:
- 项目一 - 项目二有序列表
数字加点号:
1. 第一项 2. 第二项引用块
以>开头:
> 这是引用内容。链接与图片
链接
格式为[显示文本](URL):
[Google](https://www.google.com)图片
语法类似链接,前加!:
代码与表格
行内代码
用反引号`包裹:
`print("Hello")`代码块
用三个反引号或缩进四个空格:
```python print("Hello") ```表格
用|和-对齐列:
| 列1 | 列2 | |-----|-----| | 内容 | 内容 |其他功能
分隔线
三个或以上-、*或_:
---转义字符
用\输出特殊符号:
\* 显示星号内联 HTML
Markdown 支持直接嵌入 HTML 标签:
<button>点击</button>Markdown 语法灵活,以上为基础用法,实际可根据需求组合使用。
高级表格控制
使用管道符|和连字符-创建表格,结合冒号:控制对齐方式。例如左对齐、居中对齐或右对齐。表格内容支持换行符<br>或 HTML 标签实现多行文本。
| 左对齐 | 居中对齐 | 右对齐 | |:-----------|:--------------:|-----------:| | 单元格内容 | 单元格内容 | 单元格内容 |嵌套列表与任务列表
通过缩进实现多级列表嵌套,混合有序和无序列表。任务列表使用- [ ]或- [x]表示未完成和已完成任务。
1. 一级有序列表 - 二级无序列表 * 三级无序列表 - [ ] 未完成任务 - [x] 已完成任务内联 HTML 与 CSS
直接嵌入 HTML 标签扩展功能,例如添加<div>、<span>或内联样式。支持使用<font>标签修改颜色和字体,但部分解析器可能不兼容。
<span style="color:red">红色文本</span> <table><tr><td>HTML 表格</td></tr></table>脚注与注释
通过[^label]语法添加脚注,在文档末尾定义脚注内容。注释可使用 HTML 的<!-- -->标签,但不会在渲染后显示。
这是一个脚注示例[^note]。 [^note]: 这里是脚注的详细内容。 <!-- 这是隐藏的注释 -->数学公式与图表
使用$$包裹块级公式,$包裹行内公式。部分解析器支持 Mermaid 或 Flowchart 绘制图表,需查看兼容性。
$$ E = mc^2 $$ 行内公式 $a^2 + b^2 = c^2$ ```mermaid graph TD; A-->B; A-->C;扩展语法支持
部分解析器支持扩展语法,如表格合并单元格、目录生成[TOC]、自定义属性等。需确认工具链是否支持这些特性。
| 合并列示例 || |---------|---------| | 跨两列内容 |代码高亮与 diff 显示
在代码块后指定语言名称实现语法高亮。使用diff语言显示差异内容,删除行以-开头,新增行以+开头。
defhello():print("Hello World")- 删除的行 + 新增的行自动链接与引用式链接
直接输入 URL 或邮箱自动转换为链接。引用式链接将 URL 集中管理,提高可读性。
<https://example.com> <user@example.com> [Google][1] [1]: https://google.com