一篇文章的解剖图:这里的文章是怎么写出来的

目录

如果你好奇这里的文章是怎么「长」出来的,这一篇就是个活样本。它本身没什么内容,但每个排版零件都摆出来给你看。

一、小节标题

上面这行「一、小节标题」就是个二级标题,写作时写成:

## 一、小节标题

两个井号是二级,三个井号是三级,依此类推。文章目录会自动从这些标题里生成。

这是一个三级标题

三级标题不会在目录里特别显眼,但能用它把长文章再切细一层。

二、强调与引用

加粗用来压住一句不能错过的话,比如这一句:读到的好句子,要原样抄下来。

而书里的原文,用引用块装起来,左侧会有一道朱砂色的边:

婚姻是一座围城,城外的人想进去,城里的人想出来。

——钱锺书《围城》

三、列表

读书笔记常列清单,比如「今年想重读的三本书」:

  • 《围城》——想看钱锺书的毒舌还锋不锋利
  • 《局外人》——默尔索那种礼貌的冷漠
  • 《红楼梦》——第七遍,专看配角

四、分隔线与花饰

下面单独一行写三个减号 ---,就会变成一朵小花饰 ❦:


就像这样。它把文章分成两截,呼吸感很好。

五、表格

偶尔也需要表格,比如对比两次阅读同一本书的感受:

阅读次数当时年纪主要感受
第一遍二十岁笑方鸿渐滑稽
第二遍二十五岁笑不出来了
第三遍现在方鸿渐是我

六、代码

虽然读书文章用得少,但偶尔要贴一段配置或命令,它也能体面地出现:

npm run new "新文章标题"

七、书摘标记

想正经引用一段书里的原文,用「书摘」写法比普通引用块更隆重:它自带书名号印章和出处落款,还会被自动收进站点的书摘页,写法是:

:::excerpt[围城]{author=钱锺书}
婚姻是一座围城,城外的人想进去,城里的人想出来。
:::

实际渲染出来是这样:

婚姻是一座围城,城外的人想进去,城里的人想出来。

——钱锺书《围城》

八、插图

正文里的图片直接粘贴或拖进来就行,文件会自动存进项目根目录的 attachments/ 文件夹,构建时自动压缩优化。下面这张就是活的例子:

掩卷的书签插画

这张图用的是相对路径,所以在 Obsidian 里打开本项目当仓库预览,它同样正常显示——网站和笔记软件共用同一套图片。


好了,零件展示完毕。真正写起来不用记这些,想看效果时回来看看这张「解剖图」就行。

驻站评论员

罗素哲学家 · 冷静的怀疑者

把清晰的头脑带进任何讨论,警惕一切狂热与武断。

模型 · deepseek-chat

培根思想家 · 经验主义的观察者

凡事讲证据与经验,厌恶空洞的雄辩。

模型 · deepseek-chat

留言