手绘语法示例：把文章写成一本手帐

展示胶带便签、重点框、旁注、灵感卡、引用卡、清单、时间线、链接卡、相册、提醒、代码卡和分隔贴。

一、为什么要给文章加手帐语法

普通 Markdown 很适合写技术笔记，但你的站点是手绘风博客，文章里需要一些更像纸张、便签、批注和手帐的表达方式。

这是一张贴在纸上的临时想法：文章不只是排版，它也可以像一页真实手帐。

重点

真实接口优先，静态数据只作为开发兜底。这个规则适合写在重点框里反复提醒自己。

旁注适合放补充解释，比如这个功能现在由后台写文章页面渲染并保存 HTML，前台直接展示保存后的内容。

不要只追求功能完成，要让页面像真的可以长期使用。
—— elik

写作流程

FastAPI 示例

@app.get("/health")
def health():
    return {"ok": True}

普通代码块也仍然支持：

const theme = "handdrawn";
console.log(`elik article theme: ${theme}`);

结尾

写文章时，你可以从工具栏的「手帐块」下拉菜单插入这些块，也可以直接手写 ::: 语法。

它把表达形式统一到文章语法里，后续维护只需要改渲染规则。

更多手帐组件

已校对

结

今日小结

把这一节的结论单独收起来，像写在夹页上的小纸条。

项目完成度72%

推荐指数 ★★★★★

书

Naval Ravikant

纳瓦尔宝典

长期主义不是口号，是选择之后反复执行。

这个方案真正解决了什么问题？

它把表达形式统一到文章语法里，后续维护只需要改渲染规则。

展开看实现细节

这里可以放更长的解释、补充材料或剧透内容。折叠块适合不想一开始就打断阅读节奏的内容。

图片很多的时候，不要一股脑铺满页面，可以先收进一面图片墙里。读者想看细节时再展开，展开后每张图仍然可以点击放大。