Markdown 一键转飞书精美文档

通过 OpenClaw 将 Markdown 高效转换为格式精美的飞书 Docx，支持智能追加/替换模式，自动处理标题、列表、代码块等复杂排版，是团队协作文档标准化的专业工具。

基本信息

• 技能名称?Feishu Docx PowerWrite
• 中文名称?Markdown 一键转飞书精美文档
• 作者?xiongjjlj
• 分类?专业技能
• 版本?0.1.0
• 标签?feishu, lark, docx, markdown, document-automation, openclaw, collaboration, api-integration

使用方法

使用说明
核心用法
Feishu Docx PowerWrite 是一个专注于飞书文档高质量输出的自动化技能，通过 feishu_docx_write_markdown 工具实现 Markdown 到飞书 Docx 的精准转换。
工作流程

1. 获取文档标识 ：从飞书文档 URL 中提取 document_id （即 docx/ 后的字符串）
2. 选择写入模式 ：
3. 编写 Markdown ：使用标准 Markdown 语法，工具自动转换为飞书原生格式
   Append 模式（推荐） ：在现有内容下方追加，适合会议纪要、日报等增量场景
   Replace 模式 ：全文档覆盖，需显式确认，适用于从零生成完整文档
   格式支持
   层级结构 ： # 一级标题、 ## 二级标题、 ### 三级标题
   列表系统 ：无序列表（ - ）、有序列表（ 1) ）及嵌套组合
   代码块 ：围栏代码块自动识别语言类型
   分隔线与强调 ：水平线（ --- ）、粗体（ ** ）等基础排版
   显著优点
   | 优势 | 说明 | |------|------| | 结构保真 | Markdown 的层级关系完整映射为飞书文档块结构，告别纯文本粘贴的混乱排版 | | 双模式灵活 | Append 模式安全增量，Replace 模式支持全量重构，覆盖完整使用场景 | | 批量友好 | 支持单次 300-600 行的内容块写入，适合自动化日报/周报生成 | | 原生渲染 | 输出为飞书官方 Docx 格式，兼容性最佳，支持后续人工编辑 | 潜在局限
   依赖 OpenClaw 平台 ：需配合 OpenClaw 的 Feishu OpenAPI 工具链使用，无法独立运行
   格式边界 ：复杂表格、高级嵌入块（如图表、思维导图）需飞书端二次处理
   权限前置 ：用户需预先配置 Feishu 应用凭证（app_id/app_secret）及 docx:document:write 等权限范围
   无实时预览 ：Markdown 侧无法直接可视化最终飞书效果，需写入后查验
   适合人群
   技术团队 ：需要将代码文档、API 说明、部署指南同步至飞书知识库
   项目经理 ：自动化生成会议纪要、项目周报、进度追踪文档
   运营人员 ：批量产出标准化活动文案、产品更新日志
   DevOps/SRE ：将系统状态报告、告警汇总自动归档至协作平台
   常规风险
   | 风险类型 | 描述 | 缓解措施 | |----------|------|----------| | 误覆盖数据 | Replace 模式会清空原文档全部内容 | 强制要求 confirm: true 参数，建议先备份或使用 Append | | 权限泄露 | 硬编码 token 或文档链接可能导致凭证暴露 | 技能内置安全约束：禁止在代码中硬写敏感信息，强制使用用户自有凭证 | | 超长内容截断 | 单次写入过量内容可能触发 API 限制 | 建议分块处理，单批控制在 600 行以内 | | 格式解析偏差 | 非标准 Markdown 语法可能渲染异常 | 遵循推荐模板结构，避免嵌套过深的复杂列表 |