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