Publish Markdown to X Articles from your AI assistant

For extension 1.4.0 and newer · September 2026

With the x-md-paste skill installed, you can tell Claude Code, Codex or a similar AI assistant "post this to X as an article". It serves that Markdown file and its images locally, for a moment, to the X Article Markdown Paste extension in your browser, which creates a draft, renders the formatting and uploads the images. You get a draft; publishing is still your call on X.

What you need

• The browser extension, 1.4.0 or newer, from the Chrome Web Store or Edge Add-ons, with x.com signed in in that browser.
• Node.js 20 or newer. The skill's script uses only Node's built-in modules; nothing to npm install.
• An AI assistant that reads skills, such as Claude Code.

Install option 1: let your AI assistant do it (recommended)

Send this to your AI assistant. It works on any OS and with any assistant. The extension popup's "Copy install prompt" button copies exactly this.

Please install the "x-md-paste" skill, which turns a local Markdown file into an X Article draft:
1. Download these two files:
   https://xmdpaste.icy-cat.com/skill/SKILL.md
   https://xmdpaste.icy-cat.com/skill/xmdpaste.mjs
2. Put them in a folder named x-md-paste inside your skills directory (for Claude Code: ~/.claude/skills/x-md-paste/; other tools: their own skills directory). Keep the file names.
3. Check that Node.js 20 or newer is installed; tell me if it is not.
4. Read SKILL.md. When I say "post this to X as an article", follow it.
Requires the X Article Markdown Paste extension 1.4.0+ in the browser, signed in to x.com. Guide: https://xmdpaste.icy-cat.com/skill.html

Install option 2: one command

macOS / Linux, in a terminal:

curl -fsSL https://xmdpaste.icy-cat.com/skill.sh | sh

Windows, in PowerShell:

irm https://xmdpaste.icy-cat.com/skill.ps1 | iex

Both only write two files into ~/.claude/skills/x-md-paste/ (on Windows, %USERPROFILE%\.claude\skills\x-md-paste\) and touch nothing else. You can read skill.sh or skill.ps1 first.

Install option 3: by hand

Download SKILL.md and xmdpaste.mjs into a folder named x-md-paste inside your skills directory, keeping the file names.

Using it

Open or mention a .md file in your AI assistant and say "post this to X as an article". Then:

1. The script finds a browser with the extension and opens the X Articles editor there.
2. The extension picks up the document, creates a draft, renders headings, lists, code blocks, tables and tweet embeds, and uploads the images.
3. If the article has images, a cover dialog appears: pick one or choose no cover.
4. Review the draft and publish it on X when you are happy with it.

Obsidian notes are served from the vault root automatically, so ![[attachments/pic.png]] links resolve. Relative, absolute and Windows paths all work, as long as the images are inside that root.

Several browsers installed?

The script checks every profile of Chrome, Edge, Brave, Arc, Chromium and Vivaldi and prefers a new-enough copy in your default browser. To choose, ask your assistant to add --browser edge or --profile "Profile 2". The document is handed over only once, so you never get a draft in two browsers.

Troubleshooting

• The command says "nobody picked the document up" and exits: no usable extension answered. It lists every copy it found and why; usually the version is below 1.4.0, the extension is disabled or in another profile, or x.com is not signed in.
• X shows "already picked up": the same link was opened twice. Ask your assistant to run it again.
• "the local tool is not running any more": the script exited after going idle, usually because an old link was opened. Run it again.
• Some images failed to upload: the image is outside the root, missing, or over the free plan's per-paste image limit.
• The X page stays blank: X's own page did not load. Reload x.com and run it again.

Updating and removing

Update by running the install command or prompt again; it overwrites the two files. Remove it by deleting the x-md-paste folder.