慢记搜索

让长文更好读:我的排版清单

好的排版让读者把注意力留给内容。标题层级、段落间距、图片和代码的宽度,是我每次发布前会检查的几件小事。

标题和段落

一个二级标题最好回答一个问题。段落不必故意切得很碎,但也不要让太多意思挤在一起。长标题会自然换行,不应遮住边上的导航。

需要解释的细节

中文正文采用适合长文的行距。链接需要可识别,并允许长地址断行,例如 https://example.com/a-very-long-address-for-testing-readable-links-without-horizontal-page-overflow/ 。

代码示例

代码可以在自己的区域内横向滚动,不应该撑宽整个页面。

from pathlib import Path

def count_notes(folder):
    return len(list(Path(folder).glob("*.md")))

print(count_notes("notes"))
print("a_long_value_" * 30)

表格示例

检查项目 处理方式 发布前确认
图片 按正文宽度缩放 图片有描述
代码 保留缩进并可滚动 语言标记正确
分类 选择贴近主题的分类 能通过分类找到

这是一篇原创示例文章,可以在后台删除或改写。