一个从 Markdown 笔记生成目录、正文页和搜索索引的静态网站。
开始前准备
先把材料准备好,再让 Codex 动手。缺少真实内容时先留空,不要让它替你编造。
- 准备三到十篇不含隐私的 Markdown 副本
- 确定标题、日期和标签写法
- 保留原始笔记目录不变
第一版只做这些
这一轮只完成最小可用版本。下面四项全部完成以后,再考虑增加功能。
- 自动生成目录和正文页
- 标题、代码块、图片和链接可读
- 搜索标题与正文
- 重新生成不会破坏原笔记
跟着完成一次
不要一次把全部要求扔给 Codex。按顺序完成,每一步都先看结果,再继续下一步。
- 01
只读检查 Markdown 写法、图片引用和元数据差异。
- 02
定义输入目录、输出目录和生成规则。
- 03
先用三篇样例实现解析、目录、正文和搜索。
- 04
补充坏链接、重名 slug 和缺失标题处理。
- 05
重新生成两次并确认输出稳定、源文件未改变。
复制给 Codex 的完整任务
把方括号中的内容替换成你自己的真实材料,再复制给 Codex。
请把【Markdown 笔记副本目录】转换成一个静态网站。先只读盘点文件、标题、日期、标签、内部链接和图片引用,列出不一致与隐私风险,不要修改源笔记。确认规则后,在独立输出目录实现目录页、正文页、标题与正文搜索、代码块、图片和上一页下一页;遇到缺失标题、重复网址或坏链接时给出清楚报告。所有依赖安装在项目目录。完成后连续生成两次,确认结果稳定,检查源目录未改变,并在桌面和手机浏览代表页面。
Skill 怎么参与
Skill 只是帮助你加快某一步,不是完成项目的前提。没有安装,也可以让 Codex 按同样的目标继续做。
用于识别 Markdown 层级、来源和格式差异。
用于建立长文阅读宽度、目录和移动端排版。
用于导航、搜索、坏链接和响应式验收。
第一版完成以后
确认第一版可以使用,再复制下面这段升级任务。不要在基础功能还没跑通时提前增加。
请在现有笔记网站增加标签页、最近更新和 RSS,但不增加登录、评论或数据库。先定义日期来源和稳定网址规则,再实现;检查旧链接保持有效、无日期笔记有明确表现、RSS 中不泄漏草稿或私密目录。
常见偏差
- 直接修改唯一的原始笔记来适配生成器。
- 把草稿、隐私内容或本机绝对路径一起导出。
完成检查
- 源笔记目录没有被修改。
- 重复生成得到稳定网址。
- 坏链接和重名会明确报告。
- 搜索、代码块和图片在手机端可用。