我最近做了一个小工具：

👉 linkdown

起因

在 Obsidian 里，我习惯这样写：

[[跑步训练]]

[牛奶燕麦粥](@/recipes/milk-oatmeal.md)

很轻松。

不用关心路径，只关心内容之间的关系。

但一旦把笔记发布到博客（我用的是 Zola），问题就来了：

[[...]] 并不是标准 Markdown。

你必须写成：

[标题](路径)

这就多了一层心智负担。

linkdown 在做什么

linkdown 很简单，只做一件事：

👉 把 [[wikilink]] 转成标准 Markdown 链接

例如：

[[跑步训练]]

[牛奶燕麦粥](@/recipes/milk-oatmeal.md)

会变成：

[跑步训练](../running)

[牛奶燕麦粥](../food/oatmeal)

同时，它也顺手解决了一些实际问题：

  • 自动补全 front matter（比如 title）
  • 文件重命名（例如把中文转成拼音 slug）

我的使用方式

写作阶段：

  • 全部使用 [[...]]
  • 文件名就是标题
  • 不关心路径，也不写博客专用属性

发布阶段（通过 GitHub Actions）：

  1. 用文件名补全 front matter
  2. 生成符合 URL 的 slug（重命名文件）
  3. 把 wikilink 转换成 Markdown 链接

处理完成后，再同步到博客仓库。

为什么要做这个

写作时，我只想专注一件事：

👉 内容之间的连接

至于路径、文件名、结构——

这些都应该是“发布阶段的问题”。

项目地址

如果你也有类似需求，可以看看这个小工具：

👉 https://github.com/wjianbo/linkdown

代码不多，思路也很简单。