第 1 步：把网站内容文件夹变成 Obsidian 的“仓库”（只做这一次）

  1. Obsidian 打开后，如果看到的是欢迎界面，点 「打开本地仓库 / Open folder as vault」（如果已经进了某个仓库，点左下角的仓库图标 → 「管理仓库」→「打开其他仓库」）

  2. 在弹出的文件夹选择窗口里，按 Cmd + Shift + G，粘贴这个路径后回车：

    plain

    复制

    /Users/chengyifan/Documents/kimi/workspace/personal-site/src/content

  3. 点「打开」，如果问「是否信任作者」点 信任

✅ 这时左侧文件列表应该能看到两个文件夹：pages 和 wiki。

第 2 步：认识这个“仓库”

  • wiki/随笔/创刊词.md —— 就是网站上的 https://yifan-review.vercel.app/wiki/随笔/创刊词

  • wiki/项目/ 里的三个文件 —— 是收录三个网站的链接卡片

  • pages/about.md —— 关于页

  • 规律：文件在哪层文件夹，网址就是哪层路径。 你以后在 wiki/ 下新建任何文件夹（比如「读书笔记」），里面写的 md 会自动变成 yifan-review.vercel.app/wiki/读书笔记/文章名

第 3 步：写下你的第一篇（改创刊词练手）

  1. 左侧点 wiki → 随笔 → 双击 创刊词.md

  2. 文件最上面两条横线 --- 之间叫“头信息”，控制标题、日期、配图。把它改成你自己的内容，比如：

    markdown

    复制

    ---
title: 创刊词
type: note
date: 2026-08-04
cover: corot-mortefontaine
tags: [随想]
---

这里写正文，想写什么写什么。
空一行就是新段落。

  3. cover: 是配图，可选的 id 有 7 个（写在头信息里就行）： monet-sunrise（日出·印象）、monet-lilies（睡莲）、vangogh-starry（星夜）、vangogh-almond（杏花）、seurat-jatte（大碗岛）、corot-mortefontaine（孟特芳丹）、cezanne-montagne（圣维克多山）

  4. 写完按 Cmd + S 保存（Obsidian 其实也会自动保存）

第 4 步：发布

  1. 打开 访达（Finder），按 Cmd + Shift + G，粘贴：

    plain

    复制

    /Users/chengyifan/Documents/kimi/workspace/personal-site

  2. 双击里面的 publish.command

    • 如果 macOS 弹出“无法打开，因为来自身份不明的开发者”：右键点它 → 「打开」→ 再点「打开」

  3. 会跳出一个黑色终端窗口，显示 ✓ 已推送，约 30 秒后上线，随便按个键关掉它