lark-doc_skill

Overview

This skill helps create Feishu (Lark) documents from Markdown content. It automates document creation, permission configuration, Markdown-to-block conversion, and insertion of converted blocks into the new document. The tool accepts inline Markdown or a Markdown file and returns a shareable document URL on success.

How this skill works

You supply a title and either a Markdown string or a Markdown file path. The skill creates a new Feishu document, applies the requested access and sharing permissions, converts the Markdown into Feishu document blocks, and inserts those blocks into the document. It outputs clear success or error messages including the document URL when available.

When to use it

• You need to quickly publish meeting notes, reports, or specs stored as Markdown to Feishu.
• You want consistent conversion of Markdown features (headings, tables, code blocks, images) into a Feishu doc.
• You want to create documents programmatically and control folder placement and sharing settings.
• You need to share Markdown content with teammates who prefer Feishu’s document editor.

Best practices

• Provide Markdown that follows supported elements (headings, lists, tables, code blocks, images) for best fidelity.
• Use publicly accessible image URLs so images render correctly in the document.
• Set external-access and link-share deliberately when making documents public or cross-tenant.
• Test with --debug when converting complex nested lists or large tables to inspect conversion logs.
• Keep credentials (APP_ID and APP_SECRET) only in a secure .env file as required.

Example use cases

• Generate a meeting minutes document from a quick Markdown snippet and share the URL with the team.
• Convert an existing README.md or design spec into a Feishu doc and place it in a team folder.
• Produce a public-facing guide by setting external-access=open and link-share=anyone_readable.
• Automate weekly reports by scripting Markdown export and using this skill to publish the report.