Markdown 标题、列表、引用和表格的使用方法
用一份活动通知掌握四种常用 Markdown 结构，理解空行、层级和表格分隔行对预览的影响。
文章目录
要解决什么问题
文章里有小标题、操作步骤、重点观点和活动安排，全部写成段落会显得混乱。Markdown 用少量符号标记这些结构，PageLumi 的预览再根据当前模板生成对应样式。先把结构写对，再调整外观，通常更容易定位问题。
操作步骤
标题：井号后留空格
一级标题用 #，二级标题用 ##，三级标题用 ###。例如 ## 活动安排 是一个二级标题，##活动安排 可能只是普通文字。标题前后留空行，更方便阅读源文件。
通常一篇文章只需要一个主标题，再用二级标题组织大段落，三级标题补充分步骤。不要只为了字号较小就跳过层级；字号和装饰可以在「模板设计」中调整。
列表：根据关系选择符号
并列事项用 - ，有先后次序的操作用 1. 、2. 。符号后都需要空格，列表前留空行。嵌套列表需要缩进，初次使用时可以先保持一层，避免手机端出现过窄的内容。
- 带上自己的书
- 准备一段分享
1. 介绍书名与作者。
2. 朗读喜欢的段落。
3. 分享阅读感受。
引用：用大于号突出一段话
在段首写 > 。如果引用有多个段落，每段都加引用标记，中间可用单独的 > 分隔。引用适合补充说明或引述，不能代替文章所有正文。
> 分享没有标准答案，真实的感受就很好。
表格：表头之后必须有分隔行
PageLumi 支持 GFM 表格。第一行是列名，第二行是分隔行，之后才是数据。缺少第二行时，文本不会变成表格。每行列数保持一致，内容中出现竖线时用 \| 转义。
| 时间 | 内容 |
| --- | --- |
| 14:00 | 自我介绍 |
| 14:15 | 阅读分享 |
表格适合简短对照，长解释更适合分段或列表。公众号手机阅读宽度有限，尽量减少列数，并检查粘贴后的效果。
示例：把结构组合成一份活动通知
# 社区读书会
本周六一起分享最近读到的一本好书。
## 活动安排
1. 每人用三分钟介绍一本书。
2. 选一段喜欢的文字朗读。
3. 交流阅读感受。
### 出发前准备
- 带上自己的书
- 准备一段分享
> 分享没有标准答案，真实的感受就很好。
| 时间 | 内容 |
| --- | --- |
| 14:00 | 自我介绍 |
| 14:15 | 阅读分享 |
| 15:00 | 自由交流 |
这份示例用二级标题介绍活动安排，三级标题说明准备事项。时间表给出简短的信息对照，引用表达活动态度，正文不必反复解释每个时间点。
预期效果
| 源文本结构 | 预览中的表现 | 检查要点 |
|---|---|---|
## 活动安排 | 二级标题 | 井号后有空格 |
- 带上自己的书 | 无序列表项 | 减号后有空格 |
1. 每人用三分钟… | 有序列表项 | 顺序清楚 |
> 分享没有标准答案… | 引用块 | 内容不混入普通段落 |
| 表头、分隔行、数据行 | 表格 | 各行列数一致 |
常见问题
为什么代码示例里的井号没有变成标题？
围栏代码块会原样显示文字。把示例粘贴到排版工具时，只需要围栏内部的内容，不要连同包围它的三个反引号一起粘贴。本文「复制代码」按钮复制的就是代码内容。
为什么一行换行后预览仍然接在一起？
普通段落中的单次换行通常不会另起一个段落。要分成两段，请留一个空行。先用段落、列表和标题组织内容，比反复插入换行更稳定。
能在源文本里直接写 HTML 或组件吗？
当前渲染器按 Markdown/GFM 处理内容，不执行 MDX 组件，也不会将原始 HTML 当作可执行的页面内容。使用 Markdown 语法完成这些基本结构即可。
