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.comtweet.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 tab

Request

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.

Try it out

How it works

AI chat assistant

01
Replace x.com with tweet.md in any post URL.
02
Copy the LLM-ready Markdown from the page.
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

ChatGPT

Claude

Claude Code

Cline

Codex

Copilot

Cursor

DeepSeek

Gemini

Gemini CLI

Gemma

GitHub Copilot

Grok

Hermes

NotebookLM

Notion

Obsidian

Ollama

OpenCode

OpenClaw

Poe

xAI

ChatGPT

Claude

Claude Code

Cline

Codex

Copilot

Cursor

DeepSeek

Gemini

Gemini CLI

Gemma

GitHub Copilot

Grok

Hermes

NotebookLM

Notion

Obsidian

Ollama

OpenCode

OpenClaw

Poe

xAI

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

npx skills add tweet-md/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 Markdown

Export a complete X/Twitter thread in order, with post text, source links, and metadata.

full thread text, not page scrape

X Article/guide →

Convert an X Article to Markdown

Export a long-form X Article with its headings, links, media references, and document structure intact.

long-form structure, links, and media

Obsidian/guide →

Save X posts and threads to Obsidian

Turn X/Twitter posts, threads, Articles, and profiles into vault-ready Markdown with YAML frontmatter.

YAML frontmatter, source metadata, vault import

ProfileNew

/guide →

Fetch an X profile as Markdown

Get bio, stats, pinned post, and recent content from any X profile as clean Markdown.

bio, stats, pics, and recent posts

Shortcuts/guide →

Save X threads as Markdown with Apple Shortcuts

Use 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

ChatGPT/guide →

Copy an X thread or post to ChatGPT

Paste complete X posts and threads into ChatGPT without missing content or broken links.

reads pasted Markdown, not a raw URL

Claude/guide →

Copy an X thread or post to Claude

Give Claude the full post or thread text as Markdown instead of a brittle X link.

reads pasted Markdown, not a raw URL

Gemini/guide →

Copy an X thread or post to Gemini

Make 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.

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