Cloudflare Pages 可托管纯 HTML 文件，需将 Output directory 设为 . 且 index.html 置于仓库根目录；留空 Build command，避免默认构建失败。

Cloudflare Pages 不能直接托管纯 HTML 文件（没构建步骤）

Cloudflare Pages 默认期望你有一个构建流程，比如 npm run build 输出到 dist 或 public 目录。如果你只是扔一个 index.html 进去，它会报错或返回 404——不是你不配，是它没找到“构建产物”。

解决办法只有一个：告诉 Cloudflare Pages “别构建了，就用这个目录当根”。

• 在项目根目录加一个 ./_redirects 文件（可选，但推荐），内容写：

  / /index.html 200

  ，避免单页应用路由 404
• 部署时，在 Cloudflare Pages 后台设置：Build command 留空，Output directory 填 .（英文句点）
• 确保你的 index.html 在 Git 仓库最顶层，不是套在 src/ 或 docs/ 里

为什么填 . 而不是 ./ 或空字符串

Cloudflare Pages 的输出目录字段对路径解析很严格：./ 会被拒绝，空字符串会触发默认构建逻辑，只有 . 才被识别为“当前目录即发布根”。这是文档里没明说、但实测唯一有效的写法。

Html2md

使用 Readability + Turndown 将 HTML 页面转换为干净的、Agent 友好的 Markdown。去除导航栏、广告、页脚、Cookie 横幅、社交按钮等干扰元素。支持 URL...

下载

• 填 public？它会找 public/index.html，但你没这目录
• 填 dist？同上，找不到就 404
• 填 ""（空）？它自动执行 npm run build，然后报错“no such script”

部署后访问 404 或显示“Project not found”

常见于三种情况：仓库权限不对、分支没选对、或者 HTML 文件名不是 index.html。

立即学习“前端免费学习笔记（深入）”；

• 确认 GitHub/GitLab 仓库是公开的，或已授权 Cloudflare 访问私有库（私有库需手动授权）
• 在 Pages 设置里检查 Branch 是否选的是你 push 了 index.html 的那个分支（通常是 main 或 master）
• index.html 必须全小写，不能叫 Index.html 或 INDEX.HTM——Cloudflare 是区分大小写的
• 如果用了自定义域名，先确认 DNS 已指向 pages.dev，且状态是 Active

想加 HTTPS 或自定义域名，但页面打不开

Cloudflare Pages 自带免费 HTTPS，但自定义域名必须走 Cloudflare DNS 才能生效。如果你把域名 DNS 指向其他服务商（比如阿里云、Namecheap），即使 CNAME 解析对了，HTTPS 也会失败，浏览器提示“证书无效”。

• 登录 Cloudflare，把域名添加为站点（哪怕只用 Pages），让它接管 DNS
• 在 Pages 项目里绑定域名时，状态变成 Active 才算真正就绪
• 如果之前绑过又解绑，等几分钟再重试——证书缓存和 CDN 配置有延迟

实际跑通的关键就两步：输出目录填 .，HTML 放对位置。其余都是围绕这两点在排障。很多人卡在“明明文件传上去了却 404”，其实只是路径没喂对。