← 返回文章列表



非程序员也能搞定:用 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: truedg-home: true(首页专用),然后用命令面板执行"Publish Active Note",完成。

💡 小技巧:在 Obsidian 根目录下建一个专门的文件夹(比如 my_garden)来存放要发布的内容,图片统一放在 my_garden/assets/ 里,不会把整个笔记库弄乱。

我踩过的三个坑,帮你省掉

坑一:导航链接路径搞错了

Digital Garden 发布后的 URL 格式是 /my_garden/文件名,不是 /文件名,也不是 /notes/文件名。我来回折腾了好久才搞清楚。方法是:先发布一篇文章,点击看实际 URL,然后按这个格式写导航链接。

坑二:图片不显示

图片要放在发布文件夹内(比如 my_garden/assets/),而且建议文件名用英文,中文文件名在 URL 里会被编码成乱码,容易出问题。

坑三:文件发布了但页面显示"nothing here"

检查 frontmatter 里的 dg-publish: true 是否正确,冒号后面要有空格,而且必须是小写的 true。写成 True 或者 TRUE 都不行。

⚠️ 注意:中文文件名可以用,但导航链接里要用 URL 编码,比较麻烦。建议导航页面(posts、about、projects)用英文命名,普通文章用中文没问题。

如果你也想试,从这里开始

第一步:今天下载安装 Obsidian,感受一下这个工具,不用管数字花园的事,先用它记两天笔记。

第二步:注册 GitHub 账号,建一个名为 my_garden 的仓库,先放在那里不用动。

第三步:安装 Digital Garden 插件,按插件说明页的 setup guide 一步步配置,遇到问题就截图问 AI。

本周挑战:把你的第一篇笔记发布出去,哪怕只有一句话也算。网址有了,后面的内容可以慢慢填。

我从零开始到网站上线大概花了两天时间,中间遇到了不少问题,但每一个都解决了。你也可以。

你现在看到的这个数字花园,就是最好的证明。

每周更多这样的探索


AI小白马

加入我的
AI 学习成长日志

    每周更新,我的实战与学习经验,陪你成长


    ← 返回文章列表