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.
Test it out now!
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=branch-15 for the default reply branch.
URL transformBefore
https://x.com/OpenAI/status/2074907035225981169→After
https://tweet.md/OpenAI/status/2074907035225981169?format=obsidian&thread=branch-15 - 03
Choose one post or a thread scope.
Use thread=off for one post, thread=branch-15 for its reply chain, 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 can include the bio, links, pinned post, recent posts, replies, and Articles you request.
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 content 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.
Free use
The monthly free allowance supports the linked post with thread=off&userinfo=off. It does not include a full thread.
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.