feishu-create-doc
创建飞书云文档。从 Lark-flavored Markdown 内容创建新的飞书云文档,支持指定创建位置(文件夹/知识库/知识空间)。
By larksuite · 366 installs
npx skills add larksuite/openclaw-lark --skill feishu-create-doc
Source repository · Upstream listing
feishu mcp create doc
通过 MCP 调用 create doc ,从 Lark flavored Markdown 内容创建一个新的飞书云文档。
返回值
工具成功执行后,返回一个 JSON 对象,包含以下字段:
doc id (string):文档的唯一标识符(token),格式如 doxcnXXXXXXXXXXXXXXXXXXX
doc url (string):文档的访问链接,可直接在浏览器中打开,格式如 https://www.feishu.cn/docx/doxcnXXXXXXXXXXXXXXXXXXX
message (string):操作结果消息,如"文档创建成功"
参数
markdown(必填)
文档的 Markdown 内容,使用 Lark flavored Markdown 格式。
调用本工具的markdown内容应当尽量结构清晰,样式丰富, 有很高的可读性. 合理的使用callout高亮块, 分栏,表格等能力,并合理的运用插入图片与mermaid的能力,做到图文并茂..
你需要遵循以下原则:
结构清晰 :标题层级 ≤ 4 层,用 Callout 突出关键信息
视觉节奏 :用分割线、分栏、表格打破大段纯文字
图文交融 :流程和架构优先用 Mermaid/PlantUML 可视化
克制留白 :Callout 不过度、加粗只强调核心词
当用户有明确的样式,风格需求时,应当以用户的需求为准!!
重要提示 :
禁止重复标题 :markdown 内容开头不要写与 title 相同的一级标题!title 参数已经是文档标题,markdown 应直接从正文内容开始
目录 :飞书自动生成,无需手动添加
Markdown 语法必须符合 Lark flavored Markdown 规范,详见下方"内容格式"章节
创建较长的文档时,强烈建议配合update doc中的append mode, 进行分段的创建,提高成功率.
title(可选)
文档标题。
folder token(可选)
父文件夹的 token。如果不提供,文档将创建在用户的个人空间根目录。
folder token 可以从飞书文件夹 URL 中获取,格式如: https://xxx.feishu.cn/drive/folder/fldcnXXXX ,其中 fldcnXXXX 即为 folder token。
wiki node(可选)
知识库节点 token 或 URL(可选,传入则在该节点下创建文档,与 folder token 和 wiki space 互斥)
wiki node 可以从飞书知识库页面 URL 中获取,格式如: https://xxx.feishu.cn/wiki/wikcnXXXX ,其中 wikcnXXXX 即为 wiki node token。
wiki space(可选)
知识空间 ID(可选,传入则在该空间根目录下创建文档。特殊值 my library 表示用户的个人知识库。与 wiki node 和 folder token 互斥)
wiki space 可以从知识空间设置页面 URL 中获取,格式如: https://xxx.feishu.cn/wiki/settings/7448000000000009300 ,其中 7448000000000009300 即为 wiki space ID。
参数优先级 :wiki node wiki space folder token
示例
示例 1:创建简单文档
示例 2:创建到指定文件夹
示例 3:使用飞书扩展语法
使用高亮块、表格等飞书特有功能:
示例 4:创建到知识库节点下
示例 5:创建到知识空间根目录
示例 6:创建到个人知识库
内容格式
文档内容使用 Lark flavored Markdown 格式,这是标准 Markdown 的扩展版本,支持飞书文档的所有块类型和富文本格式。
通用规则
使用标准 Markdown 语法作为基础
使用自定义 XML 标签实现飞书特有功能(具体标签见各功能章节)
需要显示特殊字符时使用反斜杠转义: ~ $ [ ] < { } ^
📝 基础块类型
文本(段落)
段落对齐 :支持 {align="left center right"} 语法。可与颜色组合: {color="blue" align="center"}
标题
飞书支持 9 级标题。H1 H6 使用标准 Markdown 语法,H7 H9 使用 HTML 标签:
标题属性 :支持 {color="颜色名"} 和 {align="left center right"} 语法,可组合使用。颜色值:red, orange, yellow, green, blue, purple, gray。请谨慎使用该能力.
列表
有序列表,无序列表嵌套使用tab或者 2 空格缩进
引用块
代码块
⚠️ 只支持围栏代码块( markdown
markdown
html
<callout emoji="✅" background color="light green" border color="green"
支持 格式化 的内容,可包含多个块
</callout
html
<grid cols="2"
<column
左栏内容
</column
<column
右栏内容
</column
</grid
html
<grid cols="3"
<column width="20" 左栏(20%)</column
<column width="60" 中栏(60%)</column
<column width="20" 右栏(20%)</column
</grid
markdown
列 1 列 2 列 3
单元格 1 单元格 2 单元格 3
单元格 4 单元格 5 单元格 6
<lark table ← 表格容器
<lark tr ← 行(直接子元素只能是 lark tr)
<lark td 内容</lark td ← 单元格(直接子元素只能是 lark td)
<lark td 内容</lark td ← 每行的 lark td 数量必须相同!
</lark tr
</lark table
html
<lark td
这里写内容
</lark td
html
<lark table column widths="200,250,280" header row="true"
<lark tr
<lark td
表头1
</lark td
<lark td
表头2
</lark td
<lark td
表头3
</lark td
</lark tr
<lark tr
<lark td
普通文本
</lark td
<lark td
列表项1
列表项2
</lark td
<lark td
代码内容
</lark td
</lark tr
</lark table
html
<image url="https://example.com/image.png" width="800" height="600" align="center" caption="图片描述文字"/
html
<file url="https://example.com/document.pdf" name="文档.pdf" view type="1"/
markdown
markdown
html
<whiteboard token="xxx" align="center" width="800" height="600"/
html
<bitable view="table"/
<bitable view="kanban"/
html
<chat card id="oc xxx" align="center"/
html
<iframe url="https://example.com/survey?id=123" type="12"/
html
<link preview url="消息链接" type="message"/
html
<quote container
引用容器内容
</quote container
html
<sheet rows="5" cols="5"/
<sheet/
html
<task task id="xxx" members="ou 123, ou 456" due="2025 01 01" 任务标题</task
html
<! 源同步块:内容在子块中
<source synced align="1" 子块内容...</source synced
<! 引用同步块:自动获取源文档内容
<reference synced source block id="xxx" source document id="yyy" 源内容...</reference synced
html
<add ons component type id="blk xxx" record='{"key":"value"}'/
html
<isv id="comp xxx" type="type xxx"/
html
<wiki catalog token="wiki xxx"/
html
<sub page list wiki="wiki xxx"/
html
<agenda
<agenda item
<agenda title 议程标题</agenda title
<agenda content 议程内容</agenda content
</agenda item
</agenda
html
<jira issue id="xxx" key="PROJECT 123"/
html
<okr id="okr xxx"
<objective id="obj 1"
<kr id="kr 1"/
</objective
</okr
html
<mention user id="ou xxx"/
html
<mention doc token="doxcnXXX" type="docx" 文档标题</mention doc
html
<reminder date="2025 12 31T18:00+08:00" notify="true" user id="ou xxx"/
markdown
$$
\int {0}^{\infty} e^{ x^2} dx = \frac{\sqrt{\pi}}{2}
$$
markdown
爱因斯坦方程:$E = mc^2$(注意 $ 前后需空格,紧邻位置不能有空格)
✍️ 写作指南
场景速查
场景 推荐组件 说明
重点提示/警告 Callout 蓝色提示、黄色警告、红色危险
对比/并列展示 Grid 分栏 2 3 列最佳,配合 Callout 更醒目
数据汇总 表格 简单用 Markdown,复杂嵌套用 lark table
步骤说明 有序列表 可嵌套子步骤
时间线/版本 有序列表 + 加粗日期 或用 Mermaid timeline
代码展示 代码块 标注语言,适当添加注释
知识卡片 Callout + emoji 用于概念解释、小贴士
引用说明 引用块 引用原文、名言
术语对照 两列表格 中英文、缩写全称等
🎯 最佳实践
空行分隔 :不同块类型之间用空行分隔
转义字符 :特殊字符用 \ 转义: \ \~ \
图片 :使用 URL,系统自动下载上传
分栏 :列宽总和必须为 100
表格选择 :简单数据用 Markdown,复杂嵌套用 <lark table
提及 :@用户用 <mention user ,@文档用 <mention doc
目录 :飞书自动生成,无需手动添加
📖 补充说明
图片、画板、多维表格需要 token(URL 会自动上传转换)
提及用户和会话卡片需要相应访问权限
完全兼容标准 Markdown