x2md

Convert X (Twitter) post URLs into markdown text.

2|3|Updated Mar 13, 2026

Search Tags:#markdown #cli #twitter #archive #convert #tweet #x

One-click install

npx skills add https://github.com/spideynolove/claude-dotfiles --skill x2md-spideynolove

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: x2md
Source: https://github.com/spideynolove/claude-dotfiles/tree/main/.claude-global-backup/skills/x2md
Command: npx skills add https://github.com/spideynolove/claude-dotfiles --skill x2md-spideynolove

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reading, archiving, or analyzing X (Twitter) posts outside the platform is difficult because tweets are locked behind the site's interface. This Skill converts any X post URL into clean markdown so you can read, summarize, or store it anywhere. ## Core Features & Use Cases - URL to Markdown Conversion: Pass an X post URL and receive the post content as markdown printed to stdout. - File Output: Save the converted markdown directly to a file with the `--output` option for archiving or further processing. - Enhanced Media and Thread Support: Provide a Twitter API v2 bearer token via `--bearer-token` to improve handling of media attachments and threads. - Use Case: You find a long technical thread on X and want to include it in your research notes. Run the conversion, save it to a markdown file, and it becomes part of your searchable knowledge base. ## Quick Start Convert this X post to markdown and save it to a file: https://x.com/user/status/1234567890

Frequently Asked Questions about x2md

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

FAQPage Schema

How do I convert a tweet or X post to markdown?▼

Run the x2md command followed by the X post URL, and the post content is printed to stdout as markdown. Add the --output flag with a filename to save the result directly to a file instead.

How to save an X post as a markdown file?▼

Use the --output option followed by a target filename, for example x2md <url> --output post.md. The converted markdown is written to that file rather than printed to the terminal.

Does x2md support Twitter threads and media attachments?▼

Basic conversion works without credentials, but enhanced media and thread support requires a Twitter API v2 bearer token. Pass it with the --bearer-token option when running the command.

Do I need a Twitter API token to convert X posts?▼

No, a token is optional for basic post conversion. You only need a Twitter API v2 bearer token when you want improved handling of media attachments or full thread content.