xpub

Convert Markdown to X Articles-ready output. Tables are automatically converted to styled PNG images since X Articles doesn't support HTML tables.

Install

npm install -g @metatransformer/xpub

Or run locally:

git clone https://github.com/Metatransformer/xpub.git
cd xpub
npm install
npm run build
npm link

Usage

# Open preview in browser (Cmd+A, Cmd+C to copy)
xpub article.md

# Copy rich text directly to clipboard (macOS)
xpub article.md --clipboard

# Output raw HTML
xpub article.md --html

# Save table images to specific directory
xpub article.md --images-dir ./out

# Add a cover image
xpub article.md --cover hero.jpg

What it does

1. Parses your Markdown file
2. Converts tables to styled PNG images (dark theme)
3. Applies syntax highlighting to code blocks
4. Generates a preview page you can open in your browser
5. Select all → Copy → Paste into X's Article editor

Why?

X Articles supports rich text but not HTML tables. This tool renders tables as images so your data-heavy articles look perfect on X.

License

MIT © Metatransformer LLC