开始使用Gridea

  1. 我修改了Gridea站点源文件夹的存储位置,将默认位置改到iCloud 上,让它向obsidian 一样可以在多端进行编辑
  2. 我在思考一个问题;gridea和obsidian这2个软件都是支持md语法的,工作上如何将这两个app结合起来使用,提高工作效率

核心逻辑:
Obsidian(生产车间): 利用其强大的编辑体验、双链、插件、大纲功能来撰写和管理草稿。
Gridea(发布中心): 利用其现成的静态站生成能力、主题渲染、以及同步功能来发布内容。
由于你现在已经把 Gridea 的源文件放在了 iCloud,这就为两者的结合提供了天然的便利。以下是具体如何打通这两个 App 的“任督二脉”:

方案一:“寄生”模式(最推荐,无缝衔接)

在这个方案中,我们将 Gridea 的源文件夹直接作为一个 Obsidian 的仓库(Vault),或者作为你现有 Obsidian 仓库的一个子文件夹。

  1. 设置连接
    不要把 Gridea 和 Obsidian 当作两个无关的软件。
    打开 Obsidian。
    点击“打开仓库文件夹” (Open folder as vault)。
    直接选择你 iCloud 里的 Gridea-Blog 文件夹。

  2. 理解目录结构
    在 Obsidian 里打开后,你会看到几个文件夹,最核心的是这两个:
    posts:这里存放所有的文章 .md 源文件。
    post-images(或 images):存放文章图片。

    方案二:双库模式(最推荐,安全且高效)
    Obsidian 支持同时打开多个仓库(Vault)。你可以把 Gridea 的文件夹作为一个独立的仓库打开。
    操作方法:
    打开 Obsidian,点击左下角的仓库图标。
    点击“打开文件夹作为仓库”,选择你的 Gridea-Blog 文件夹。
    此时,你的 Obsidian 会有两个独立的窗口:
    窗口 1: 你的私密/财务笔记库。
    窗口 2: Gridea 博客库。

优点:
绝对物理隔离: 两个库互不相通,你的财务数据绝对不会误触跑到博客里。
配置独立: 你可以在博客库里安装专门写文章用的插件(如文章排版),而不影响主库。
图片自动管理: 在窗口 2 里拖入图片,图片会自动存入 Gridea 的文件夹,不需要手动搬运。
工作流: 想写博客时,切换到窗口 2 写 -> 写完保存 -> 打开 Gridea 点击同步。

  1. 核心工作流
    以后写文章,你不再需要打开 Gridea 的编辑器,而是:
    在 Obsidian 里新建笔记: 确保文件保存在 posts 目录下。
    必须添加 Front Matter (YAML 头): Gridea 识别文章元数据(标题、时间、标签、URL)是靠文件最顶部的 YAML 区域。你需要在 Obsidian 笔记的最开头手动(或用模板)加入这段内容:

YAML


title: '这里写文章标题'
date: 2025-12-09 16:00:00
tags: [标签1, 标签2]
published: true
hideInList: false
feature:
isTop: false

(注:如果不加这个头,Gridea 打开时可能只显示文件名,需要你手动在 Gridea 里再配置一遍信息)

撰写正文: 尽情使用 Obsidian 的功能写作。

发布:

写完后,保存(Obsidian 是自动保存)。

打开 Gridea 客户端。

Gridea 会自动检测到文件变动。

点击 Gridea 左侧的文章列表,检查一下标题和摘要是否正常。

点击 “同步” 按钮。

方案二:进阶技巧(利用 Obsidian 插件提效)
为了让上面那个流程更顺滑,强烈建议在 Obsidian 里做两个优化:

  1. 配置“图片附件”路径
    Gridea 默认把图片存在 post-images 文件夹,且引用格式通常是相对路径或绝对路径。

在 Obsidian 设置 -> 文件与链接 (Files & Links)。

附件文件夹路径 (Default location for new attachments):改为 指定文件夹 -> 选择 post-images。

这样你在 Obsidian 里直接粘贴截图,图片会自动存到 Gridea 能识别的地方。

  1. 使用 Templater 插件自动生成 YAML 头
    每次手动复制粘贴上面的 YAML 头很麻烦。

在 Obsidian 安装 Templater 插件。

新建一个模板文件 Gridea_Post.md,内容如下:

Markdown


title: '<% tp.file.title %>'
date: <% tp.date.now("YYYY-MM-DD HH:mm:ss") %>
tags: []
published: true
hideInList: false
feature:
isTop: false

以后新建文章时,按一下快捷键调用这个模板,它会自动填好当前的标题和时间,你只需要填标签即可。

⚠️ 潜在的“坑”与规避
尽管两者都用 MD,但它们的逻辑有细微差别,请注意以下两点:

Gridea 的 db.json 是核心: Gridea 不仅仅读取 .md 文件,它还维护一个 db.json 数据库。

如果你在 Obsidian 里删除了一篇文章,Gridea 打开时可能还会显示那篇文章(但会报错找不到文件)。

正确做法: 只是修改内容和新建文章时,用 Obsidian 很爽。但如果要删除文章或修改文章的文件名(URL Slug),建议直接在 Gridea 客户端里操作,这样数据库同步最稳。

图片引用格式: Obsidian 默认喜欢用 ![[图片.png]] 这种双链格式。 Gridea(以及大多数网页)只支持标准的 Markdown 格式

解决: 在 Obsidian 设置 -> 文件与链接 -> 把 “使用 Wiki 链接 (Use Wiki links)” 关掉。这样 Obsidian 就会自动生成标准 Markdown 链接,Gridea 就能完美识别了。

总结
Obsidian 负责“生”(内容创作),Gridea 负责“养”(管理配置)和“嫁”(发布上线)。

通过 iCloud 文件夹把它们“物理连接”在一起,配合 Obsidian 的模板插件,你会发现写博客的效率会从“繁琐的操作”变成“享受写作流”。