使用 Obsidian 搭建博客：打造个性化知识分享平台

在数字化时代，搭建个人博客成为许多人分享知识、记录思考的热门选择。Obsidian 作为一款强大的知识管理工具，不仅能满足日常笔记需求，还能通过一些巧妙配置搭建出独具特色的博客。接下来，让我们详细了解如何用 Obsidian 搭建博客。

准备工作

安装 Obsidian

首先，前往 Obsidian 官网（https://obsidian.md/ ），根据自己的操作系统（Windows、MacOS 或 Linux）下载并安装 Obsidian 应用程序。安装完成后，打开 Obsidian，创建一个新的库（Vault），这个库将用于存放你所有的博客笔记内容。

注册 GitHub 账号

GitHub 是一个广泛使用的代码托管平台，我们将借助它来存储博客的文件并实现发布功能。如果还没有 GitHub 账号，前往 GitHub 官网（https://github.com/ ）进行注册，注册过程按照页面提示填写相关信息即可。

安装与配置插件

安装 GitHub Publisher 插件

1. 打开 Obsidian，点击界面左下角的设置图标，进入设置页面。

2. 在设置页面中，选择 “插件” 选项，然后点击 “社区插件” 选项卡。

3. 在搜索框中输入 “GitHub Publisher”，找到该插件后点击 “安装” 按钮进行安装。安装完成后，启用该插件。

若在社区插件市场未找到 “GitHub Publisher” 插件，可手动安装：

1. 从插件的 GitHub 页面（https://github.com/denolehov/obsidian-github-publisher ）下载最新版本的插件文件（通常为一个压缩包）。

2. 在 Obsidian 中，进入 “设置”>“插件”，点击 “安装本地插件”，选择刚才下载的压缩包进行导入安装。

配置 GitHub 仓库

1. 登录 GitHub 账号，在 GitHub 上创建一个新的仓库，用于存放博客笔记的网页形式。仓库名称可以自定义，例如 “my - blog - content”。创建仓库时，可根据需要选择是否初始化仓库（如添加 README 文件等）。

2. 生成一个 Personal Access Token，用于授权 Obsidian 的 GitHub Publisher 插件访问 GitHub 仓库。在 GitHub 页面右上角，点击头像，选择 “Settings”。

3. 在左侧菜单中选择 “Developer settings”，然后选择 “Personal access tokens”。

4. 点击 “Generate new token (classic)”，在弹出的页面中，为 Token 设置一个描述（如 “Obsidian blog access”），并选择合适的权限，至少需要勾选 “repo” 权限，以确保插件能够对仓库进行读写操作。设置好有效期后，点击 “Generate token” 生成 Token。生成后，务必妥善保管该 Token，它只会显示一次，后续若忘记则需重新生成。

插件设置

1. 回到 Obsidian，打开 GitHub Publisher 插件的设置界面。在设置中，填入你的 GitHub 用户名、刚才创建的仓库名、仓库分支（通常为 main 或 master）以及之前生成的 Personal Access Token。

2. 点击 “测试连接” 按钮，确保配置正确无误。若连接成功，说明插件已与 GitHub 仓库成功建立联系。

发布笔记

笔记元数据设置

在需要发布的笔记中，在笔记开头的元数据区域（即两个 “---” 之间）添加 “share: true”，表明该笔记准备发布。例如：

---
title: 我的第一篇博客文章
description: 这是我用Obsidian搭建博客发布的第一篇文章
date: 2025-01-01
share: true
---

这里除了 “share: true”，还可以添加如标题（title）、描述（description）、日期（date）、标签（tags）等元数据，这些元数据有助于更好地管理和展示博客文章。

触发发布

1. 使用命令面板：在 Obsidian 中，按下快捷键（通常为 Ctrl + P 或 Cmd + P）调出命令面板，在命令面板中输入 “GitHub Publisher: Upload single current active note”，选择该命令，即可发布当前正在编辑的笔记。

2. 使用菜单：也可以通过菜单操作，点击 Obsidian 界面左上角的文件菜单，选择 “GitHub Publisher”>“Upload single current active note” 来发布当前笔记。

发布成功后，在 GitHub 仓库中会看到对应的笔记文件已上传，并且可以通过仓库的设置和相关工具将其生成为网页形式，实现博客文章的在线展示。

进阶优化与个性化

自动化发布

利用 Obsidian 的模板系统，创建一个博客文章模板。在模板中预先设置好分享设置（share: true）以及其他常用的元数据字段。这样，每次创建新的博客笔记时，基于该模板创建，就能自动配置好分享设置，提高发布效率。

1. 在 Obsidian 库中创建一个专门用于存放模板的文件夹，例如 “templates”。

2. 在 “templates” 文件夹中创建一个新的笔记文件，如 “blog - post - template.md”，在该文件中编写模板内容，示例如下：

---
title: {{title}}
description: 
date: {{date}}
share: true
tags: 
---
# {{title}}
在这里开始撰写博客文章内容...

3. 设置模板快捷插入方式：在 Obsidian 设置中，找到 “Templates” 选项，设置模板文件夹路径为刚才创建的 “templates” 文件夹。然后可以设置一个快捷键，方便在创建新笔记时快速插入模板，例如设置为 Ctrl + Alt + T（具体快捷键可根据个人习惯设置）。这样，每次创建新博客笔记时，按下设置的快捷键，选择 “blog - post - template” 模板，即可快速生成一个包含基本设置的博客文章框架。

版本控制

GitHub 本身具有强大的版本控制功能，通过 Obsidian 与 GitHub 的结合，我们的博客笔记不仅实现了在线存储，还能方便地进行版本回溯。当对某篇笔记进行多次修改并发布后，如果需要查看或恢复到之前的某个版本，可以在 GitHub 仓库中找到对应的文件，点击文件历史记录（History），即可查看该文件的所有版本记录，选择需要的版本进行恢复或查看。

内容优化

1. 结合 Obsidian Linter 插件：安装 “Obsidian Linter” 插件，它可以帮助检查笔记中的 Markdown 语法错误、格式规范等问题，确保博客文章的质量。安装启用后，在设置中可以配置各种检查规则，例如检查链接是否有效、标题格式是否统一等。运行插件检查后，会在 Obsidian 界面中显示出检查结果，提示需要修改的地方，方便及时优化文章内容。

2. 使用 Image Converter 插件：如果博客中包含大量图片，为了优化图片的加载速度和存储空间，可以使用 “Image Converter” 插件。该插件能够将图片转换为更适合网络传输的格式（如 WebP 格式），同时还可以对图片进行压缩处理，在不影响图片质量的前提下减小图片文件大小。安装插件后，在设置中配置好转换格式和压缩参数，然后选择需要处理的图片文件或文件夹，使用插件提供的命令进行图片转换和压缩操作。

个性化定制

1. 自定义元数据：除了常用的标题、描述、日期、标签等元数据，还可以根据个人博客的风格和需求，自定义其他元数据字段。例如，可以添加 “author” 字段用于指定文章作者（如果有多作者情况），或者添加 “series” 字段用于表示文章所属的系列主题等。在笔记的元数据区域直接添加自定义字段及其值即可，如 “author: John Doe”“series: Technology”。同时，在后续生成博客页面时，可以通过相关配置或主题设置，让这些自定义元数据在合适的位置展示出来。

2. 选择合适的主题：Obsidian 有丰富的主题可供选择，可以根据个人喜好和博客定位选择合适的主题来美化博客页面。在 Obsidian 设置的 “Appearance” 选项中，点击 “Manage themes”，在社区主题库中浏览各种主题效果，选择喜欢的主题进行安装和启用。部分主题还支持进一步的自定义设置，如颜色、字体、布局等，可以根据需求进行个性化调整，使博客页面更加独特。