# kepano/defuddle

Get the main content of any page as Markdown.

Repository: https://github.com/kepano/defuddle
Canonical: https://ross.abutalabs.com/products/defuddle
Homepage: https://defuddle.md
Language: TypeScript
License: MIT
License Family: permissive
Topics: defuddle, cli, html, markdown, md, readability, obsidian
Last push: 2026-08-25T21:38:51+00:00

## Health v2 (maintenance only)
Score: 87/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 39
- inputs: {"age_days": 552, "days_push": 8, "days_rel": 11, "gap_med": 2, "n_releases_24m": 44}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9166, forks 397 (observed 2026-08-28T04:10:28.699597+00:00)

## What it is
Defuddle is a TypeScript library, CLI, and hosted service that extracts the main content from web pages, removing clutter like comments, sidebars, headers, and footers, and returns clean HTML or Markdown. It was created for the Obsidian Web Clipper browser extension and is designed as a more forgiving alternative to Mozilla Readability.

## Use cases
- convert web articles to markdown
- extract main content from a webpage
- clean up html by removing sidebars and comments
- clip web pages into obsidian
- extract article metadata like title and author
- replace mozilla readability for content extraction
- parse html files from the command line

## When to choose
- you need readable article content as markdown or clean html
- you want richer metadata extraction including schema.org data
- you need a readability alternative that removes fewer uncertain elements
- you want a cli or hosted api for url-to-markdown conversion

## When to avoid
- you need full-page screenshots or pixel-perfect rendering
- you require a battle-tested, fully stable parser - the project is a work in progress
- you need structured data scraping like tables or product listings rather than article content

## Facets
- artifact type: library
- maturity: active
- function: parser, web-scraping, cli, markdown
- domain: web-development, developer-tools, crawlers
- platform: browser, cli
- tags: readability, content-extraction, html-to-markdown, article-extraction, obsidian, web-clipper, nodejs, web-server

## Member repositories
- kepano/defuddle (main) score 87

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:28.699597+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:23:22.750703+00:00, confidence not recorded.
  - readme: https://github.com/kepano/defuddle (fetched 2026-08-28T04:10:28.699597+00:00, sha 41fd6a1c9149)
  - homepage: https://defuddle.md (fetched 2026-08-29T08:23:46.672291+00:00, sha e6a9c9df8124)
  - site_page: https://defuddle.md/docs (fetched 2026-08-29T08:23:46.675997+00:00, sha 5483a68192dd)
  - registry_npm: https://registry.npmjs.org/defuddle (fetched 2026-08-29T08:23:46.679750+00:00, sha 76ae2f7a4372)
  - site_page: https://defuddle.md/pricing (fetched 2026-08-29T08:23:46.678133+00:00, sha ec7a5c935d48)
- Data as of 2026-08-30T08:39:29.467469+00:00.