Markdown学习笔记：标题、列表与代码块怎么分工

Markdown笔记好不好读，更多取决于结构，而不是用了多少装饰。标题、列表和代码块各自承担不同任务，分清用途就能减少排版返工。

标题表达层级

通常用一个一级标题标明主题，二级标题划分问题，三级标题细分步骤。不要为了文字更大就随意跳级，也不要把每一句话都写成标题。读者扫一眼标题，应能知道文章如何展开。

列表用于并列或顺序

有先后关系的操作使用有序列表，并列条件使用无序列表。解释一项原因时仍可用完整段落，不必把所有内容切成短碎句。留出必要空行，能提高不同渲染器之间的可读性。

代码块保留可复制内容

命令和代码用围栏代码块，标注语言；结果输出另开一块，避免读者把提示符和结果一起复制执行。截图可辅助解释界面，却不应替代需要复制的代码。提交或发布前，使用目标平台预览一次链接与换行。

可复制的练习

# 学习笔记

## 要解决的问题

记录具体场景。

## 检查步骤

1. 准备输入
2. 核对输出

## 参考资料

保留来源和查阅日期。

把这段内容保存为.md文件，在目标编辑器中预览层级。

参考与延伸阅读

CommonMark 语法参考。本文的学习步骤和练习为本站整理；涉及具体产品或工具时，请同时核对当前版本说明。

• 给项目准备一份不含秘密的配置示例
• JSON配置文件打不开，先检查语法再检查字段

资料查阅与编辑日期：2026年9月22日。作者：玖柒。