If neither uvx nor feishu-docx is found, tell the user:
feishu-docx requires Python >= 3.11. Install with one of:
# Recommended: install uv, then run directly without global install
curl -LsSf https://astral.sh/uv/install.sh | sh
uvx feishu-docx create "Title" -f file.md
# Or: install globally with pip (Python >= 3.11 required)
pip install feishu-docx
Feishu credentials must be configured first:
feishu-docx config set --app-id <APP_ID> --app-secret <APP_SECRET>
Then stop and wait for the user to set up the environment.
Step 3: Pre-process Mermaid Blocks
The feishu-docx tool cannot handle Mermaid code blocks. Before uploading, check if the Markdown contains any ````mermaid` blocks and convert them to images first.
3a: Scan for Mermaid blocks
Read the Markdown file and check if it contains any ````mermaid` fenced code blocks. If none are found, skip to Step 4.
3b: Create a temporary copy
Copy the original Markdown file to a temp file in the same directory (so relative image paths still work):
<original-name>.feishu-tmp.md
For example: blog_post.md → blog_post.feishu-tmp.md
All subsequent modifications happen on this temp copy. The original file is never modified.
3c: Render Mermaid diagrams to PNG
For each mermaid ... block in the temp file, render it to a PNG image using the mermaid.ink API:
import base64, urllib.request
def render_mermaid(code: str, output_path: str):
"""Render a Mermaid diagram to PNG via mermaid.ink API."""
encoded = base64.urlsafe_b64encode(code.encode()).decode()
url = f"https://mermaid.ink/img/{encoded}?bgColor=white"
req = urllib.request.Request(url, headers={"User-Agent": "Mozilla/5.0"})
resp = urllib.request.urlopen(req, timeout=30)
with open(output_path, "wb") as f:
f.write(resp.read())
Important: The User-Agent header is required — mermaid.ink returns 403 without it.
Save rendered images to the same directory as the Markdown file, using descriptive filenames based on diagram content:
