Obsidian+爱库录：笔记变博客的完整工作流
title: "Obsidian + 爱库录：笔记变博客的完整工作流" date: 2026-09-17 tags: [Obsidian, 工作流, 教程, 笔记管理] category: 使用教程 description: "完整的端到端教程。从 Obsidian 笔记到博客发布，包括目录设计、同步方案、发布流程。"
Obsidian + 爱库录：笔记变博客的完整工作流
这篇教程面向 Obsidian 用户。如果你已经在用 Obsidian 做知识管理，这套工作流让你不需要切换工具就能发布博客。
核心思路
Obsidian vault（私人知识库）
↓ 挑选想发布的文章
博客/ 目录（发布区）
↓ 爱库录自动入库
博客前台（公开站点）
笔记和博客共享同一套 Markdown 文件。 不需要复制、不需要转换格式、不需要登录另一个系统。
第 1 步：设计目录结构
在你的 Obsidian vault 里，创建一个「博客」目录：
my-vault/
├── 日常笔记/
├── 项目笔记/
├── 读书笔记/
├── 资源/
└── 博客/ ← 发布区
├── 关于/
├── 技术/
├── 读书/
└── 生活/
「博客」目录就是你对外发布的空间。 其他目录是私人笔记，不会出现在博客上。
分类怎么设计
建议按内容类型分，不要按时间分：
# ✅ 好的分类
博客/
├── 技术/ ← 有持续产出的领域
├── 读书/ ← 有持续产出的领域
└── 生活/ ← 偶尔写写
# ❌ 不好的分类
博客/
├── 2026年/
├── 2025年/ ← 时间分类没有意义，读者不关心你什么时候写的
└── 随笔/ ← 太模糊，不知道里面有什么
第 2 步：配置同步
把 Obsidian vault 里的「博客」目录同步到爱库录服务器。
方案一：rsync（推荐）
最简单、最可靠：
# 本地 → 服务器（每次写完新文章后执行）
rsync -avz ~/my-vault/博客/ user@server:/opt/aiklog/blog/
# 可以写成脚本，绑定快捷键
#!/bin/bash
rsync -avz ~/my-vault/博客/ user@server:/opt/aiklog/blog/
echo "同步完成！"
方案二：Git
适合需要版本管理的场景：
# 在 vault 里初始化 Git
cd ~/my-vault
git init
echo ".obsidian/" >> .gitignore
echo "日常笔记/" >> .gitignore # 私人笔记不同步
git add 博客/
git commit -m "update blog"
git remote add origin git@server:blog.git
git push
服务器端用 post-receive hook 自动同步到博客目录：
# /opt/aiklog/git-hooks/post-receive
#!/bin/bash
GIT_WORK_TREE=/opt/aiklog/blog git checkout -f
方案三：Obsidian Git 插件
安装 Obsidian Git 插件，配置自动提交和推送：
Obsidian → 设置 → Obsidian Git
├── Auto pull interval: 10 分钟
├── Auto push interval: 10 分钟
├── Pull on startup: 开启
└── Push on backup: 开启
写完文章，等 10 分钟自动推送到服务器。 完全自动。
方案四：软链接（同一台机器）
如果 Obsidian 和爱库录在同一台机器上：
# 直接软链接，不需要同步
ln -s ~/my-vault/博客 /opt/aiklog/blog
零延迟。 保存文件，博客即时更新。
第 3 步：写作和发布
日常写作
在 Obsidian 里正常写笔记。所有笔记都在私人空间。
决定发布
写完一篇觉得值得分享的笔记：
-
在 Obsidian 里把文件移动到「博客」目录
- 右键 → 移动到 → 博客/技术/
- 或者拖拽到「博客」目录
-
检查 frontmatter：
---
title: "文章标题" # 必须有
date: 2026-09-17 # 必须有
tags: [标签1, 标签2] # 可选，AI 也会自动提取
description: "摘要" # 可选，AI 会自动生成
---
-
等同步完成（rsync/Git/插件自动处理）
-
刷新博客前台，文章已经出现了
双链的处理
Obsidian 的 [[wiki link]] 在爱库录里继续有效。
但要注意：双链只能引用博客目录内的文章。如果你引用了私人笔记：
关于这个话题的更多思考，见 [[日常笔记/某个想法]]。
这个链接在博客前台会断开。发布前检查双链引用是否都在博客目录内。
附件处理
图片和附件需要同步到服务器：
# rsync 同步附件
rsync -avz ~/my-vault/attachments/ user@server:/opt/aiklog/blog/attachments/
在 Obsidian 里用相对路径引用：
第 4 步：日常维护
添加新文章
Obsidian 写作 → 移动到博客目录 → 自动同步 → 自动发布
修改已发布文章
Obsidian 里直接编辑 → 自动同步 → 自动更新
下线文章
从博客目录移回私人笔记目录 → 自动同步 → 自动下线
备份
# 服务器端备份
rsync -avz user@server:/opt/aiklog/blog/ /backup/blog/
rsync -avz user@server:/opt/aiklog/data/ /backup/data/
# Obsidian vault 本身就是备份（本地文件 + Git 历史）
完整流程图
┌─────────────────────────────────────────┐
│ Obsidian vault │
│ │
│ 日常笔记 ──→ 项目笔记 ──→ 读书笔记 │
│ │ │
│ 想发布的文章 │
│ │ │
│ 移动到博客目录 │
└────────────────────┬────────────────────┘
│
rsync / Git / 软链接
│
▼
┌─────────────────────────────────────────┐
│ 爱库录博客目录 │
│ │
│ 技术/ ── Go并发模式.md │
│ ── Docker多阶段构建.md │
│ 读书/ ── 认知觉醒读书笔记.md │
│ │
│ 自动入库：摘要/标签/向量/索引 │
└────────────────────┬────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ 博客前台（公开） │
│ │
│ 技术/ │
│ ├── Go 并发模式实战笔记 │
│ └── Docker 多阶段构建实战 │
│ 读书/ │
│ └── 读完《认知觉醒》的 7 条笔记 │
└─────────────────────────────────────────┘
常见问题
Q：Obsidian 的插件（Dataview、Templater 等）在博客上能用吗？ A：不能。博客前台只支持标准 Markdown。插件生成的内容在 Obsidian 里是渲染后的，同步到博客的是原始 Markdown。
Q：文章里的图片怎么处理？ A：图片需要和文章一起同步到服务器。建议用相对路径引用，附件目录放在博客目录下。
Q：可以只同步部分笔记吗？ A：可以。只把想发布的文章放进「博客」目录，其他笔记留在私人空间。
相关：
[[拖个文件进目录，就是发布了一篇博客]]|[[用文件管理器管理博客]]