非程序员也能搞定:用 Obsidian 建数字花园的完整过程
我不会写代码。
但你现在看到的这个网站,是我一步一步从零搭起来的。用的工具叫 Obsidian,加一个叫 Digital Garden 的插件,部署在 GitHub 和 Vercel 上,全部免费。
这篇文章记录的是我真实走过的完整过程——包括踩过的坑、卡住的地方、以及最后搞定的方法。
大多数人对"建网站"的理解是错的
一提到"建个人网站",大多数人脑子里冒出来的画面是:写代码、租服务器、配置域名、调试半天……光想想就头大。
错误认知一:建网站必须会写代码
不是的。Obsidian + Digital Garden 的组合,让你只需要写普通的 Markdown 文档,插件帮你把它变成网站。你写笔记,它发布网页,就这么简单。
错误认知二:免费的方案效果很差
GitHub 存储 + Vercel 托管,这套组合完全免费,而且速度很快,你现在看到的这个网站就是这么跑起来的。
错误认知三:一次配好就完事了
这是我自己踩过的坑。配置过程中会遇到各种小问题,比如图片路径、导航链接、URL 格式……但每个问题都有解法,一个一个解决就好。
搭好之后你能得到什么
一个真正属于你的地方
不依赖任何平台,不担心账号被封、内容被删。你的笔记在本地,代码在 GitHub,网站在 Vercel。三个地方都有备份。
写作即发布的工作流
在 Obsidian 里写完一篇笔记,加一行 dg-publish: true,点发布,两分钟后网站更新。整个流程比发微信公众号还简单。
知识会越来越值钱
数字花园最大的好处是:文章之间可以互相链接,慢慢形成一张知识网络。时间越长,内容越多,整体价值越高。这是在任何社交平台上都做不到的事。
完整搭建过程:从零开始
1安装 Obsidian 和 Digital Garden 插件
去 obsidian.md 下载安装,打开后在插件市场搜索"Digital Garden"安装。这一步很顺,10分钟搞定。
2注册 GitHub 和 Vercel 账号
GitHub 用来存储你的网站文件,Vercel 用来把文件变成可以访问的网站。两个都免费注册,用邮箱就行。
3在插件里完成三个配置
GitHub 用户名、仓库名、GitHub Token(在 GitHub 设置里生成)。配好之后插件就能把你的笔记推送到 GitHub 了。
4把 GitHub 仓库连接到 Vercel
在 Vercel 里导入你的 GitHub 仓库,选 Eleventy 框架,点部署。几分钟后你就有一个真实可访问的网址了。
5发布第一篇笔记
在 Obsidian 里新建一个文件,顶部加上 dg-publish: true 和 dg-home: true(首页专用),然后用命令面板执行"Publish Active Note",完成。
我踩过的三个坑,帮你省掉
坑一:导航链接路径搞错了
Digital Garden 发布后的 URL 格式是 /my_garden/文件名,不是 /文件名,也不是 /notes/文件名。我来回折腾了好久才搞清楚。方法是:先发布一篇文章,点击看实际 URL,然后按这个格式写导航链接。
坑二:图片不显示
图片要放在发布文件夹内(比如 my_garden/assets/),而且建议文件名用英文,中文文件名在 URL 里会被编码成乱码,容易出问题。
坑三:文件发布了但页面显示"nothing here"
检查 frontmatter 里的 dg-publish: true 是否正确,冒号后面要有空格,而且必须是小写的 true。写成 True 或者 TRUE 都不行。
如果你也想试,从这里开始
第一步:今天下载安装 Obsidian,感受一下这个工具,不用管数字花园的事,先用它记两天笔记。
第二步:注册 GitHub 账号,建一个名为 my_garden 的仓库,先放在那里不用动。
第三步:安装 Digital Garden 插件,按插件说明页的 setup guide 一步步配置,遇到问题就截图问 AI。
我从零开始到网站上线大概花了两天时间,中间遇到了不少问题,但每一个都解决了。你也可以。
你现在看到的这个数字花园,就是最好的证明。