# Turndown

JavaScript library that converts HTML into Markdown, for Node.js and in the browser.


Source: https://findsoftware.frbit.cloud/turndown/
Last reviewed: 2026-11-16
Listed since: 2026-11-16

## Record

### Links

- home: https://mixmark-io.github.io/turndown/
- repository: https://github.com/mixmark-io/turndown

### Identity

- status: active
- maintainer: Dom Christie
- maintainerType: unknown
- parent: unknown
- firstRelease: 2014
- hqCountry: unknown

### Kind

- category: library
- hosting: node
- language: javascript
- runtime: node
- runtimeMin: unknown
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: not applicable
- renderingModes: not applicable
- installMethod: npm

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 7
- latestReleaseDate: 2026-11-04

### Adoption

- githubStargazers: 11511
- packagistDownloads: not applicable
- npmWeeklyDownloads: 17306257
- contributors: 30
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 18680
- dependentPackages: 536

### Sources

- urls: https://mixmark-io.github.io/turndown/ (read 2026-11-16)
- urls: https://api.github.com/repos/mixmark-io/turndown (read 2026-11-16)
- firstRelease: https://api.github.com/repos/mixmark-io/turndown/tags (read 2026-11-16)
- maintainer: https://raw.githubusercontent.com/mixmark-io/turndown/master/LICENSE (read 2026-11-16)
- category: https://raw.githubusercontent.com/mixmark-io/turndown/master/README.md (read 2026-11-16)
- language: https://api.github.com/repos/mixmark-io/turndown (read 2026-11-16)
- runtime: https://raw.githubusercontent.com/mixmark-io/turndown/master/README.md (read 2026-11-16)
- installMethod: https://raw.githubusercontent.com/mixmark-io/turndown/master/README.md (read 2026-11-16)
- license: https://raw.githubusercontent.com/mixmark-io/turndown/master/README.md (read 2026-11-16)
- licenseModel: https://raw.githubusercontent.com/mixmark-io/turndown/master/README.md (read 2026-11-16)
- currentMajor: https://api.github.com/repos/mixmark-io/turndown/releases (read 2026-11-16)
- latestReleaseDate: https://api.github.com/repos/mixmark-io/turndown/releases (read 2026-11-16)
- githubStargazers: https://api.github.com/repos/mixmark-io/turndown (read 2026-11-16)
- contributors: https://api.github.com/repos/mixmark-io/turndown/contributors (read 2026-11-16)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-11-01:2026-11-07/turndown (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/turndown (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/turndown (read 2026-11-16)

## Notes

Turndown reads HTML and writes Markdown, and takes either an HTML string or a DOM node as input. The demo page says it aims to be CommonMark compliant, and options cover heading style, bullet markers, code block fences, emphasis and link style.

Rules decide how each element converts. Added rules take precedence over the CommonMark rules, `keep` and `remove` filters choose which elements stay as HTML or disappear, and plugins bundle several rules together. The [online demo](https://mixmark-io.github.io/turndown/) shows a conversion on the project's own page.

## Worth knowing

Turndown escapes Markdown characters in text with backslashes, using a group of regular expressions. The README says the resulting escaping rules can be quite aggressive, and a developer who is confident in the escaping can override the escape method.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
