夜雨聆风
Obsidian文档如何一键搬家到飞书?我做了个skill
我现在即在Obsidian里写笔记。 也在飞书里写文档。
两个工具都用。 但有个痛点：
Obsidian里的笔记，怎么快速发到飞书？
手动复制粘贴。 格式全乱。 代码块变普通文本。 表格消失不见。
直到我做了这个Skill。 3分钟搞定，格式完全保留。
今天分享给你。
痛点：Obsidian到飞书，为什么这么难？
先说问题。
Obsidian用的是Markdown语法。 飞书用的是自己的Block结构。
表面看都是”文字”。 但内部完全不一样。
Obsidian支持什么？
-
Markdown语法 -
代码块（支持语法高亮） -
表格 -
Mermaid流程图 -
双向链接 -
Wiki链接 -
Callout提示块
飞书支持什么？
-
富文本编辑器 -
代码块 -
表格 -
图片 -
投票/附件
核心问题：Markdown语法 ≠ 飞书语法
一个”代码块”：
const a = 1;
Obsidian能识别。 飞书不认识。
就要一个”翻译官”。
解决方案：Markdown转飞书云文档Skill
我做了一个skill。
功能：把Obsidian/Markdown文件，直接转换成飞书云文档。
效果： – 代码块 → 保留 – 表格 → 保留 – Mermaid → 转成图片 – 格式 → 全部保留
原理解析
这个Skill，核心就5步。
第1步：读取Markdown文件
用Node.js读取Obsidian里的.md文件。
const mdContent = fs.readFileSync(mdPath,'utf-8');第2步：Markdown → AST
解析成抽象语法树。
用的是 mdast-util-from-markdown 库。
{"type":"heading","depth":1,"children":[{"type":"text","value":"标题"}]}这一步很关键。 它把”文本”变成”结构化数据”。
第3步：AST → 飞书Blocks
用 feishu-markdown 库转换。
|
|
|
|---|---|
|
|
|
|
|
|
代码 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
特殊处理： – Mermaid流程图 → 用@mermaid-js渲染成图片 – Callout → 转成引用+emoji
第4步：调用飞书API
先创建空白文档：
POST /open-apis/docx/v1/documents返回文档ID。
再写入内容：
PATCH /open-apis/docx/v1/documents/{id}/blocks/batch_update第5步：返回链接
Done。 返回飞书文档URL。
效果对比
我做了实测。
测试文档
-
1500字 -
3个代码块 -
2个表格 -
1个Mermaid流程图
手动复制粘贴
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
用这个Skill
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
效率提升：5倍格式保留：100%
怎么使用？
前置条件： 1. 飞书开放平台应用（需要app_id和app_secret） 2. Node.js环境
使用方法：
# 1. 配置cp config.example.json config.json# 填入你的app_id和app_secret# 2. 运行node convert.js /path/to/your/obsidian-note.md --title"文档标题"3分钟后。 飞书云文档里就会出现一篇新文档。
拿到了skill怎么使用？很简单！
只需要打开config.json 并在对应位置填入自己的飞书凭据就可以了
还能怎么玩？
除了Obsidian。 这个Skill还能：
- Typora笔记
→ 飞书 - Notion导出
→ 飞书 - GitHub README
→ 飞书 - 任何Markdown文件
→ 飞书
一次开发。 永久使用。
文末福利
这个Skill我已经整理好了。见评论区
有帮助到你的话，一键三连呗。
有问题评论区见。
我是陈老师，帮你用AI提升10倍效率。
