tweet.md logotweet.md
← all guidesX Articles

X Article → Markdown

How to convert an X Article to Markdown

Export a long-form X Article as structured Markdown with its headings, links, media references, lists, quotes, code, and source metadata intact.

Try a no-charge demo

Simply replace x.com with tweet.md in any Tweet URL.

x.comtweet.md/*t-twmduser/status/*-t-article

Content type

Articles, posts, and threads use the same URL shape

X Article

A long-form document attached to a status post. tweet.md returns the Article body as a structured Markdown document.

X post

One short-form status. Use thread=off when you only want that post.

X thread

Several connected posts. Use thread=branch or thread=all to choose the conversation scope.

Workflow

Replace the domain and keep the status path

  1. 01

    Copy the Article’s X status URL.

    Use the author’s normal /status/… permalink. An x.com/i/article/… URL by itself does not identify the post tweet.md needs.
  2. 02

    Replace x.com with tweet.md.

    Keep the handle and status ID exactly as they are, then open the rewritten URL. This is tweet.md’s controlled example Article, used to verify Article conversion end to end.

    URL transform

    Before

    https://x.com/*t-twmduser/status/*-t-article

    After

    https://tweet.md/*t-twmduser/status/*-t-article
  3. 03

    Copy or save the Markdown document.

    The Article title and body come first. Source, author, post ID, capture time, and stats follow in Article Metadata.
  4. 04

    Archive it or use it as source context.

    Save the file in a notes vault, cite it in research, or paste it into an AI tool with a source-grounded prompt.

What is preserved

The Article stays a document, not a wall of text

tweet.md follows the Article’s real block structure so the Markdown remains useful in notes, editors, archives, and AI tools.

  • Title and heading hierarchy
  • Paragraphs, bold, italic, quotes, and lists
  • Inline links and source URLs
  • Cover images, inline images, video references, and captions
  • Code blocks and tables
  • Embedded and quoted post references

Canonical example output

A complete X Article as Markdown

This is the Markdown rendered from the controlled example Article above—the same captured Article used to verify conversion end to end.

# tweet.md test article

![Cover image](https://pbs.twimg.com/media/HMxjPO7X0AAs7OD.jpg)

This is just a little test article for [tweet.md](https://tweet.md) don't mind me!

But go **checkout** tweet.md :D

## Heading

### Subheading

## I – Test

### II - Test

Body

**BOLD**

*ITALIC*

~~STRIKETROUGH~~

> This is a quote
>
> with multiple lines
>
> – Someone

- Here we have
- a bullet point list
1. and a numbered
2. list too!

This is a [Link](https://tweet.md?link=1) and another [Link](https://tweet.md?link=2)

😅🤣🤝😆😱🙌🚀

![This is an alt text!](https://pbs.twimg.com/media/HMxuoitWoAA8J5x.jpg) — "Image caption"

![Article image](https://pbs.twimg.com/media/HMxkZMfXcAAfnaM.jpg) — "Same image as first one but uploaded again"

Text between images

another image:

![Article image](https://pbs.twimg.com/media/HMxmGYpWIAA-yAh.jpg)

Some gif:

[gif](https://video.twimg.com/tweet_video/HMxknYyW0AAYXsF.mp4)

Video:

[video](https://video.twimg.com/amplify_video/2075144856125497344/vid/avc1/1920x1080/p_3V4WUKerfJdmPY.mp4?tag=28)

A divider:

---

Some code:

```python
print("Hello world")
```

Latex:

$$E = mc^2$$

Table:

| Table Header 1  | Header 2   | Header 3   | Header 4   |
| --- | --- | --- | --- |
|  Stuff  | stufff   | stuff   | stuff   |
|  Stuff  | stufff   | stuff   | stuff   |
|  Stuff  | stufff   | stuff   | stuff   |

a X post:

Embedded post:

Author: Lars (@*t-twmduser)
Post ID: *-t-post
Source: https://x.com/*t-twmduser/status/*-t-post
Reply to: none

Stats:
- Replies: 5
- Reposts: 2
- Quotes: 2
- Likes: 32
- Bookmarks: 2
- Impressions: 3,401

Text:

> new week!
>
> here’s what I shipped this weekend [video](https://video.twimg.com/amplify_video/2058910469214404608/vid/avc1/1280x720/mN6Tp909xoZWDpdf.mp4?tag=14)

Media:
- video: https://video.twimg.com/amplify_video/2058910469214404608/vid/avc1/1280x720/mN6Tp909xoZWDpdf.mp4?tag=14

# Article Metadata

Author: Lars (@*t-twmduser)
Post ID: *-t-article
Source: https://x.com/*t-twmduser/status/*-t-article
Article: https://x.com/i/article/2075141930652962816
Published: 2026-07-09T09:09:45.000Z
Captured: 2026-07-09T00:00:00.000Z

Stats:
- Replies: 0
- Reposts: 0
- Quotes: 0
- Likes: 0
- Bookmarks: 0
- Impressions: 19

Good for

Archive once, reuse anywhere

  • Archive a long-form Article outside X in a portable, searchable format.
  • Import the document into Obsidian or another Markdown notes system.
  • Give an LLM the full source text instead of asking it to open a dynamic X page.
  • Quote, compare, or annotate the Article in research and editorial workflows.

Limits, authentication, and pricing

The status permalink is required

Availability

Private, deleted, withheld, or otherwise unavailable Articles cannot be returned. Use the public /status/… URL, not an /i/article/… URL alone.

Credits

A standalone Article costs the same as one regular post. Posts returned around it, quoted posts, and fully rendered embedded posts each use credits; author metadata can add credits.

No-charge demo

The controlled Article linked in this guide works without a profile or credits. Other Articles use your profile’s credits.

Authentication

Browser checkout sets a session cookie. Programmatic requests can use an API key in a header or query parameter, or a trusted IP configured in the dashboard.

See the X Articles documentation and credit pricing details.

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.

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

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 posts 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