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.
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%2Fjack%2Fstatus%2F20&thread=full&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
More tweet.md workflows
convert an X post or thread to Markdown
Get the post text, thread chain, and metadata as Markdown you can save or paste into any chat assistant.
full thread text, not page scrape
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