# Install html2markdown with Homebrew
Convert HTML to Markdown. Version 2.5.2 via Homebrew; verified 2026-07-27.
## Install
```sh
sudo av install brew:html2markdown
```
Additional install commands:
### macOS
- Homebrew (100%):
```sh
brew install html2markdown
```
Evidence: local Homebrew formula metadata
## Package facts
- **Package key:** brew:html2markdown
- **Package manager:** Homebrew
- **Version:** 2.5.2
- **Source summary:** Convert HTML to Markdown
- **Homepage:**
- **Repository:**
- **Last updated:** 2026-07-27T14:32:26+02:00
- **Generated:** 2026-08-03T19:37:03+00:00
## Executables
- html2markdown (alias)
## Install behavior
- Bottle: not available
## Freshness
- Page generated: 2026-08-03
- Package-manager version: 2.5.2
## Project history and usage
html2markdown is the Homebrew-packaged command-line face of Johannes Kaufmann's html-to-markdown project, a Go implementation for turning HTML into readable Markdown. Its appeal comes from using an HTML parser and conversion rules instead of regular-expression scraping.
### Project history
The repository was created in 2018 and presents the project as a Go library that converts HTML to Markdown with parser-based handling for unknown input. The README emphasizes extensibility through rules and plugins, with support for GitHub-flavored Markdown features such as tables, strikethrough, and task-list items.
The release stream shows steady versioned packaging, with the 1.x series active through 2024 and the 2.x series appearing afterward. Release assets include platform archives and package artifacts, which explains why a library-oriented Go project also fits Homebrew as a CLI formula.
### Adoption history
The project is visible in Go documentation, Homebrew, and Debian's Go library packaging. That adoption pattern is common for Go conversion libraries: developers embed the library in migration tools, while package managers expose a small command-line converter for one-off document cleanup.
### How it is used
Typical use cases are converting copied web fragments, archived pages, CMS exports, or generated HTML into Markdown for documentation systems. The README's rule and plugin APIs make it useful when a team needs repeatable conversion rules instead of a generic all-purpose document converter.
### Why package nerds care
For package nerds, html2markdown is interesting because it occupies the narrow lane between heavyweight converters such as Pandoc and tiny ad hoc scripts. It packages a parser-backed Go library as an installable utility, giving shell users a focused HTML-to-Markdown tool with binaries across platforms.
### Timeline
- 2018: The html-to-markdown repository was created on GitHub.
- 2020: The v1.2.0 release continued the early 1.x line.
- 2021: v1.3.0 added nested-list focused work.
- 2023: v1.4.0 added escaping control, followed by v1.5.0 list-start work.
- 2024: v1.6.0 landed before the alpha 2.0 releases.
- 2025: v2.3.0 identified table-plugin work in the release title.
- 2026: v2.5.2 shipped with multiple platform artifacts.
### Related projects
- The README names Turndown for JavaScript and lunny/html2md as related projects. In practice, users also compare this kind of tool with Pandoc, html2text, and bespoke site-migration scripts.
### Sources
- GitHub repository and release metadata document the repository creation date and versioned release history.
- Homebrew and Debian package pages support package-manager adoption.
- The GitHub README documents parser-based conversion, rules, plugins, security caveats, and related projects.
## Security Notes
No matching local secret-handling manifest was found for html2markdown. Nucleus package metadata is still published here so future coverage has a stable package URL.
## Combined YAML source
View the package source record on GitHub. [combined/html2markdown.yml](https://github.com/mxcl/pkgdb/blob/main/combined/html2markdown.yml)
## Sources
- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph