Markdown 排版实验手记
写在前面
这是一篇为 PlainBlog 编写的演示文章,并非作者的真实工作记录。排版首先要让文字能读,然后才轮到各种边界条件。重点和轻声提醒都应该留在同一条阅读线上;行内的 const value = 1 不需要另起一行。
一份小清单
- 留下可追溯的标题
- 再补上发布日期
- 检查正文的链接与图片
- 从最小示例开始
- 在窄屏重新阅读
- 检查有序和无序列表
- 记录下一次修改
如果每一段都在争夺注意力,读者就没有地方停下来。
链接、图片与宽内容
可以阅读 Markdown Guide,也可以测试一条很长的链接:https://example.org/notes/this-is-a-deliberately-long-path-for-testing-how-links-wrap-on-very-narrow-devices/without-breaking-the-whole-page。图片放在 src/assets/posts/文章文件名/,用可读文件名,不堆在资源根目录,也不请求远程图床。

const observations = ["small screens", "keyboard navigation", "static output"];
const explain = (topic) =>
`A long line for horizontal scrolling: ${topic} — ${observations.join(" / ")} — ${observations.join(" / ")}`;
console.log(explain("readable layouts without a viewport-wide scrollbar"));
| 测试区域 | 关注点 | 在狭窄窗口的预期行为 |
|---|---|---|
| 正文 | 长链接会换行 | 页面不会被单词撑宽 |
| 代码 | 保留缩进和高亮 | 只在代码块内滚动,不改变页面宽度 |
| 表格 | 列不会被强制挤坏 | 表格自己的区域可横向滚动 |
旧的一次性截图并不能代替重新构建与阅读。
收尾
文字并不需要复杂的运行时:一份源文件、一份样式、可直接打开的静态页面,已经足够开始。