个人报告分享平台方案对比

对比 PDF、原始 Markdown、手写 HTML 与静态站点方案，说明为什么静态生成 + Markdown 更适合作为首版基础设施。

TL;DR

  • 首版不该追求后台系统，而应先保证“写作成本低、打开体验好、部署足够稳”。
  • 手写 HTML 灵活，但长期维护负担过高。
  • Eleventy 兼顾了内容写作效率、样式控制能力和可移植性。

背景

搭建个人报告分享平台时，最常见的误区是过早引入复杂系统，比如 CMS、数据库或权限体系。对于个人场景，这些能力往往不是首要瓶颈。

核心发现

1. 输出形式决定分享摩擦

如果用户打开的是附件，他需要先下载、再选择查看方式；如果打开的是网页，内容本身就在链接里。这种摩擦差异会直接影响传播效率。

2. 首版更适合静态生成

静态生成站点有几个明显优点：

  • 成本低
  • 部署简单
  • 迁移到别的 agent 或新仓库时容易复制
  • 没有后台依赖

3. 内容模型要先于视觉细节稳定

先把这些字段固定下来，后面的专题页、引用卡片和合集页才容易扩展：

  • 标题
  • 摘要
  • 发布时间
  • 标签
  • slug

证据材料

一个更实际的发文流程如下：

draft -> markdown -> static build -> github pages

结论与建议

首版推荐方案：

  1. Eleventy 作为静态站点引擎
  2. Markdown 作为内容格式
  3. GitHub Pages 作为默认托管
  4. skill 目录内保留同构模板，方便迁移给其他 agent

参考资料

  • 个人知识分享站常见构建方式
  • 静态站点生成工具的长期维护经验