Publish Markdown articles to X as drafts

Publish Markdown article to X as a draft

Creators publishing long-form content to X Articles without losing formatting or manually rebuilding the article in the UI.

• · Markdown file (article_md_path)
• · Optional: run_dir for output artifacts

• · X Articles draft (user publishes manually)
• · Parsed structure JSON
• · HTML body for rich text paste

• · Playwright MCP (browser automation)
• · X account with Articles permission (Premium/Premium Plus)
• · Python 3.9+ (Pillow, pyobjc for clipboard)
• · macOS recommended (clipboard helper uses Cocoa)

• · User logged into X before automation starts
• · X account has Articles feature enabled

• · Auto-publish blocked; draft-only for user control (safety guard)
• · Clipboard helper fails on non-macOS; requires manual text paste
• · First image becomes cover; subsequent images placed inline; order matters
• · Markdown syntax errors → parsing may fail or render incorrectly

• · Hard rule: draft-only, user must publish manually (safety via transparency)
• · First image = cover image rule; deterministic image insertion
• · Bundled parse_markdown.py and copy_to_clipboard.py scripts
• · Outputs: JSON structure, HTML body, optional .md record in /05-final/
• · Runbook reference for step-by-step guidance