Markdown 总结(十七)
17.总结
1. 标题
# 号:# 一级 …###### 六级关键规则:
-
# 与文字之间必须有空格 -
#必须在行首,前面不能有空格 - 一个文档建议只有一个一级标题
-
层次结构:不跳级,保持逻辑嵌套(一级 → 二级 → 三级)
自动编号:多数渲染器支持,无需手动写编号
标题锚点:自动生成(小写、空格转短横);可用
[跳转](#锚点)页面内跳转
2. 文本格式
段落:连续行 + 空行分隔;不要用空格或制表符缩进
强制换行:行尾两个空格 + 回车,或
<br>标签字体样式:
- 粗体:
**粗体** - 斜体:
*斜体* - 粗斜体:
***粗斜体***
- 粗体:
分隔线:
---(单独一行)删除线:
~~删除~~下划线:
<u>文字</u>行内代码:
`code`高亮(扩展):
==高亮==
3. 列表
- 无序列表:
- 项目 - 有序列表:
1. 项目(数字自动修正顺序) - 嵌套:子项缩进 2-4 空格(推荐 2 空格)
- 任务列表:
- [ ] 未完成 /- [x] 已完成 - 列表项多段内容:段落缩进对齐
- 列表内换行:行尾两个空格 + 回车
4. 引用
- 基本语法:
> 内容(后跟空格) - 多段落:空行上也写
> - 嵌套:
> > 内层 - 引用内列表:正常写列表语法
- 列表内引用:列表项换行 + 4 空格 +
> - 引用内可包含:标题、代码块、链接、图片等
5. 代码
- 行内代码:
`code` - 代码块:三反引号:
```language(推荐,支持语法高亮) - 常用语言标识:
javascript,python,html,css,sql,bash,json,diff等 - 扩展特性:行号显示
{.line-numbers}、Diff 高亮(+ /-标识变更)
6. 链接
- 行内式:
[文字](URL "标题") - 直接 URL:
<https://example.com> - 邮箱/电话:
mailto: /tel: - 参考式:
[文字][标签] +[标签]: URL(适合长文档,链接定义放末尾) - 锚点链接:
#标题锚点(页面内跳转)
7. 图片
- 基础语法:
 - 图片路径:优先使用相对路径,放在专用文件夹(如
images/) - 参考式图片:同参考式链接
- alt 文本:必须有意义,描述图片内容;装饰性图片可用空
[] - 控制尺寸/对齐:使用 HTML
<img> 标签(width,style,div align) - 可点击图片:
[](目标链接)
8. 表格
基础语法:
| 表头1 | 表头2 | |-------|-------| | 数据1 | 数据2 |对齐:
:--- 左对齐,---: 右对齐,:---:居中对齐单元格内格式化:支持粗体、斜体、行内代码、链接、 换行
特殊字符转义:例如:竖线
| 转义为\|美化建议:使用 emoji、右对齐数字、避免过宽表格
9. 高级技巧
HTML 标签:(按键)、(上标)、(下标)、 等
转义字符:用反斜杠
\ 转义*_#[]等特殊符号数学公式(LaTeX):
- 行内:
$E=mc^2$ - 块级:
$$ ... $$
- 行内:
图表与流程图(Mermaid 最主流):
- 流程图:
graph LR /graph TD - 时序图:
sequenceDiagram - 甘特图:
gantt
- 流程图:
注意:扩展语法依赖渲染器支持
10. 分割线
- 语法:
---(单独一行) - 使用场景:章节分隔、内容区块分隔、页面底部分隔、引用与正文分隔
- 最佳实践:合理使用,风格统一(推荐
---),避免过度使用
总结速查表
| 功能 | 语法示例 |
|---|---|
| 标题 | # 标题 |
| 粗体 | **粗体** |
| 斜体 | *斜体* |
| 无序列表 | - 项目 |
| 有序列表 | 1. 项目 |
| 任务列表 | - [ ] 待办 / - [x] 完成 |
| 引用块 | > 内容 |
| 行内代码 | `code` |
| 代码块 | ```language |
| 链接 | [文字](URL) |
| 图片 |  |
| 表格 | | 头 | 头 || - | - | |
| 分割线 | ---(单独一行) |
| 删除线 | ~~删除~~ |
| 脚注 | [^id] … [^id]: 注释 |
| 转义字符 | \* |
| 数学公式 | $E=mc^2$ |
| Mermaid 图 | ```mermaid |