# Install html2markdown with Homebrew

Convert HTML to Markdown. Version 2.5.2 via Homebrew; verified 2026-06-07.

## 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
- **Package manager page:** <https://formulae.brew.sh/formula/html2markdown>
- **Version:** 2.5.2
- **Source summary:** Convert HTML to Markdown
- **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
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- html2markdown (cli)
- html2markdown (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.5.2
- Package-manager updated: 2026-06-07
- Local data: ok
- Upstream repository: https://github.com/JohannesKaufmann/html-to-markdown
- Upstream latest detected: v2.5.2 (current)
## 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.


## 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:** head, stable


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [html2text](https://www.automicvault.com/pkg/brew/html2text/) - Shares av.db curated category or tags: cli, conversion, converter, developer-tools, html.
- [markdown](https://www.automicvault.com/pkg/brew/markdown/) - Shares av.db curated category or tags: cli, conversion, developer-tools, html, markdown.
- [vilistextum](https://www.automicvault.com/pkg/brew/vilistextum/) - Shares av.db curated category or tags: cli, conversion, developer-tools, html, markup.
- [discount](https://www.automicvault.com/pkg/brew/discount/) - Shares av.db curated category or tags: cli, developer-tools, html, markdown, markup.
- [htmldoc](https://www.automicvault.com/pkg/brew/htmldoc/) - Shares av.db curated category or tags: cli, conversion, converter, developer-tools, html.
- [pandoc](https://www.automicvault.com/pkg/brew/pandoc/) - Shares av.db curated category or tags: cli, developer-tools, html, markdown, markup.
- [comrak](https://www.automicvault.com/pkg/brew/comrak/) - Shares av.db curated category or tags: cli, developer-tools, markdown, markup.
- [hoedown](https://www.automicvault.com/pkg/brew/hoedown/) - Shares av.db curated category or tags: cli, developer-tools, markdown, markup.

## Combined YAML source

View the package source record on GitHub. [combined/html2markdown.yml](https://github.com/automic-vault/db/blob/main/combined/html2markdown.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph