Obsidian 是本地优先的笔记工具,缺点是没有"分享给世界"的途径。把 vault 转成 Hugo 站点是当下最优雅的解法。

约定目录结构

~/vault/
├── 教学工作/
├── 技术笔记/
├── 生活记录/
└── index.md (vault 入口)

Hugo 配置

themes 选 hugo-theme-stack,配合 plugin "obsidian" 把 wikilink 转 markdown 链接。

# config.yaml
params:
  mainSections:
    - post
    - note
markup:
  goldmark:
    extensions:
      footnote: true
      linkify: true

同步脚本

# 一键把 vault 同步到 hugo/content/
rsync -av --delete \
  --exclude=".obsidian/" \
  --exclude=".trash/" \
  ~/vault/ ~/code/site/content/
Obsidian 用 [[wikilink]] 风格,Hugo 默认不识别。装 hugo-obsidian 插件或在 config.toml 里启用 Markdown 的 linkify。