这篇样例用于检查技术文章的排版。它包含常见的内容类型，并给后续的 Obsidian 转换提供一份公开测试材料。

一、整理文章

给文章一个清楚的标题和固定的文件名。修改标题时保持文件名不变，已有链接就不会轻易失效。

文章属性

title: 我的第一篇技术笔记
pubDate: 2026-09-08
categories:
  - 技术笔记
draft: false

draft 控制文章是否进入正式构建。它与插件用于选择上传的 share 是两件事，需要在发布配置中分别处理。

保持固定链接

文件名是文章的稳定标识。例如 technical-writing-sample 不随标题修改变化。第四级标题用于细分说明，目录也应保留这一层级。

二、执行构建

下面是一个 JavaScript 示例，展示如何把步骤组织成明确的返回值。

function describeRelease({ title, version, files }) {
  return {
    title,
    version,
    fileCount: files.length,
    ready: files.length > 0,
  }
}

const release = describeRelease({
  title: '一篇技术笔记',
  version: 'preview-01',
  files: ['index.html', 'styles.css'],
})

console.log(release)

长行与长代码

下面的长行用于检查手机上的换行和完整复制；复制后应该保留原始文本。

release-artifact: technical-writing-sample--immutable-static-assets--verified-build--image-and-search-index--rollback-ready--2026-09-08
01. 选择公开文章
02. 核对文章属性
03. 检查附件范围
04. 导出 Markdown
05. 校验内部链接
06. 排除草稿与私有引用
07. 生成静态页面
08. 构建搜索索引
09. 检查订阅源
10. 保留构建产物
11. 上传候选版本
12. 检查页面与图片
13. 切换正式版本
14. 记录回退目标
15. 复核公开页面
16. 完成本次发布

对比各个环节

环节	输入	输出
写作	观察与实验	Markdown 笔记
转换	选定的文章和附件	网站内容文件
构建	内容、主题和配置	静态网页
部署	验证后的发布包	可访问的网站

窄屏上的宽表格可以独立横向滚动，也可以聚焦表格后用方向键查看。

检查项	桌面浏览器	手机浏览器	键盘操作	页面切换后
文章目录	侧栏展示	可折叠	Tab 与 Enter 定位	切换为当前文章目录
图片预览	点击放大	点击放大	Enter 打开、Escape 关闭	重新绑定一次
搜索	标题、分类与正文	同一索引	输入后 Enter	可重复进入

三、用图片补充说明

图片应当有替代文字；外链下载应说明文件内容，让读者知道点击后会得到什么。

可以阅读 Astro 文档，或下载发布流程示意图（SVG）。

四、检查结果

• 首页能够找到新文章。
• 代码、表格和图片在窄屏上仍然可读。
• 页面中的链接指向预期内容。
• 草稿不会出现在正式站点或订阅源中。

提示与折叠

展开检查发布前置条件

确认构建成功，再核对目标目录与回退版本。

• DNS、证书与缓存分别验证。
• 上传成功并不等于公开页面可用。

默认展开的例子

在不引入私人文章的情况下，使用合成样例验证表现。

普通引用保留原来的排版，不会被当作 Callout。

继续阅读

回到首页，阅读为什么开始写技术博客，再返回这篇文章，检查目录、代码复制、图片和折叠提示是否仍然可用。