whatisgithub

What is twitter-article-to-markdown?

dongyubin/twitter-article-to-markdown — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A Codex skill for Windows that saves long X or Twitter posts as Markdown files, downloading images and post stats along the way.

Mindmap

mindmap
  root((Twitter Article To Markdown))
    What it does
      Saves X posts as Markdown
      Downloads images
      Keeps engagement stats
    Tech stack
      Python
      gallery-dl
      Codex skill
    Use cases
      Offline article archive
      AI assistant automation
      Thread saving
    Audience
      Developers
      Codex users
    Setup
      Clone repo
      Install skill folder
      Export Chrome cookie

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Save a long X Article or thread as a readable Markdown file with images included.

USE CASE 2

Keep an offline archive of a post's title, author, link, and engagement stats.

USE CASE 3

Let an AI coding assistant like Codex fetch and convert X posts on request.

USE CASE 4

Fall back to a GraphQL-based script when only images download and the article text is missing.

What is it built with?

Pythongallery-dlBeautifulSoupCodex

How does it compare?

dongyubin/twitter-article-to-markdown0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity3/54/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Python, gallery-dl, and an exported Chrome login cookie for X.com to access non-public content.

The README does not state license terms.

So what is it?

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.

Copy-paste prompts

Prompt 1
Help me install this Codex skill on Windows and set up the required Python packages.
Prompt 2
Walk me through exporting my X.com cookie safely so gallery-dl can access logged-in content.
Prompt 3
Explain the difference between the HTML-to-Markdown script and the GraphQL fallback script here.
Prompt 4
Show me how to ask Codex to use this skill to save a specific x.com status link as Markdown.

Frequently asked questions

What is twitter-article-to-markdown?

A Codex skill for Windows that saves long X or Twitter posts as Markdown files, downloading images and post stats along the way.

What language is twitter-article-to-markdown written in?

Mainly Python. The stack also includes Python, gallery-dl, BeautifulSoup.

What license does twitter-article-to-markdown use?

The README does not state license terms.

How hard is twitter-article-to-markdown to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is twitter-article-to-markdown for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.