用途:把本地 Markdown 文件转换为飞书文档,并自动上传 Markdown 中引用的本地图片。
主要能力:用户只需提供 Markdown 文件路径,标题可选(未提供时自动读取第一个 # 标题,若无则根据内容生成简洁标题)。工具会转换 Markdown 块、自动上传本地图片,并在上传前等待约 10 秒以保证块一致性。由于 feishu-docx 无法处理 Mermaid 代码块,流程会先把 ```mermaid 块通过 mermaid.ink API 渲染为 PNG,再替换为图片引用,之后上传。渲染时请求必须带 User-Agent 头,否则 mermaid.ink 返回 403。
使用方式:按顺序检查运行环境,优先使用 uvx: uvx feishu-docx create "<TITLE>" -f <MARKDOWN_FILE_PATH> 若 uvx 使用 Python < 3.11,追加 --python 3.11。 若已安装 feishu-docx 且 Python >= 3.11,可运行: feishu-docx create "<TITLE>" -f <MARKDOWN_FILE_PATH> 两者都不可用时提示用户安装。使用前需配置飞书凭证: feishu-docx config set --app-id <APP_ID> --app-secret <APP_SECRET> 命令需在 Markdown 文件所在目录运行,以保证相对图片路径正确解析。
适用场景:需要把本地 Markdown(含图片、含 Mermaid 图表)发布到飞书文档的自动化流程。
限制:feishu-docx 要求 Python >= 3.11,且必须预先配置飞书应用凭证,否则会报认证错误;Mermaid 渲染依赖 mermaid.ink 网络接口。若创建了临时文件与渲染图片,流程结束后会删除临时 Markdown(*.feishu-tmp.md)和生成的 Mermaid PNG。