Hexo Markdown 静态文章站发布方案

当前站点采用 Hexo + Apple-inspired 自定义主题 作为静态文章站方案，完整知识处理管线见 AI 可视化知识库。，目标是替代 Ghost / Notion，回到更简单、可版本化、可自动化的 Markdown 工作流。

目标

• 内容以 .md 文件保存；
• 文章源码进入 GitHub 仓库；
• 构建产物为纯静态 HTML/CSS/JS；
• 发布目录固定为 /opt/1panel/www/sites/zizai.cc/index；
• 前台访问域名为 https://zizai.cc/；
• 主题选型偏漂亮文章站，而不是传统后台 CMS。

技术栈

层级	方案
内容源	Markdown 文件
静态生成器	Hexo
主题	Apple-inspired 自定义 Hexo 主题
源码仓库	https://github.com/AYO-NET/Blog.git
静态托管	1Panel OpenResty
发布目标	/opt/1panel/www/sites/zizai.cc/index

发布流程

以后所有需要生成的 Markdown 文件，都必须按顺序执行：

1. 先生成文件：在 /opt/blog/source/_posts/ 或对应页面目录中创建 .md；
2. 然后发布到网站：执行 npm run publish，将 Hexo 构建产物同步到 /opt/1panel/www/sites/zizai.cc/index；
3. 再推送到 GitHub：提交源码、配置与发布记录到 AYO-NET/Blog.git。

本地目录约定

/opt/blog/
  _config.yml
  _config.stellar.yml
  package.json
  source/
    _posts/
      *.md
    about/
      index.md
  scripts/
    publish.sh
  public/                  # Hexo 构建输出，不提交 Git

为什么不用 Ghost / Notion

Ghost 更适合博客 CMS，但主题和内容模型会限制知识文章站的视觉与结构。Notion 适合协作编辑，但对纯 Markdown、Git 版本化和服务器侧自动构建来说不是必要依赖。

Hexo 的优势是：

• Markdown 即内容源；
• Git 即版本历史；
• 静态 HTML 即发布物；
• 没有数据库和后台运行时；
• 适合用脚本自动化。

后续增强方向

• 增加 GitHub Webhook 自动发布；
• 增加文章模板脚本；
• 增加分类规范；
• 接入搜索索引优化；
• 持续完善 Apple-inspired 视觉系统，使其更贴近自在知识库的品牌风格。