文件与内容v4 内容审稿模式

把 Markdown 笔记变成网站

扫描一个笔记目录,自动生成目录、正文页面和搜索,让旧笔记更容易查找。

完成后得到
一个可以继续添加笔记并反复生成的个人网站
难度与用时
进阶一点 · 1 天
项目形式
Markdown · 静态网站
查看 12 个项目 当前:把 Markdown 笔记变成网站
这次要交付什么

一个从 Markdown 笔记生成目录、正文页和搜索索引的静态网站。

开始前准备

先把材料准备好,再让 Codex 动手。缺少真实内容时先留空,不要让它替你编造。

  • 准备三到十篇不含隐私的 Markdown 副本
  • 确定标题、日期和标签写法
  • 保留原始笔记目录不变

第一版只做这些

这一轮只完成最小可用版本。下面四项全部完成以后,再考虑增加功能。

  • 自动生成目录和正文页
  • 标题、代码块、图片和链接可读
  • 搜索标题与正文
  • 重新生成不会破坏原笔记

跟着完成一次

不要一次把全部要求扔给 Codex。按顺序完成,每一步都先看结果,再继续下一步。

  1. 01

    只读检查 Markdown 写法、图片引用和元数据差异。

  2. 02

    定义输入目录、输出目录和生成规则。

  3. 03

    先用三篇样例实现解析、目录、正文和搜索。

  4. 04

    补充坏链接、重名 slug 和缺失标题处理。

  5. 05

    重新生成两次并确认输出稳定、源文件未改变。

复制给 Codex 的完整任务

把方括号中的内容替换成你自己的真实材料,再复制给 Codex。

项目开工提示词

请把【Markdown 笔记副本目录】转换成一个静态网站。先只读盘点文件、标题、日期、标签、内部链接和图片引用,列出不一致与隐私风险,不要修改源笔记。确认规则后,在独立输出目录实现目录页、正文页、标题与正文搜索、代码块、图片和上一页下一页;遇到缺失标题、重复网址或坏链接时给出清楚报告。所有依赖安装在项目目录。完成后连续生成两次,确认结果稳定,检查源目录未改变,并在桌面和手机浏览代表页面。

Skill 怎么参与

Skill 只是帮助你加快某一步,不是完成项目的前提。没有安装,也可以让 Codex 按同样的目标继续做。

Documents

用于识别 Markdown 层级、来源和格式差异。

Impeccable

用于建立长文阅读宽度、目录和移动端排版。

Browser / Playwright

用于导航、搜索、坏链接和响应式验收。

第一版完成以后

确认第一版可以使用,再复制下面这段升级任务。不要在基础功能还没跑通时提前增加。

项目升级提示词

请在现有笔记网站增加标签页、最近更新和 RSS,但不增加登录、评论或数据库。先定义日期来源和稳定网址规则,再实现;检查旧链接保持有效、无日期笔记有明确表现、RSS 中不泄漏草稿或私密目录。

常见偏差

  • 直接修改唯一的原始笔记来适配生成器。
  • 把草稿、隐私内容或本机绝对路径一起导出。

完成检查

  • 源笔记目录没有被修改。
  • 重复生成得到稳定网址。
  • 坏链接和重名会明确报告。
  • 搜索、代码块和图片在手机端可用。