Obsidian

开始你的笔记吧！

npx quartz create

Obsidian-Plugins

Self-Hosted-Quartz-Deploy

在线发布方案

很好，你的思路其实已经非常清晰了，我详细帮你设计下完整的体系：

📌 目标总结

你的 Obsidian 笔记使用 [[notes|笔记标题]] 这样的 wiki-style 内部链接。
你希望把笔记整理成静态网站，部署在自己的服务器，Nginx 反向代理，且链接跳转能正确指向。
你希望未来维护方便，尽量自动化。

📌 推荐的工具链

方案核心

环节	工具推荐	说明
笔记管理	Obsidian	你已有
静态站点生成器	Quartz 4 / Obsidian Digital Garden / Docusaurus + Obsidian Export 插件 / Astro	能直接兼容 Obsidian 链接
内部链接解析	内置支持（如 Quartz）或使用 `obsidian-export` 工具进行转换	确保 `[[xxx]]` 被正确渲染成网页跳转
Web 服务	Nginx	你已有
自动部署	GitHub Actions / rsync / scp / Docker	自动构建+部署到服务器

📌 核心难点：Wiki 链接解析

Obsidian 的 [[notes|标题]] 是私有语法，大多数静态站生成器不直接支持。
你需要一个能把这种链接正确转成标准 HTML <a href="/路径"> 语法的工具。

我推荐几个成熟方案：

方案一：Quartz 4 (最推荐，适合 Obsidian 用户)

基于 Hugo，支持 Obsidian 格式几乎原生。
Wiki-style link 支持非常好。
有自动生成 MOC（索引页）能力。
自带主题美观，移动端也不错。
官方地址：
👉 https://quartz.jzhao.xyz/

部署流程（简化版）：

# 安装 Hugo
brew install hugo
 
# 拉取 Quartz 模板
git clone https://github.com/jackyzha0/quartz quartz-site
 
# 复制你的 Obsidian 笔记进 content 目录
cp -r /path/to/obsidian-vault quartz-site/content
 
# 本地预览
cd quartz-site
hugo serve
 
# 生成静态页面
hugo
 
# 将 public 目录同步到服务器
rsync -avz public/ user@your-server:/var/www/your-site/

然后 Nginx 反代即可。

方案二：Obsidian Digital Garden 插件

完全针对 Obsidian 用户设计，支持双向链接、标签、MOC。
可以发布成公开或私有 garden。
支持自托管（最适合你这种用 Nginx 的方案）

参考：
👉 https://github.com/oleeskild/obsidian-digital-garden

方案三：Obsidian Export + Astro + 自定义渲染

如果你希望高度定制（例如和你之前 Astro 知识库整合）：

使用 obsidian-export CLI 工具，把 Obsidian Vault 导出为普通 Markdown，同时解析好 [[wikilink]]。
再用 Astro + Markdown 插件渲染为静态网页。
Astro 对 Markdown+Frontmatter 兼容性极好，未来扩展性最好。

参考：

# 安装 obsidian-export
npm install -g obsidian-export
 
# 导出
obsidian-export /path/to/obsidian-vault /path/to/output

然后用 Astro 读取 /path/to/output 目录。

📌 Nginx 反代配置示例

假设你把静态页面放在 /var/www/wiki/

server {
    listen 80;
    server_name wiki.luoxingding.com;
 
    root /var/www/wiki;
    index index.html;
 
    location / {
        try_files $uri $uri/ =404;
    }
}

如果要启用 HTTPS，结合你已有的 acme.sh SSL 证书即可。

📌 未来可升级方向

自动化构建部署（用 GitHub Actions 每次 push 自动部署）
支持全文搜索（Meilisearch + FlexSearch）
支持版本控制（与 Git 完美融合）
支持访问控制（Obsidian Digital Garden 支持加密）
多主题切换（Quartz 支持）

📌 小结建议

你希望	推荐方案
快速上线、稳定好用	Quartz 4
紧密绑定 Obsidian，支持发布	Obsidian Digital Garden
强定制化、未来扩展性强	Obsidian Export + Astro

👉 要不要我直接给你生成一个完整的 Quartz 或 Digital Garden 模板仓库？
👉 我还可以顺便帮你写好 Nginx 配置和部署脚本。

—— 只要你点头，我立即给你打包好完整可部署环境。

🪴 Notes Shared

探索

Obsidian 笔记