Convert X/Twitter posts, threads, Articles, and profiles to Markdown
Convert X/Twitter posts, threads, Articles, and profiles to Markdown
Replace `x.com` with `tweet.md` in any X/Twitter URL (post, thread, article, or profile) and get clean Markdown back for any chat assistant or agent.
Ready for LLMs, agents, archives, and research.
Try a no-charge demo
Simply replace `x.com` with `tweet.md` in any Tweet URL.
x.com→tweet.md/\t-twmduser/status/\-t-thread-3?thread=ancestors
Featured on Product Hunt
---
Live demo
Run a real conversion from a controlled demo corpus — a post, a thread, an X Article, and a profile. No account, no key, and never a charge.
Single post
One post with its stats, media, and author metadata. thread=off skips the surrounding conversation.
Open in new tabExecute
Request
Copy
curl "https://tweet.md/t-twmduser/status/-t-post?thread=off"Response
Not run yet
Select Execute to see the Markdown response here.
Convert your own posts
Create a profile and try it out with your own posts, threads, Articles, and profiles.
$5250 credits→$191,100 credits→$493,200 credits→
---
How it works
AI chat assistant
1. 01 Replace `x.com` with `tweet.md` in any post URL. 2. 02 Copy the LLM-ready Markdown from the page. 3. 03 Paste it into any chat assistant or agent below.
You don't need to worry about authentication — after checkout, your browser gets a cookie with your API key.
Works with
OpenAIChatGPT
ClaudeClaude
Claude CodeClaude Code
ClineCline
CodexCodex
CopilotCopilot
CursorCursor
DeepSeekDeepSeek
GeminiGemini
Gemini CLIGemini CLI
GemmaGemma
GithubCopilotGitHub Copilot
GrokGrok
Hermes AgentHermes
NotebookLMNotebookLM
NotionNotion
ObsidianObsidian
OllamaOllama
opencodeOpenCode
OpenClawOpenClaw
PoePoe
V0v0
GrokxAI
OpenAIChatGPT
ClaudeClaude
Claude CodeClaude Code
ClineCline
CodexCodex
CopilotCopilot
CursorCursor
DeepSeekDeepSeek
GeminiGemini
Gemini CLIGemini CLI
GemmaGemma
GithubCopilotGitHub Copilot
GrokGrok
Hermes AgentHermes
NotebookLMNotebookLM
NotionNotion
ObsidianObsidian
OllamaOllama
opencodeOpenCode
OpenClawOpenClaw
PoePoe
V0v0
GrokxAI
AI agents
Want to use tweet.md from an agent? Give it the skill below plus your API key, and it can read any tweet.
The skill instructs your agent to replace any `x.com` URL with `tweet.md`. Our Markdown output is optimized for LLMs, saving tokens.
SKILL.md
Expand
`npx skills add tweet-md/skill`
Copy skill
---
Guides
Scraping x.com gives you clutter, partial threads, and unreliable stats. Convert posts and profiles to clean Markdown first: then save or paste into any chat assistant.
Markdown/guide →Convert an X (Twitter) thread to MarkdownExport a complete X/Twitter thread in order, with post text, source links, and metadata.full thread text, not page scrapeX Article/guide →Convert an X Article to MarkdownExport a long-form X Article with its headings, links, media references, and document structure intact.long-form structure, links, and mediaObsidian/guide →Save X posts and threads to ObsidianTurn X/Twitter posts, threads, Articles, and profiles into vault-ready Markdown with YAML frontmatter.YAML frontmatter, source metadata, vault importProfileNew/guide →Fetch an X profile as MarkdownGet bio, stats, pinned post, and recent content from any X profile as clean Markdown.bio, stats, pics, and recent postsShortcuts/guide →Save X threads as Markdown with Apple ShortcutsUse Siri, the share sheet, or clipboard input to call tweet.md and save X posts as Markdown on iPhone, iPad, or Mac.Siri, share sheet, clipboard
OpenAIChatGPT/guide →Copy an X thread or post to ChatGPTPaste complete X posts and threads into ChatGPT without missing content or broken links.reads pasted Markdown, not a raw URLClaudeClaude/guide →Copy an X thread or post to ClaudeGive Claude the full post or thread text as Markdown instead of a brittle X link.reads pasted Markdown, not a raw URLGeminiGemini/guide →Copy an X thread or post to GeminiMake X posts and threads readable for Gemini with one tweet.md URL swap.reads pasted Markdown, not a raw URL
---
Pricing
1 credit per post. Author metadata adds 2 credits per unique author. Controlled demos are no-charge; create a profile to convert your own content.
$5
250 credits
$19
1,100 credits
$49
3,200 credits
$5250 credits
→
$191,100 credits
→
$493,200 credits
→
$5
250 credits
$0.02 per credit — try it out
Approximate usage\~83 posts with metadata
IncludesAPI key + browser session after checkout
Buy $5
$19
1,100 credits
$0.0173 per credit — best balance for agents
Approximate usage\~366 posts with metadata
IncludesAPI key + browser session after checkout
Buy $19
$49
3,200 credits
$0.0153 per credit — lowest per-credit rate
Approximate usage\~1,066 posts with metadata
IncludesAPI key + browser session after checkout
Buy $49
$5250 credits
$0.02 / credit
→
$191,100 creditsbest value
$0.0173 / credit
→
$493,200 credits
$0.0153 / credit
→
---
FAQ
Can I try tweet.md before buying credits?
Yes. The live demo uses a controlled demo corpus and never charges you. Converting your own content uses credits from your profile; there is no subscription.
How do credits work?
Each returned post costs 1 credit. `userinfo=author` adds 2 credits for the root author; `userinfo=all` adds 2 credits per unique author. See pricing above or top up.
How do I authenticate?
After checkout or login, your browser uses a session cookie. Agents and scripts can send `Authorization: Bearer twmd_key_…`, `x-ios-apikey` (Apple Shortcuts), or `?apikey=`. Servers can also whitelist up to 5 fixed IP addresses per key on the dashboard and spend credits without sending a key. CIDR is not supported, and an explicit API key takes priority over IP auth. Full details are in the docs.
What happens when I open a thread?
Authenticated requests default to `branch-15`: the reply chain above the opened post fills first, then replies underneath it with the remaining budget. Use `thread=ancestors-N` for the chain above only, or `thread=all-N` for the opened post plus the N−1 most recent conversation posts. N always includes the opened post. Set defaults on the dashboard. The controlled thread demo is no-charge; other conversations use profile or purchased credits.
What output formats are supported?
`markdown` is the default and includes stats, media, quotes, and articles. `obsidian` adds YAML frontmatter and vault-friendly headings. Add `?format=` to any tweet.md URL. Full comparison in docs.
Why use tweet.md instead of scraping?
tweet.md uses the official X API and returns clean Markdown for LLMs. You avoid scraping HTML, embeds, or raw JSON, and usually use fewer tokens.
Can I fetch a profile with tweet.md?
Yes. Replace `x.com/thepetermick` with `tweet.md/thepetermick`. You get the bio, stats, profile image, and recent posts as Markdown. The controlled profile demo is no-charge; other profiles use your profile’s credits. Profile guide · Docs.
Is there an Apple Shortcut for iPhone and iPad?
Yes. Install the Apple Shortcut, paste your `twmd_key_…` once, then convert shared or copied X URLs from Siri, the share sheet, or your clipboard. The key stays in your local Shortcut.
Featured on
