md-to-feishu

Automates converting a local Markdown file into a Feishu (Lark) document, uploading any referenced local images along the way. It wraps the feishu-docx command-line tool, so the user only needs to supply a Markdown file path; a title is optional because the workflow extracts the first level-one heading as the title, or generates a descriptive one when no heading exists.

Execution begins by resolving the runtime environment, trying options in order and using the first that works: uvx (preferred, with a --python 3.11 flag when the default Python is older), an already-installed feishu-docx binary on Python 3.11 or newer, or, failing both, printed installation guidance for uv or pip along with the credential-configuration command. Feishu credentials are set once through feishu-docx config set with an app id and app secret.

Because feishu-docx cannot render Mermaid code blocks, the workflow pre-processes them. It scans the Markdown for fenced mermaid blocks and, when present, copies the file to a temporary sibling copy so the original is never modified, renders each diagram to PNG through the mermaid.ink API (a Mozilla User-Agent header is required, or the service returns 403), saves images with descriptive filenames, and replaces each block with a Markdown image reference. The command runs from the directory where the Markdown lives so relative image paths resolve, converting blocks to Feishu format and uploading local images with a short wait for block consistency. Afterward it deletes the temporary file and rendered PNGs, then reports the number of blocks converted, images uploaded, and the created document id. Authentication failures prompt a reminder to configure credentials.