说明
笔记一直都很分散,一部分Hexo,一部分Obsdian中,还有些零零散散的.正好这次 Kratos-Rebirth升级到3.0就顺便来构思整合.
目标
- 使用 Obsidian 作为唯一写作与知识管理入口
- 使用 Hexo 作为静态博客生成器
- 使用 Gitea Action 实现自动化构建与部署
- 降低重复维护成本，避免内容分散
原则
- 内容分层
并非所有 Obsidian 文档都适合发布Hexo,我采用目录进行区分2者. - 最小侵入化Hexo
尽量不破坏 Hexo 原有结构,仅对_posts的来源进行替换.
目录结构设计
在 Hexo 项目根目录下，引入 Obsidian Vault：
hexo-project
├── _config.yml
├── package-lock.json
├── package.json
├── README.md
├── source
│ ├── _posts/ # Hexo 实际读取目录（最终由 vault/blog 链接而来）
│ └── ...
├── vault/ # Obsidian Vault（唯一内容源）
│ ├── blog/ # 可发布到 Hexo 的文章
│ ├── notes/ # 个人笔记 / 草稿 / 不公开内容
│ ├── assets/ # 图片、附件等
│ ├── .obsidian/
│ └── .makemd
├── .gitea
│ └── workflows
整合步骤
1.在 Hexo 项目下创建 Vault 目录
在 Hexo 项目根目录中创建 vault
该目录将作为 Obsidian 的 Vault 根目录
2.迁移 Obsidian 原有内容
将原 Obsidian Vault 中的 全部内容 迁入 hexo-project/vault，包括：
- 普通 Markdown 文件
.obsidian/配置目录.makemd（如果你使用 Make.md 插件）- 图片、附件等资源
obsidian-old-vault/* → hexo-project/vault/
完成后：
- 直接用 Obsidian 打开
hexo-project/vault - 确认插件、主题、快捷键配置是否正常
3. 整合 Hexo 原有文章到 Vault
在 vault 下创建一个专门用于博客发布的目录blog
然后将 Hexo 原 _posts 中的内容迁移进去：
注意事项：
- 保留原有 Markdown 文件的 Front Matter（
title、date、tags等） - 如存在资源引用，建议统一迁移到
vault/assets
4. 融合 Obsidian 与 Hexo 文档体系
内容分类建议:
- 放入
**vault/blog/**的内容：- 技术博客
- 系列教程
- 可长期维护的文章
- 保留在其他目录的内容：
- 临时笔记
- 会议记录
- TODO / 草稿 / 私有内容
5. 用 Vault 的 blog 替换 Hexo 的 _posts
当内容整理完成后：
- 删除
Hexo原有的_posts目录 - 将
vault/blog以 软链接（推荐） 或 硬链接 的方式映射为_posts
Gitea Action 自动化思路
也没什么好说的,原来Hexo如何部署现在就如何,就是需要注意过滤文件
依然采用Hexo的git管理,在.gitignore中排出obsidian中不适合同步目录文件
# Obsidian noisy / device-specific
vault/.obsidian/cache/
vault/.obsidian/workspace-mobile.json
vault/.obsidian/workspace.json
vault/.obsidian/workspaces.json
vault/.obsidian/*.log
# Plugin/UI state
vault/.space/
vault/.makemd/
推荐Obsdian插件
File Explorer++
用于过滤文件目录显示
QuickAdd
快速通过模版创建文档导入文件头信息
Terminal
打开终端执行hexo预览
Git
每次写完文档便于同步数据到git库或者部署
Markdownlint
过滤一些语法报错