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)
  • 可点击图片:[![alt](图片)](目标链接)

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)
图片 ​![alt](图片路径)
表格 ​| 头 | 头 |
| - | - |
分割线 ​---(单独一行)
删除线 ​~~删除~~
脚注 ​[^id]​ … [^id]: 注释
转义字符 ​\*
数学公式 ​$E=mc^2$
Mermaid 图 ​```mermaid