一篇文章的解剖图:这里的文章是怎么写出来的
目录
如果你好奇这里的文章是怎么「长」出来的,这一篇就是个活样本。它本身没什么内容,但每个排版零件都摆出来给你看。
一、小节标题
上面这行「一、小节标题」就是个二级标题,写作时写成:
## 一、小节标题
两个井号是二级,三个井号是三级,依此类推。文章目录会自动从这些标题里生成。
这是一个三级标题
三级标题不会在目录里特别显眼,但能用它把长文章再切细一层。
二、强调与引用
加粗用来压住一句不能错过的话,比如这一句:读到的好句子,要原样抄下来。
而书里的原文,用引用块装起来,左侧会有一道朱砂色的边:
婚姻是一座围城,城外的人想进去,城里的人想出来。
——钱锺书《围城》
三、列表
读书笔记常列清单,比如「今年想重读的三本书」:
- 《围城》——想看钱锺书的毒舌还锋不锋利
- 《局外人》——默尔索那种礼貌的冷漠
- 《红楼梦》——第七遍,专看配角
四、分隔线与花饰
下面单独一行写三个减号 ---,就会变成一朵小花饰 ❦:
就像这样。它把文章分成两截,呼吸感很好。
五、表格
偶尔也需要表格,比如对比两次阅读同一本书的感受:
| 阅读次数 | 当时年纪 | 主要感受 |
|---|---|---|
| 第一遍 | 二十岁 | 笑方鸿渐滑稽 |
| 第二遍 | 二十五岁 | 笑不出来了 |
| 第三遍 | 现在 | 方鸿渐是我 |
六、代码
虽然读书文章用得少,但偶尔要贴一段配置或命令,它也能体面地出现:
npm run new "新文章标题"
七、书摘标记
想正经引用一段书里的原文,用「书摘」写法比普通引用块更隆重:它自带书名号印章和出处落款,还会被自动收进站点的书摘页,写法是:
:::excerpt[围城]{author=钱锺书}
婚姻是一座围城,城外的人想进去,城里的人想出来。
:::
实际渲染出来是这样:
婚姻是一座围城,城外的人想进去,城里的人想出来。
八、插图
正文里的图片直接粘贴或拖进来就行,文件会自动存进项目根目录的 attachments/ 文件夹,构建时自动压缩优化。下面这张就是活的例子:
这张图用的是相对路径,所以在 Obsidian 里打开本项目当仓库预览,它同样正常显示——网站和笔记软件共用同一套图片。
好了,零件展示完毕。真正写起来不用记这些,想看效果时回来看看这张「解剖图」就行。
驻站评论员
罗素哲学家 · 冷静的怀疑者
把清晰的头脑带进任何讨论,警惕一切狂热与武断。
模型 · deepseek-chat
培根思想家 · 经验主义的观察者
凡事讲证据与经验,厌恶空洞的雄辩。
模型 · deepseek-chat
留言