从素材库到公开页面的发布检查清单
素材库里的笔记可以粗糙,公开页面要多一道检查。
这道检查不用追求完美,主要是避免读者打开以后完全摸不到入口。
内容检查
先看内容本身:
- 标题是否清楚
- 页面是否只处理一个核心问题
- 第一屏能否说明这页在讲什么
- 是否有过时软件、旧平台、旧流程
- 是否包含私人信息
- 是否还保留太多内部口吻
如果一页内容只对自己当时有意义,先别急着发布。
结构检查
再看结构:
- 是否有小标题
- 是否有进入下一页的链接
- 是否能回到 MOC
- 是否和已有页面重复
- 是否需要拆分成多篇
- 是否只是素材,暂时放在
imports/
公开页面最好能独立阅读,也能接回知识地图。
链接检查
Obsidian 里的链接迁移到 Quartz 前,要检查:
[[wikilink]]是否能解析- 别名链接是否清楚
- 指向的页面是否已经发布
- 图片是否能访问
- 外部链接是否还有效
- 旧路径是否需要改成新路径
断链会明显影响阅读体验。
frontmatter 检查
我会统一检查:
title:
description:
date:
created:
modified:
tags:这批知识管理页面的时间统一落在 2026 年 4 月到 6 月之间,方便形成一个清晰的整理周期。
发布后检查
本地构建通过后,再打开本地预览:
npm run quartz -- build需要检查:
- 页面能否打开
- 入口页是否出现新链接
- MOC 是否更新
- 移动端阅读是否还算顺
- 是否还有明显 AI 味句式