publish-x-article

Convert Markdown to HTML and insert images deterministically for X Articles drafts.

339|58|Updated Jan 10, 2026

Search Tags:#markdown #publish #draft #Twitter #rich-text #X Articles #image-insertion

Ready to run

npx skills add https://github.com/Heyvhuang/ship-faster --skill publish-x-article

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: publish-x-article
Source: https://github.com/Heyvhuang/ship-faster/tree/main/skills/publish-x-article
Command: npx skills add https://github.com/Heyvhuang/ship-faster --skill publish-x-article

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Pillow, pyobjc-framework-Cocoa, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies publishing Markdown content to X Articles by creating a draft post with fully formatted HTML, while managing images deterministically and ensuring no automatic publishing.

Core Features & Use Cases

Markdown → X Articles rich text (HTML) for paste into the article editor.
Deterministic image handling: first image becomes the cover; subsequent images inserted at exact block positions.
Draft-only workflow: ensures the user reviews and publishes manually to avoid unintended posts.

Quick Start

Use the provided scripts to convert a Markdown file to HTML and copy it to the clipboard, then paste into X Articles editor to create a draft.

Frequently Asked Questions about publish-x-article

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I publish Markdown to X Articles as a draft?▼

To publish Markdown to X Articles as a draft, this Skill converts Markdown to HTML and copies it to the clipboard for pasting into the editor. It requires macOS clipboard access and browser automation to ensure content remains a manual review draft.

How does deterministic image insertion work when publishing to X Articles?▼

Deterministic image insertion assigns the first image as the cover and places subsequent images at exact block positions during Markdown to HTML conversion. This prevents layout shifts when pasting rich text into the X Articles editor.

Do I need macOS and Python to convert Markdown for Twitter X Articles?▼

Yes, converting Markdown for X Articles requires macOS clipboard access via pyobjc-framework-Cocoa and Python 3.9+ with Pillow. Browser automation like Playwright MCP is also needed to interact with the editor.

Can I automatically publish X Articles directly from Markdown?▼

No, you cannot automatically publish X Articles directly. The workflow is draft-only, converting Markdown to rich-text HTML for clipboard pasting to ensure you manually review and publish content, avoiding unintended posts.

What is the best way to preserve rich-text formatting from Markdown for X Articles?▼

The best way to preserve rich-text formatting is converting Markdown to HTML and using macOS clipboard access for pasting into the X Articles editor. This maintains block formatting and precise image positions without manual reformatting.

Why does Markdown to X Articles conversion require Pillow and pyobjc-framework-Cocoa?▼

Pillow and pyobjc-framework-Cocoa are required for deterministic image insertion and macOS clipboard access. Pillow processes images for the cover and block positions, while pyobjc-framework-Cocoa handles rich-text HTML clipboard transfer to the editor.