Skip to content
标签
博客
字数
2798 字
阅读时间
11 分钟

0元0代码0难度无需备案,专注写作,用Obsidian搭建博客的最简方案

去年6月我根据教程基于Github 搭建了一个十分简易的博客 简单到十几秒就能搭建好 (可以点击下方查看) 当时就是看中它的简易了 选择的方案是极简静态博客框架,全程仅需在GitHub点击「Fork」按钮,配合自动化脚本,15秒内即可完成初始化部署 支持基础的响应式布局,桌面端和移动端显示效果均符合预期 视觉效果还可以

但还是过于简易了 而且每次发布都提个issue也还是挺麻烦的

自那以后我也在关注其他的博客实现思路

有两种主流的实现思路 一种是国际思路 但是网络要求高 我在Vercel上尝试部署过,因为网络原因,没成功过 Vercel控制台访问不稳定,部署过程中频繁出现DNS解析失败

另一种是国内思路 网络环境好,访问也很快 但是有备案强制要求:根据《互联网信息服务管理办法》,域名需通过工信部备案,流程耗时15-30天; - 而且技术冗余度高:WordPress对静态博客场景存在「性能过剩」,后台管理界面复杂,非必要功能占比超60%

除此以外 大部分的博客功能强大,界面美观 但是搭建过程比较麻烦 涉及到很多命令行操作 有些需要魔法访问的网络环境 对很多人来说都是一道又一道坎

因此很多实现思路我在尝试过后又选择了放弃

但是今天这个路子真可以推荐大家一试

搭建过程简单,涵盖基本功能,界面美观实用 而且写博客的访问很简单 就跟在Obsidian写笔记一样

博客演示

可以通过

https://obsidiannote.netlify.app

访问查看 也可以通过我自定义的域名进行访问

https://selfbalance.top

主页

动态主题切换:支持明暗模式自动切换,基于CSS变量实现,切换过程无闪烁;

笔记界面

大纲导航系统:右侧自动生成Markdown大纲,支持点击跳转,提升长文阅读体验;

手机端体验也很不错 图片支持双指缩放,链接点击区域扩大至44px×44px,符合移动端交互规范;

支持评论

GitHub评论系统:集成Giscus组件,用户可通过GitHub账号评论,评论数据存储于GitHub Discussions,天然支持Markdown格式;

开启评论需要以下两点要求

  1. 笔记添加comment属性
  2. 完成Giscus相关配置(下面有配置方法)

简单说下实现思路

  • 基于nolebase精简后的nolebase-template博客模板进行搭建
  • 通过Obsidian完成博客笔记的撰写
  • 通过Github desktop提交更新
  • 利用Netlify部署网站页面

看似很复杂,但其实配置起来很简单 依旧是 0元!0代码!0难度! 无需备案,无需服务器 搭建自己的博客

以下是逐帧教学

简易的搭建步骤

访问以下链接

https://github.com/Jackiexiao/nolebase-template

进入Nolebase-temolate仓库

点击fork,让它成为自己的仓库

访问Netlify

https://app.netlify.com

对Netlify部署感兴趣的 可以访问以下文章进行查看

基于现有项目创建站点

选择Github,授权一下自己的账号

选择刚刚创建的nolespace-template 注意: 此处需要将Publish directory里的dist修改为==.vitepress/dist==

.vitepress/dist

注意不要有多余的空格,以及漏符号

同时此处支持给自己的项目命名 我这里的命名是==obsidiannote== 如果不命名的话 netlify会随机起个名字

然后点击Deploy开始部署

等待building成功 变绿就是部署好了

点击给出的链接即可访问

https://obsidiannote.netlify.app/

以下是模板网页的效果

没错,就是这么简单,鼠标点点的工夫 自己的博客网站就搭好了

必要的修改美化

现在,我们已经把博客网站搭建起来了

但是上面的信息,依旧是模板给出的 需要将它修改成我们自己的元素 那怎么操作呢?

为了方便同步和笔记更新 我们需要用到Github Desktop这个软件

首先访问以下链接

https://desktop.github.com/download/

下载Github desktop

下载完毕后,安装,并登录自己的Github账号

登录时网络环境有问题的可以开一下steam++

https://steampp.net/

安装并登录完成后 回到我们fork后的网站模板仓库

选择==Open with GitHub Desktop== 这时GitHub Desktop就会自动弹出来 在本地选择一个文件夹 GitHub Desktop就会自动将项目克隆到本地

点击我们设置的这个本地文件夹 可以看到项目都克隆下来了

接下来我们需要对模板网站上的一些元素进行修改 可以使用Trae或者Vscode来打开这个文件夹

https://trae.com.cn

这里我选择使用Trae 理论上用记事本打开也行,都只是做一些修改

修改 metadata/index.ts 配置一下自己的网站信息 配置网站标题、描述、作者等元数据

再修改一下 index.md 配置一下首页

可以对着模板进行修改 外观和代码是对应的

需要修改什么搜索即可 我最常用的是==搜索文本==

比较麻烦的是更换里面的图片

一个一个删除替换

[!help] 突然感觉自己公众号的logo挺朴实的 考虑今年升级一下形象

另外分享一个png转换svg的网站

https://convertio.co/zh/

接着修改一下笔记目录里的index.md 这是笔记的第一个页面

全部修改完成后 回到我们的Github Desktop

在软件右边能够详细看到修改的情况

首先点击commit, 接着点击push

回到Netlify的页面 可以看到我们提交的修改正在部署中

等待部署完成后 进入网站后可以看到效果

有点怪怪的

再简单修改一下,勉强能看了

移动端显示画面

自己又美化了一下

沉浸的撰写体验

修改模板网站上的信息为个人的信息之后

接下来我们只需专注写笔记即可

打开Obsidian

选择我们克隆过来后的==笔记==文件夹

以这个文件夹作为仓库

此时Obsidian的界面如下

把原来的删除

写博客就像和平时在Obsidian写笔记一样 但是为了顺利地将图片上传 还需要做一下简单的设置

设置图片附件

Obsidian 设置 => 文件与链接 设置如下

  • 内部链接类型 => 基于当前笔记的相对路径
  • 使用Wiki链接 => 不使用
  • 附件文件夹路径 =>当前文件所在文件夹下指定的子文件夹
  • 附件文件夹路径 => assets 这么做有几个好处
  • 保持兼容性的markdown: 可以让文档也能在 github 中被正确渲染(github无法解析[[双链]]
  • 方便迁移文件和图片,你只需要把图片文件夹和markdown文件一起复制就行(如果是全部汇总在某个文件夹下,以后复制比较麻烦)
  • 对于已有的笔记和图片链接,你可以考虑使用 obsidian 插件obsidian-link-converter 来帮你做自动的转换 [[wikilink]] 为 相对路径 的 markdown link

标题有点小问题

不知为何,一级标题不能识别 网页上不会显示一级标题 我暂时的解决方法是跳过一级标题 所有都从二级标题开始

笔记的属性

模板默认给出了几个属性

comment

需要开启评论的话,不开就false

自定义属性

支持自定义frontmatter 在index.ts中进行添加即可 比如我自己增加了一个名为==finished==的属性 类型是日期Date,用于记录我发表这篇文章的时间

方便的提交过程

提交博客和提交对网站的修改的步骤一样 Github Desktop会自动识别当前文件夹的各种变化 当你想上传的时候 点击Commit 再点击Push即可

在Netlify中可以看见 我们刚刚的更新已经Published成功了

更进一步,绑定自己的域名

博客还支持绑定个人域名

最开始项目部署时 我们的命名是obsidiannote 然后netlify给我们的链接就是

https://obsidiannote.netlify.app

还是有点长了 接下来我们把它改成我们自己的域名

可以直接在Netlify操作

也可以去cloudflare操作

https://cloudflare.com/

我习惯后者 通过Cloudflare绑定域名的,可以参考这篇文章

cloudflare的CNAME支持根域名部署

cloudflare设置完成后 回到Netlify进行设置

填写上我们的域名后 域名就增加了自定义域名

现在不仅可以通过

https://obsidiannote.netlify.app

进行访问 也可以通过我们自定义的域名进行访问

https://selfbalance.top

再进一步,开启评论功能

giscus 利用了 GitHub Discussions 实现的评论系统,让访客借助 GitHub 在你的网站上留下评论! 具体配置方法

  • 第1步,访问 Giscus 网站, 参考网站上的说明,一步步操作,最后得到一个配置代码
https://giscus.app/zh-CN
  • 第2步,在 ./vitepress/theme/index.ts 中修改 giscus 相关配置,在该文件中搜索 giscusTalk, 参考说明,修改配置即可

这样别人登录Github账号后 就能在你的文章下面评论了

总结一下

  • 静态站点生成:nolebase-template模板(VitePress + Markdown)
  • 部署平台:Netlify(免费套餐含自动HTTPS、CDN)
  • 版本控制:GitHub + GitHub Desktop
  • 域名服务:Cloudflare(免费DNS解析+CDN)
  • 评论系统:Giscus(基于GitHub Discussions)

无需深入理解Web服务器原理,即可掌握「版本控制-静态网站-自动化部署」的完整流程; 对内容创作者:专注Markdown写作,无需处理后端逻辑,在Obsidian的沉浸式编辑

「极简技术栈+最大自由度」,从点击「Fork」按钮开始,开启属于自己的博客写作之旅!

贡献者

文件历史

撰写