dongyubin/twitter-article-to-markdown — explained in plain English
Analysis updated 2026-05-18
Save a long X Article or thread as a readable Markdown file with images included.
Keep an offline archive of a post's title, author, link, and engagement stats.
Let an AI coding assistant like Codex fetch and convert X posts on request.
Fall back to a GraphQL-based script when only images download and the article text is missing.
| dongyubin/twitter-article-to-markdown | 0xhassaan/nn-from-scratch | 3ks/embedoc | |
|---|---|---|---|
| Stars | 0 | 0 | — |
| Language | Python | Python | Python |
| Last pushed | — | — | 2023-06-08 |
| Maintenance | — | — | Dormant |
| Setup difficulty | moderate | moderate | hard |
| Complexity | 3/5 | 4/5 | 1/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires Python, gallery-dl, and an exported Chrome login cookie for X.com to access non-public content.
Twitter Article To Markdown is a skill for Codex, the AI coding assistant, that grabs long form posts from X, formerly known as Twitter, and saves them as Markdown files on a Windows computer. It works alongside a tool called gallery-dl, a Chrome browser cookie, and some included conversion scripts to turn an X Article or a long thread into a readable text file, while also downloading and organizing any images from the post into a matching local folder. The README is written for people who want to save a specific x.com status link as a Markdown document, complete with the title, author, original post link, and counts for likes, reposts, replies, quotes, views, and bookmarks. Images from the article are downloaded and placed in a folder with the same name as the Markdown file, so the whole thing can be read offline later. It is meant to be installed once as a reusable skill inside Codex or a similar AI coding assistant, rather than run as a one off script each time. Setup involves cloning the repository, copying its skill folder into a specific folder Codex looks for skills, and installing a handful of Python packages including gallery-dl, beautifulsoup4, markdownify, and requests. Because some content on X requires being logged in, the README walks through exporting a login cookie from Chrome using a browser extension and saving it locally, while explicitly warning that this cookie is a login credential that should never be shared, committed to GitHub, or printed out by an AI assistant. Once set up, a user can either ask their Codex assistant directly to use the skill on a given link, or run the included Python scripts by hand: one that converts locally downloaded HTML into Markdown, and a fallback script that uses X's GraphQL API to pull the article text and interaction numbers when only images were downloaded. The README also lists common problems, like the skill not being recognized until Codex is restarted, or cookies expiring and needing to be re-exported.
A Codex skill for Windows that saves long X or Twitter posts as Markdown files, downloading images and post stats along the way.
Mainly Python. The stack also includes Python, gallery-dl, BeautifulSoup.
The README does not state license terms.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.