Md To Feishu

Markdown to Feishu Document

Convert a local Markdown file into a Feishu document, with automatic image upload.

User Input

The user only needs to provide a Markdown file path. Title is optional — if not provided, extract it automatically (see below).

Step 1: Determine the Document Title

1. Read the Markdown file and look for the first # heading — use that as the title.
2. If no # heading exists, scan the content and generate a concise, descriptive title based on the topic.
3. If the user explicitly provides a title, use that instead.

Step 2: Check the Runtime Environment

Try each option in order. Use the first one that works.

Option A: uvx (preferred)

which uvx

If uvx is available, the run command is:

uvx feishu-docx create "<TITLE>" -f <MARKDOWN_FILE_PATH>

If uvx runs with Python < 3.11, add --python 3.11:

uvx --python 3.11 feishu-docx create "<TITLE>" -f <MARKDOWN_FILE_PATH>

Option B: feishu-docx already installed

which feishu-docx

If found, check Python version:

python3 --version

If Python >= 3.11, the run command is: