格式与排版
掌握标题、列表、链接、引用和代码段的基本规则。
Markdown 的标题使用井号表示层级,井号后应当留一个空格。每份独立文档通常只需要一个一级标题,主要章节使用二级标题,具体步骤再使用三级标题。清晰的层级能让读者先理解整体结构,也便于导出工具生成可访问的目录与页面书签。
无序列表适合并列要点,有序列表适合必须依次执行的步骤。列表项最好采用一致的句式,例如全部以动作开头。一个列表项包含多个段落时,需要保持缩进一致,并在预览中检查是否仍然属于同一项,避免后面的内容被误读为新的步骤。
链接文字应当说明目标内容,例如安装说明或资料来源,而不是仅写点击这里。图片需要有简短的替代说明,让图片无法加载时读者仍然理解它的作用。给本地文件建立链接时,优先使用相对路径,并在移动整个资料目录后重新检查链接是否有效。
引用段落用于区分他人的表述与自己的分析,引用之后应当交代来源和必要背景。代码围栏用于保留缩进和特殊字符,可以在围栏后注明语言,帮助阅读工具选择合适的语法高亮。请不要把密码、访问令牌或其他敏感信息写进准备公开的示例。
表格适合比较少量、结构相同的信息。内容太长时,宁可改成分节说明,也不要把整篇文章塞进单元格。粗体用于强调真正需要注意的关键词,保持适量即可。完成排版后应当在窄屏预览一次,确认长链接、代码和表格不会影响正文阅读。