PHPackages kreuzberg-dev/html-to-markdown - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Parsing & Serialization](/categories/parsing) 4. / 5. kreuzberg-dev/html-to-markdown ActivePhp-ext[Parsing & Serialization](/categories/parsing) kreuzberg-dev/html-to-markdown ============================== High-performance HTML to Markdown converter v3.5.7(2mo ago)8236265[4 PRs](https://github.com/kreuzberg-dev/html-to-markdown/pulls)MITHTMLPHP >=8.2CI passing Since Nov 3Pushed 2w ago6 watchersCompare [ Source](https://github.com/kreuzberg-dev/html-to-markdown)[ Packagist](https://packagist.org/packages/kreuzberg-dev/html-to-markdown)[ RSS](/packages/kreuzberg-dev-html-to-markdown/feed)WikiDiscussions main Synced 2mo ago READMEChangelog (10)Dependencies (28)Versions (191)Used By (0) ![Xberg](https://camo.githubusercontent.com/634e91576caf8f36ad27ce2180030b6dcd54a71dc87f7be493855aebfc430d5b/68747470733a2f2f63646e2e6a7364656c6976722e6e65742f67682f78626572672d696f2f6173736574734076312f62616e6e65722f726561646d652d62616e6e65722d6c696768742e737667) html-to-markdown ================ [](#html-to-markdown) [ ![Built with alef](https://camo.githubusercontent.com/c9e1dfcbc5066304dc7bd3d619f0bea998c7cb09c2301107c1b867345d5c6d2a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6275696c74253230776974682d616c65662532302544372539302d303037656336) ](https://github.com/xberg-io/alef) [ ![Rust](https://camo.githubusercontent.com/875152826f78912b6caa083335bd4da698c60b03d9c1928a79f6ccc3d0f43c34/68747470733a2f2f696d672e736869656c64732e696f2f6372617465732f762f68746d6c2d746f2d6d61726b646f776e2d72733f6c6162656c3d5275737426636f6c6f723d303037656336) ](https://crates.io/crates/html-to-markdown-rs) [ ![Python](https://camo.githubusercontent.com/37b516d01cb111f0df23c1489fcfbc5580c626199b7ace3f49c2d4e9bfd13cc1/68747470733a2f2f696d672e736869656c64732e696f2f707970692f762f68746d6c2d746f2d6d61726b646f776e3f6c6162656c3d507974686f6e26636f6c6f723d303037656336) ](https://pypi.org/project/html-to-markdown/) [ ![Node.js](https://camo.githubusercontent.com/f6bfbaf34c89152dea667d528eecba526094ca3c4159d4a05d21b42076562aa2/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f4078626572672d696f2f68746d6c2d746f2d6d61726b646f776e3f6c6162656c3d4e6f64652e6a7326636f6c6f723d303037656336) ](https://www.npmjs.com/package/@xberg-io/html-to-markdown) [ ![WASM](https://camo.githubusercontent.com/23f0057ec0e72d38720f6897f3007b1a35b192ba5af639fd64bc9be6433e486b/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f4078626572672d696f2f68746d6c2d746f2d6d61726b646f776e2d7761736d3f6c6162656c3d5741534d26636f6c6f723d303037656336) ](https://www.npmjs.com/package/@xberg-io/html-to-markdown-wasm) [ ![Java](https://camo.githubusercontent.com/e223372f634c387818068f5195fffbd29d6ac479c79d2a43909ca4f420c14fae/68747470733a2f2f696d672e736869656c64732e696f2f6d6176656e2d63656e7472616c2f762f696f2e78626572672f68746d6c2d746f2d6d61726b646f776e3f6c6162656c3d4a61766126636f6c6f723d303037656336) ](https://central.sonatype.com/artifact/io.xberg/html-to-markdown) [ ![Go](https://camo.githubusercontent.com/d4ca576527607331d4415ed762e5352c02e8317750787c10f76b8fef5101b8d7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f7461672f78626572672d696f2f68746d6c2d746f2d6d61726b646f776e3f6c6162656c3d476f26636f6c6f723d3030376563362666696c7465723d76332a) ](https://pkg.go.dev/github.com/xberg-io/html-to-markdown/packages/go/v3) [ ![C#](https://camo.githubusercontent.com/223ad3e8bc24c3b8069399203c0ede90b7956bf6fb71b9b9757674cd389027f7/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f5862657267496f2e48746d6c546f4d61726b646f776e3f6c6162656c3d4325323326636f6c6f723d303037656336) ](https://www.nuget.org/packages/XbergIo.HtmlToMarkdown/) [ ![PHP](https://camo.githubusercontent.com/5a5a085aa795cfebdbaca58a2095e9e7356baa68e127576bc4dfc3aba1a546da/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f78626572672d696f2f68746d6c2d746f2d6d61726b646f776e3f6c6162656c3d50485026636f6c6f723d303037656336) ](https://packagist.org/packages/xberg-io/html-to-markdown) [ ![Ruby](https://camo.githubusercontent.com/6a4b8b9f1861bb7980c818ef51e2556aba13e737033adf3d0f3165577191bae1/68747470733a2f2f696d672e736869656c64732e696f2f67656d2f762f68746d6c2d746f2d6d61726b646f776e3f6c6162656c3d5275627926636f6c6f723d303037656336) ](https://rubygems.org/gems/html-to-markdown) [ ![Elixir](https://camo.githubusercontent.com/970b7fe0422be681afedf7ea2c00c2bd2f44da7436c4679e7a6990e64ffefd44/68747470733a2f2f696d672e736869656c64732e696f2f686578706d2f762f68746d6c5f746f5f6d61726b646f776e3f6c6162656c3d456c6978697226636f6c6f723d303037656336) ](https://hex.pm/packages/html_to_markdown) [ ![R](https://camo.githubusercontent.com/f1a0b15ace52ad38450104c2a5293dd61c561fd3cbb27dbf2ba3b89cfde2010d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f522d68746d6c746f6d61726b646f776e2d303037656336) ](https://xberg-io.r-universe.dev/htmltomarkdown) [ ![Dart](https://camo.githubusercontent.com/41aa058c654c32f1c4a0a012ba89d0515a58fb6c0c878f1d5495bfe84bb46df6/68747470733a2f2f696d672e736869656c64732e696f2f7075622f762f68326d3f6c6162656c3d4461727426636f6c6f723d303037656336) ](https://pub.dev/packages/h2m) [ ![Kotlin](https://camo.githubusercontent.com/d51217c5d0ad04db5ef94ef8ebe28a3973d25ea769205ffbf84e590d3405887c/68747470733a2f2f696d672e736869656c64732e696f2f6d6176656e2d63656e7472616c2f762f696f2e78626572672f68746d6c2d746f2d6d61726b646f776e2d616e64726f69643f6c6162656c3d4b6f746c696e26636f6c6f723d303037656336) ](https://central.sonatype.com/artifact/io.xberg/html-to-markdown-android) [ ![Swift](https://camo.githubusercontent.com/b8e3c9990c66f8b878644a15e0ffd0fba03df291119bca044b94033c83d27246/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53776966742d53504d2d303037656336) ](https://github.com/xberg-io/html-to-markdown/tree/main/packages/swift) [ ![Zig](https://camo.githubusercontent.com/376558d850c9af32b9d23b0211489a0b5c979af703256fa0b7c3e917bd591c53/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5a69672d7061636b6167652d303037656336) ](https://github.com/xberg-io/html-to-markdown/tree/main/packages/zig) [ ![C FFI](https://camo.githubusercontent.com/41b9c58c3810775402965a3a7652da9832ea83391c1ff255081e5551900db8f2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f432d4646492d303037656336) ](https://github.com/xberg-io/html-to-markdown/releases) [ ![License](https://camo.githubusercontent.com/0cd4d42d83d2124c29737dd1519425c87c4b465016ef0cee20cbcb8ef420c0e0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d303037656336) ](https://github.com/xberg-io/html-to-markdown/blob/main/LICENSE) [ ![Documentation](https://camo.githubusercontent.com/8531cb23a6ba930a1743eb1bf7187f9235844962722243255286ae2bd27287d9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f63732d68746d6c2d2d746f2d2d6d61726b646f776e2d303037656336) ](https://docs.html-to-markdown.xberg.io) [ ![Join Discord](https://camo.githubusercontent.com/c3d59355bb5f7fc8224936ba897a06b87e5ba6f52bd08dfd2f7f78bf669c550d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446973636f72642d436861742d3030376563363f6c6f676f3d646973636f7264266c6f676f436f6c6f723d7768697465) ](https://discord.gg/xt9WY3GnKR) [ ![Live Demo](https://camo.githubusercontent.com/f4ded88061eb110a708c51d9476bd2fe28b1434b3353e4dae241902beef23025/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c69766525323044656d6f2d4f70656e2d3030376563363f6c6f676f3d776562617373656d626c79266c6f676f436f6c6f723d7768697465) ](https://docs.html-to-markdown.xberg.io/demo/) Turn messy, real-world HTML into clean Markdown — from the language you already work in. What and Why? ------------- [](#what-and-why) Feed html-to-markdown the HTML you actually have — unclosed tags, CDATA, custom elements, broken entities, nested tables, mixed encodings — and get back clean CommonMark (or Djot) without losing content. One `convert()` call does it, and it returns the same result whether you run it from Python, TypeScript, Go, Ruby, Java, or 11 more languages. You get more than the text: pull page metadata (Open Graph, Twitter, JSON-LD) and structured tables in the same pass, or hook into the conversion to reshape the output. It is fast enough for whole-corpus jobs, and the messy-input handling is automatic — you never choose a parsing strategy or tune anything to get correct output. ### Features [](#features) FeatureDescription**16 languages, one Rust core**Rust, Python, Node.js, WASM, Java, Go, C#, PHP, Ruby, Elixir, R, Dart, Kotlin (Android), Swift, Zig, and a C ABI**Tiered dispatch**Byte scanner → DOM walker → `html5ever` repair, with byte-equal output across tiers**Real-HTML robust**Unclosed tags, CDATA, custom elements, malformed entities, nested tables, mixed encodings — handled without losing content**GFM tables**Padded cells, alignment, and pipe escaping**Djot output**Set `output_format = "djot"` to emit Djot instead of Markdown**Metadata extraction**Parse `` into structured metadata (Open Graph, Twitter, JSON-LD, microdata, RDFa, header hierarchy)**Inline images**Opt-in mirroring of data URIs and remote image references**Visitor API**Feature-gated traversal to transform the converted Markdown AST**Configurable preprocessing**Standard, strict, and lenient presets — or build your own**Fast**19–116 MB/s on the Wikipedia/mdream corpus; per-group regression thresholds enforced on every PR [ ![Star html-to-markdown on GitHub](docs/assets/star.gif) ](https://github.com/xberg-io/html-to-markdown/stargazers) **⭐ Star this repo to show your support — it helps others discover html-to-markdown.** Quick Start ----------- [](#quick-start) `convert()` is the single entry point — it returns a structured result with `content`, `warnings`, and optional `metadata`. ### Language Packages [](#language-packages) **Rust**``` cargo add html-to-markdown-rs ``` See [Rust README](https://github.com/xberg-io/html-to-markdown/tree/main/crates/html-to-markdown) for full documentation. **Python**``` pip install html-to-markdown ``` See [Python README](https://github.com/xberg-io/html-to-markdown/tree/main/packages/python) for full documentation. **Node.js**``` npm install @xberg-io/html-to-markdown ``` See [Node.js README](https://github.com/xberg-io/html-to-markdown/tree/main/crates/html-to-markdown-node) for full documentation. **Go**``` go get github.com/xberg-io/html-to-markdown/packages/go/v3 ``` See [Go README](https://github.com/xberg-io/html-to-markdown/tree/main/packages/go) for full documentation. **Java**Available on Maven Central as `io.xberg:html-to-markdown`. See [Java README](https://github.com/xberg-io/html-to-markdown/tree/main/packages/java) for the dependency snippet and current version. **C#**``` dotnet add package XbergIo.HtmlToMarkdown ``` See [C# README](https://github.com/xberg-io/html-to-markdown/tree/main/packages/csharp) for full documentation. **Ruby**``` gem install html-to-markdown ``` See [Ruby README](https://github.com/xberg-io/html-to-markdown/tree/main/packages/ruby) for full documentation. **PHP**This is a native PHP extension (Rust `ext-php-rs`), so install it with [PIE](https://github.com/php/pie) — not `composer require`: ``` pie install xberg-io/html-to-markdown ``` See [PHP README](https://github.com/xberg-io/html-to-markdown/tree/main/packages/php) for full documentation. **Elixir**Add `{:html_to_markdown, "~> 3.6"}` to your `mix.exs` dependencies. See [Elixir README](https://github.com/xberg-io/html-to-markdown/tree/main/packages/elixir) for full documentation. **R**``` install.packages("htmltomarkdown", repos = "https://xberg-io.r-universe.dev") ``` See [R README](https://github.com/xberg-io/html-to-markdown/tree/main/packages/r) for full documentation. **Dart / Flutter**``` dart pub add h2m ``` See [Dart README](https://github.com/xberg-io/html-to-markdown/tree/main/packages/dart) for full documentation. **Kotlin (Android)**Available on Maven Central as `io.xberg:html-to-markdown-android`. See [Kotlin README](https://github.com/xberg-io/html-to-markdown/tree/main/packages/kotlin-android) for the dependency snippet and current version. **Swift**Add via Swift Package Manager. See [Swift README](https://github.com/xberg-io/html-to-markdown/tree/main/packages/swift) for full documentation. **Zig**See [Zig README](https://github.com/xberg-io/html-to-markdown/tree/main/packages/zig) for installation and usage. **WebAssembly**``` npm install @xberg-io/html-to-markdown-wasm ``` See [WebAssembly README](https://github.com/xberg-io/html-to-markdown/tree/main/crates/html-to-markdown-wasm) for full documentation. **C/C++ (FFI)**Pre-built `.so` / `.dll` / `.dylib` from [GitHub Releases](https://github.com/xberg-io/html-to-markdown/releases). See [FFI crate](https://github.com/xberg-io/html-to-markdown/tree/main/crates/html-to-markdown-ffi) for full documentation. **CLI**``` cargo install html-to-markdown-cli ``` ``` # Or install the prebuilt binary via cargo-binstall: cargo binstall html-to-markdown-cli ``` ``` brew install xberg-io/tap/html-to-markdown ``` See [CLI usage](https://docs.html-to-markdown.xberg.io) for full documentation. ### AI Coding Assistants [](#ai-coding-assistants) Install the html-to-markdown plugin from [`xberg-io/html-to-markdown`](https://github.com/xberg-io/html-to-markdown). It ships the html-to-markdown agent skills and works with every major coding agent — expand your harness below. **Claude Code**``` /plugin marketplace add xberg-io/html-to-markdown /plugin install html-to-markdown@html-to-markdown ``` **Codex CLI**``` /plugins add https://github.com/xberg-io/html-to-markdown ``` Then search for `html-to-markdown` and select **Install Plugin**. **Cursor**Settings → Plugins → Add from URL → `https://github.com/xberg-io/html-to-markdown`, then select **html-to-markdown**. **Gemini CLI**``` gemini extensions install https://github.com/xberg-io/html-to-markdown ``` **Factory Droid**``` droid plugin marketplace add https://github.com/xberg-io/html-to-markdown droid plugin install html-to-markdown@html-to-markdown ``` **GitHub Copilot CLI**``` copilot plugin marketplace add https://github.com/xberg-io/html-to-markdown copilot plugin install html-to-markdown@html-to-markdown ``` **opencode**Add the package to `opencode.json`: ``` { "$schema": "https://opencode.ai/config.json", "plugin": ["@xberg-io/opencode-html-to-markdown"] } ``` Documentation ------------- [](#documentation) Full guides, the `convert()` API for every binding, tier architecture, the metadata and visitor APIs, and performance benchmarks live at **[docs.html-to-markdown.xberg.io](https://docs.html-to-markdown.xberg.io)**. Part of Xberg.io ---------------- [](#part-of-xbergio) - [Xberg](https://github.com/xberg-io/xberg) — the open-source content-intelligence engine: text, tables, and metadata from 101 formats (115 file extensions), with OCR, transcription, and code intelligence. MIT. - [Xberg Pro](https://xberg.io) — a complete self-hosted content-intelligence backend in a single container. Commercial. - [Xberg Enterprise](https://xberg.io) — the distributed, governed content-intelligence platform, scaled on Kubernetes with team governance and support. Commercial. - [crawlberg](https://github.com/xberg-io/crawlberg) — web crawling and scraping with HTML→Markdown and headless-Chrome fallback. - [html-to-markdown](https://github.com/xberg-io/html-to-markdown) — fast, lossless HTML→Markdown engine. - [liter-llm](https://github.com/xberg-io/liter-llm) — universal LLM API client with native bindings for 14 languages and 165 providers. - [tree-sitter-language-pack](https://github.com/xberg-io/tree-sitter-language-pack) — tree-sitter grammars and code-intelligence primitives. - [alef](https://github.com/xberg-io/alef) — the polyglot binding generator that produces every per-language binding across the 5 polyglot repos. Contributing ------------ [](#contributing) Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions and guidelines. License ------- [](#license) MIT License — see [LICENSE](LICENSE) for details. ### Health Score 58 — FairBetter than 98% of packages Maintenance91 Actively maintained with recent releases Popularity36 Limited adoption so far Community30 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor1 Top contributor holds 85.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~1 days Total 135 Last Release 76d ago Major Versions v2.15.0 → v4.0.0-rc.162025-12-22 2.30.0 → v3.x-dev2026-03-30 PHP version history (3 changes)v2.5.7PHP ^8.2 2.24.6PHP ^8.4 v3.5.0-rc.1PHP >=8.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/30733348?v=4)[Na'aman Hirschfeld](/maintainers/Goldziher)[@Goldziher](https://github.com/Goldziher) --- Top Contributors [![Goldziher](https://avatars.githubusercontent.com/u/30733348?v=4)](https://github.com/Goldziher "Goldziher (2425 commits)")[![AlexVonB](https://avatars.githubusercontent.com/u/7325664?v=4)](https://github.com/AlexVonB "AlexVonB (130 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (91 commits)")[![matthewwithanm](https://avatars.githubusercontent.com/u/126263?v=4)](https://github.com/matthewwithanm "matthewwithanm (55 commits)")[![andredelft](https://avatars.githubusercontent.com/u/32297879?v=4)](https://github.com/andredelft "andredelft (13 commits)")[![kh3rld](https://avatars.githubusercontent.com/u/171191586?v=4)](https://github.com/kh3rld "kh3rld (11 commits)")[![Mkalbani](https://avatars.githubusercontent.com/u/112591148?v=4)](https://github.com/Mkalbani "Mkalbani (11 commits)")[![v-tan](https://avatars.githubusercontent.com/u/22367932?v=4)](https://github.com/v-tan "v-tan (10 commits)")[![nickovs](https://avatars.githubusercontent.com/u/4205868?v=4)](https://github.com/nickovs "nickovs (9 commits)")[![SimonIT](https://avatars.githubusercontent.com/u/11720038?v=4)](https://github.com/SimonIT "SimonIT (8 commits)")[![BrunoMiguens](https://avatars.githubusercontent.com/u/6075268?v=4)](https://github.com/BrunoMiguens "BrunoMiguens (8 commits)")[![dietervansteenwegen](https://avatars.githubusercontent.com/u/46349482?v=4)](https://github.com/dietervansteenwegen "dietervansteenwegen (6 commits)")[![pratik-mahalle](https://avatars.githubusercontent.com/u/124587957?v=4)](https://github.com/pratik-mahalle "pratik-mahalle (5 commits)")[![jfouret](https://avatars.githubusercontent.com/u/30047021?v=4)](https://github.com/jfouret "jfouret (4 commits)")[![bbeardsley](https://avatars.githubusercontent.com/u/9709?v=4)](https://github.com/bbeardsley "bbeardsley (4 commits)")[![chrispy-snps](https://avatars.githubusercontent.com/u/50950969?v=4)](https://github.com/chrispy-snps "chrispy-snps (4 commits)")[![ivanova-gif](https://avatars.githubusercontent.com/u/247880403?v=4)](https://github.com/ivanova-gif "ivanova-gif (4 commits)")[![tlp-red](https://avatars.githubusercontent.com/u/57686909?v=4)](https://github.com/tlp-red "tlp-red (4 commits)")[![jsm28](https://avatars.githubusercontent.com/u/10537793?v=4)](https://github.com/jsm28 "jsm28 (3 commits)")[![idvorkin](https://avatars.githubusercontent.com/u/280981?v=4)](https://github.com/idvorkin "idvorkin (3 commits)") --- Tags hocrhtmlhtml-convertermarkdownmarkdown-converterragtext-extractiontext-processinghtmlconvertermarkdown ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/kreuzberg-dev-html-to-markdown/health.svg) ``` [![Health](https://phpackages.com/badges/kreuzberg-dev-html-to-markdown/health.svg)](https://phpackages.com/packages/kreuzberg-dev-html-to-markdown) ``` ### Alternatives [league/html-to-markdown An HTML-to-markdown conversion helper for PHP 1.9k33.5M370](/packages/league-html-to-markdown)[pixel418/markdownify The HTML to Markdown converter for PHP 196897.8k8](/packages/pixel418-markdownify)[texy/texy Texy converts plain text in easy to read Texy syntax into structurally valid (X)HTML. It supports adding of images, links, nested lists, tables and has full support for CSS. Texy supports hyphenation of long words (which reflects language rules), clickable emails and URL (emails are obfuscated against spambots), national typographic single and double quotation marks, ellipses, em dashes, dimension sign, nonbreakable spaces (e.g. in phone numbers), acronyms, arrows and many others. Texy code can optionally contain HTML tags. 159870.0k15](/packages/texy-texy)[3f/converter A set of classes to translate a text from HTML to BBcode and from BBCode to Markdown. 29155.1k](/packages/3f-converter)[interaction-design-foundation/nova-html-card A Laravel Nova card to display arbitrary HTML content 68899.8k4](/packages/interaction-design-foundation-nova-html-card)[kartik-v/yii2-markdown Advanced Markdown editing and conversion utilities for Yii Framework 2.0 89276.5k6](/packages/kartik-v-yii2-markdown) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)