X/Twitter → vault-ready Markdown
Save X posts and threads to Obsidian as Markdown
Replace the X domain with tweet.md, request Obsidian output, preserve thread order and source metadata, and save the resulting Markdown into your vault.
Try a no-charge demo
Replace x.com with tweet.md, then add format=obsidian for vault-ready output.
Fastest workflow
Replace the domain, request Obsidian output, save the note
- 01
Copy a public X status URL.
Start with the post permalink you want to keep, or any post in the thread chain. Private, deleted, withheld, or unavailable content cannot be converted. - 02
Replace x.com with tweet.md.
Keep the handle and status ID, then add format=obsidian — that is what produces vault-ready YAML frontmatter. This example also uses thread=ancestors for the stable reply chain above it.
URL transformBefore
https://x.com/*t-twmduser/status/*-t-thread-3→After
https://tweet.md/*t-twmduser/status/*-t-thread-3?format=obsidian&thread=ancestors - 03
Choose one post or a thread scope.
Use thread=off for one post, thread=ancestors for the reply chain above it, or thread=all-20 for a broader conversation slice. - 04
Save the returned text as a Markdown note.
Copy the result into Obsidian or save it as a .md file inside your vault. Obsidian reads the YAML frontmatter and vault-friendly headings directly.
Posts and threads
Capture the complete conversation you need
thread=off returns one post. thread=branch-20 follows the selected reply chain in order, while thread=all-20 includes sibling branches within the cap. See the thread-scope documentation or the complete thread guide for every option.
Canonical Obsidian note
A thread branch, ready for a vault
This shape matches the illustrative branch example in the X thread guide. YAML frontmatter captures the thread source and author; each post gets its own heading with post ID, reply context, stats, text, and media.
---
source: https://x.com/exampleuser/status/9000000000000000001
author: "Example Account"
author_handle: exampleuser
captured: 2026-05-17T00:00:00.000Z
tags: [x-thread, tweetmd]
---
# 1/3 — Post by Example Account (@exampleuser)
Post ID: 9000000000000000001
Source: https://x.com/exampleuser/status/9000000000000000001
Reply to: none
Stats:
- Replies: 8
- Reposts: 42
- Quotes: 3
- Likes: 610
- Bookmarks: 54
- Impressions: 92,000
Text:
> Shipping notes: what changed in this release and why.
# 2/3 — Post by Example Account (@exampleuser)
Post ID: 9000000000000000002
Source: https://x.com/exampleuser/status/9000000000000000002
Reply to: https://x.com/exampleuser/status/9000000000000000001
Stats:
- Replies: 2
- Reposts: 9
- Quotes: 1
- Likes: 88
- Bookmarks: 12
- Impressions: 18,000
Text:
> Full changelog and migration notes are linked below.
# 3/3 — Post by Sample Dev (@sampledev)
Post ID: 9000000000000000004
Source: https://x.com/sampledev/status/9000000000000000004
Reply to: https://x.com/exampleuser/status/9000000000000000002
Stats:
- Replies: 1
- Reposts: 0
- Quotes: 0
- Likes: 6
- Bookmarks: 0
- Impressions: 1,900
Text:
> Does this release change the v1 API endpoints?
Mobile capture
Use the share sheet on iPhone or iPad
Apple Shortcuts
The tweet.md Shortcut guide shows how to accept an X URL from the share sheet, request format=obsidian, and copy the result or save a .md file into an iCloud Drive folder synced with your vault.
No invented automation
tweet.md returns the Markdown. You choose whether Shortcuts copies it, opens a save dialog, or writes it to a folder Obsidian already watches.
Web workflow, not a plugin
No Obsidian installation or personal X API credentials
tweet.md
A web, API, and Shortcut workflow that produces Obsidian-compatible Markdown. Use it from a browser or automation without installing an Obsidian community plugin.
Plugin and extension workflows
Some alternatives run inside Obsidian or a browser and may require installation, ongoing maintenance, or your own X developer credentials. Choose that model when tighter in-app automation matters more than a portable URL/API workflow.
Other X content
Save Articles and profiles too
The same format=obsidian option works for long-form X Articles and profile exports. Articles keep document structure; profiles include the bio, links, pinned post, and as many recent posts as you ask for — replies and reposts too, if you want them.
How to convert an X (Twitter) thread to Markdown
Export a complete X/Twitter thread in order, with post text, source links, and metadata.
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.
How to convert an X Article to Markdown
Export a long-form X Article with its headings, links, media references, and document structure intact.
How to fetch an X profile as Markdown
Get bio, stats, pinned post, and recent posts from any X profile as clean Markdown.
Limits and pricing
Public content only; full threads use credits
Availability
Private, deleted, withheld, or otherwise unavailable X content cannot be returned.
No-charge demo
The controlled post and reply-chain examples in this guide work without a profile or credits. Other content uses your profile’s credits.
Paid credits
Thread posts, quoted posts, rendered embedded posts, and requested author metadata can each use credits. Browser checkout creates a session; API requests can authenticate with an API key.
Read the Obsidian output documentation, review credit pricing, or add credits when you need complete threads.
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
Fetch an X profile as Markdown
Get bio, stats, pinned post, and recent posts from any X profile as clean Markdown.
bio, stats, pics, and recent posts
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
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