中文写作的 Markdown 约定
发布时间:

中文写作的 Markdown 约定

给这套博客内容保留一份简洁、稳定的排版约定。

为了让后续文章保持统一,我给这个博客定了几条简单的 Markdown 约定。

标题层级

一篇文章只保留一个一级标题,由页面布局负责展示。正文从二级标题开始,避免结构过深。

段落长度

每个段落尽量只表达一个完整意思。能拆开的句子就拆开,避免一段塞进太多背景信息。

列表使用

列表只在并列关系明确时使用。若内容存在先后因果或判断转折,优先写成普通段落。

引用与代码

引用用于保留原话,代码用于呈现真实示例。两者都应该服务于论点,而不是占据版面。

const writingRule = {
  结构: '先结论,后展开',
  语言: '尽量具体',
  节奏: '宁少勿乱',
};

图片

图片只在文字无法准确表达时加入。能用一句话说明清楚的内容,不必额外放图。