新建、预览与发布文章
从第一份私人草稿开始，在本机预览，再决定公开全文、只公开开头或仅供站主阅读。
新建草稿
在模板根目录运行以下命令。如果已经使用过 first-note，请换一个全库唯一的 ID。
pnpm new article first-note工具生成 knowledge/articles/first-note/index.md，初始状态为 private/draft，不进入公开列表。
文章字段
下面是一份可以使用的完整源文件。日期是示例编写日；创建自己的文章时换成实际日期。
---id: first-notetype: articletitle: 我的第一篇记录date: '2026-11-06'status: draftvisibility: privatesummary: 记录一次具体问题，以及我怎样找到答案。category: 学习记录tags: [学习, 实践]cover: code---## 我遇到了什么先用自己的话说明问题，再补上过程、依据和下一步。title 是页面主标题，summary 帮助列表中的读者选择文章。正文建议从 ## 开始。id 决定永久链接，不跟随标题变化；本例的地址是 /articles/first-note/。
category 填一个分类，tags 可填多个标签。cover 可填预设名，也可填放在 public/art/covers/ 下的公开图片文件名。正文配图和下载附件放在文章文件旁，用相对路径引用。
在本机阅读私人草稿
先停止已启动的开发服务，再在 PowerShell 中执行：
$env:CLARISLET_DRAFTS='1'pnpm dev打开终端地址，再访问 /articles/first-note/。你应该看到自己的标题和正文，以及页头的本机草稿提示。保存文件后等待重新编译，刷新检查修改。
结束时 Ctrl+C，执行 Remove-Item Env:CLARISLET_DRAFTS。这是本机开发预览，草稿不会写进正式 dist。
可下载本文附带的写作检查表。正文里的图片和链接写法见 Markdown 排版与代码示例。
选择公开范围
status: draft 留给本机预览。正式构建只收录 status: ready 且日期不晚于构建当天（UTC）的文章。准备好后，再用 visibility 决定读者能看到多少。
| 公开范围 | 匿名读者看到什么 |
|---|---|
public |
全文和正文引用的附件 |
preview |
标题、简介等公开信息，以及 ratio 允许的正文开头 |
private |
公开列表、计数和搜索均无此条目 |
只有 preview 需要填写 ratio，取值从 0 到小于 1。0 只显示公开信息。0.05 和 0.1 按可见文字预算保留完整的开头段落或其他内容块，实际显示量取决于块长。可以打开阅读练习（10% 预览示例）看页面效果。标题、摘要和标签应当先确认可以公开。公开页面只携带可见正文所引用的附件。
可选站主模式允许站主登录后阅读已发布的私人内容和预览全文。真实私人稿件应放在私人仓库或仓库外的内容目录。公开 Git 仓库里的 Markdown 可以被直接阅读。
检查并发布
若要公开第一篇文章，把 first-note 改为 status: ready 和 visibility: public。核对标题、摘要、图片替代文字和下载链接，再生成正式产物。
pnpm checkpnpm buildpnpm preview在预览地址打开文章列表和 /articles/first-note/，确认发布结果。部署到托管服务前，按构建、部署与更新的检查表走一遍。
按专题顺序继续阅读