finds.dev

luin/readability

📚 Turn any web page into a clean view

View on GitHub

★ 2,521HTMLupdated Apr 2021

// the take

A Node.js wrapper around arc90's readability algorithm that strips a web page down to its main article content, similar to what Safari Reader or Instapaper do. It uses jsdom for parsing and handles URL fetching, encoding conversion, and DOM cleanup in one call. Aimed at anyone building a read-later tool, content scraper, or article extractor in Node.

The GBK/GB2312 encoding support is a real differentiator — most readability ports ignore non-UTF-8 pages entirely. The `preprocess` hook is a clean escape hatch for filtering oversized pages or modifying source before parsing. Exposing the live jsdom document on the article object means you can do further DOM queries without re-parsing. Relative-to-absolute URL conversion is handled automatically, which is the tedious bit everyone forgets.

Abandoned since 2021 and pinned to an ancient version of jsdom — the modern jsdom has significant breaking API changes so this won't drop into a current Node project without pain. The callback-only API predates async/await by years; there is no Promise interface at all. Mozilla ships a maintained readability port (`@mozilla/readability`) that is actively used in Firefox Reader View and is the obvious alternative. The test fixtures are a handful of static HTML files with no mechanism to add new ones easily, so accuracy regressions on modern sites go undetected.

We read the README, the directory tree and a key source file in July 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
2,521
Forks
313
Language
HTML
Last commit
3 Apr 2021

// nearby

If readability isn't quite it.

All repos →