macOS
Homebrewverified ยท 100%
brew install html2markdownlocal Homebrew formula metadata
brew
Install html2markdown with Homebrew
Convert HTML to Markdown. Version 2.5.2 via Homebrew; verified 2026-06-07.
install
Additional install commands
overview
Package summary
Convert HTML to Markdown
Project links
Commands and aliases
- html2markdown
history
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 posture
No protected-tool coverage found yet
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.
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 6 platform targets.
- Build metadata lists 1 build dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
html2markdown | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-07-08
manager version2.5.2
manager updated2026-06-07
local dataok
upstreamcurrent
latest detectedv2.5.2
https://github.com/JohannesKaufmann/html-to-markdown
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:html2markdown |
|---|---|
| Version | 2.5.2 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/html2markdown |
| Homepage | https://html-to-markdown.com |
| Repository | https://github.com/JohannesKaufmann/html-to-markdown |
| Upstream docs | https://github.com/JohannesKaufmann/html-to-markdown |
| License | MIT |
| Source archive | https://github.com/JohannesKaufmann/html-to-markdown/archive/refs/tags/v2.5.2.tar.gz |
| Last updated | 2026-06-07T15:08:40Z |
| Pulse | updated |
| Build dependencies | go |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | html2markdown |
| Version Scheme | 0 |
| Revision | 0 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated package history
- package relationship graph
- package version freshness
- package-page enrichment