Siri · Share sheet · Clipboard → Markdown
Save X threads as Markdown with Apple Shortcuts
Install a tweet.md Shortcut, paste your API key once, and turn any X/Twitter post or thread into clean Markdown from Siri, the share sheet, or your clipboard.
Try a no-charge demo
Simply replace x.com with tweet.md in any Tweet URL.
Why Shortcuts?
One HTTP call turns capture into a mobile workflow.
Tweet.md already accepts an X URL and returns Markdown. Apple Shortcuts makes that action available where you find the post: from the share sheet, the clipboard, or a Siri phrase on iPhone, iPad, and Mac.
Input → x.com post or thread URL
Output → clean Markdown
Name the Shortcut “Save this thread as Markdown” and run it by voice when a URL is on your clipboard.
Share an X URL into the Shortcut, then choose clipboard, file, Notes, or an Obsidian import path.
Workflow
Step-by-step
- 01
Install the tweet.md Shortcut
Open the prebuilt Shortcut from the tweet.md docs, then add it to your Shortcuts library. - 02
Paste your API key once
Use your twmd_key_… from the tweet.md dashboard. The key stays inside your local copy of the Shortcut. - 03
Share or copy an X URL
Run the Shortcut from the iOS share sheet, from a copied URL, or by asking Siri to run it. - 04
Save the Markdown
Copy the result, show it, save it as a .md file, or adapt the recipe to append to Notes, Drafts, or Obsidian.
Recipes
Start simple, then save wherever you work
Clipboard → Markdown
Read the current clipboard, call tweet.md, and copy the returned Markdown back to the clipboard.
Share sheet → Notes
Accept a shared X URL, convert it to Markdown, then append the result to an Apple Note.
Share sheet → Obsidian file
Use format=obsidian and save the returned .md text into an iCloud Drive folder synced with Obsidian.
HTTP action
The Shortcut calls the same tweet.md API
Use Get Contents of URL with the iOS header below. The prebuilt Shortcut asks for your API key during setup; do not share your customized copy after adding the key.
GET https://tweet.md/i/api/convert?url=https%3A%2F%2Fx.com%2F*t-twmduser%2Fstatus%2F*-t-thread-3&thread=ancestors&format=markdown
x-ios-apikey: twmd_key_…Good for
Capture workflows, not screenshots
Capture useful X threads on mobile without opening a browser or manually copying every post.
Send cleaned source text to Obsidian, Apple Notes, Drafts, iCloud Drive, or the clipboard.
Create a Siri phrase like “Save this thread as Markdown” for repeatable research capture.
Use the same HTTP endpoint in Shortcuts, Raycast, n8n, Zapier, Make, or your own agents.
Next
Continue with profiles, ChatGPT, or the API docs
Fetch a full profile, paste a complete thread into an AI assistant, or customize thread scope and output through the X post and thread documentation.
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
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
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
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
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
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
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