用 Obsidian 管理博客正文

如果你平时在 Obsidian 里写文章，那么最自然的发布方式不是把正文复制进 JSON， 而是直接把 .md 文件放进博客项目里。

推荐流程

1. 在 Obsidian 中完成写作
2. 补充文章头部元数据
3. 将文件复制到 posts/ 目录
4. 启动 Flask 预览页面

你也可以在文章里直接链接到另一篇笔记，比如 历史， 或者使用别名链接 查看历史文章。

为什么这样更好

• 正文不会被 JSON 转义污染
• 代码块和标题结构更清晰
• 更接近写作者本身的工作方式
• 后续扩展图片、表格和标签也更方便

Front Matter 示例

---
title: 文章标题
slug: article-slug
date: 2026-03-08
category: 技术
tags:
  - Obsidian
  - Markdown
description: 一句话摘要
---

当前兼容策略

目前博客会优先读取 posts/ 目录中的 Markdown 文件， 同时继续兼容旧的 posts.json，方便你渐进迁移已有文章。

Obsidian 扩展语法

• 文章名 会尝试跳转到对应文章页
• 显示文字 会使用自定义显示文字
• ![图片](/MyBlog/post-assets/%E5%9B%BE%E7%89%87.png) 会读取 posts/assets/图片.png

如果你要把旧的 JSON 文章迁移成 Markdown，也可以运行：

python scripts/migrate_json_posts.py