@kreuzberg/html-to-markdown-wasm 3.4.1 → 3.5.0-rc.1

package/pkg/deno/html_to_markdown_wasm_bg.wasm.d.ts

@@ -1,8 +1,8 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
+export const __wbg_wasmannotationkind_free: (a: number, b: number) => void;
 export const __wbg_wasmconversionoptions_free: (a: number, b: number) => void;
-export const __wbg_wasmconversionoptionsbuilder_free: (a: number, b: number) => void;
 export const __wbg_wasmconversionoptionsupdate_free: (a: number, b: number) => void;
 export const __wbg_wasmconversionresult_free: (a: number, b: number) => void;
 export const __wbg_wasmdocumentmetadata_free: (a: number, b: number) => void;
@@ -13,6 +13,7 @@ export const __wbg_wasmheadermetadata_free: (a: number, b: number) => void;
 export const __wbg_wasmhtmlmetadata_free: (a: number, b: number) => void;
 export const __wbg_wasmimagemetadata_free: (a: number, b: number) => void;
 export const __wbg_wasmlinkmetadata_free: (a: number, b: number) => void;
+export const __wbg_wasmnodecontent_free: (a: number, b: number) => void;
 export const __wbg_wasmnodecontext_free: (a: number, b: number) => void;
 export const __wbg_wasmpreprocessingoptions_free: (a: number, b: number) => void;
 export const __wbg_wasmprocessingwarning_free: (a: number, b: number) => void;
@@ -22,14 +23,20 @@ export const __wbg_wasmtablegrid_free: (a: number, b: number) => void;
 export const __wbg_wasmtextannotation_free: (a: number, b: number) => void;
 export const __wbg_wasmvisitorhandle_free: (a: number, b: number) => void;
 export const convert: (a: number, b: number, c: number, d: number) => void;
-export const wasmconversionoptions_applyUpdate: (a: number, b: number) => void;
+export const wasmannotationkind_annotationType: (a: number, b: number) => void;
+export const wasmannotationkind_default: () => number;
+export const wasmannotationkind_set_annotationType: (a: number, b: number, c: number) => void;
+export const wasmannotationkind_set_title: (a: number, b: number, c: number) => void;
+export const wasmannotationkind_set_url: (a: number, b: number, c: number) => void;
+export const wasmannotationkind_title: (a: number, b: number) => void;
+export const wasmannotationkind_url: (a: number, b: number) => void;
 export const wasmconversionoptions_autolinks: (a: number) => number;
 export const wasmconversionoptions_brInTables: (a: number) => number;
-export const wasmconversionoptions_builder: () => number;
 export const wasmconversionoptions_bullets: (a: number, b: number) => void;
 export const wasmconversionoptions_captureSvg: (a: number) => number;
 export const wasmconversionoptions_codeBlockStyle: (a: number, b: number) => void;
 export const wasmconversionoptions_codeLanguage: (a: number, b: number) => void;
+export const wasmconversionoptions_compactTables: (a: number) => number;
 export const wasmconversionoptions_convertAsInline: (a: number) => number;
 export const wasmconversionoptions_debug: (a: number) => number;
 export const wasmconversionoptions_default: () => number;
@@ -42,8 +49,6 @@ export const wasmconversionoptions_escapeUnderscores: (a: number) => number;
 export const wasmconversionoptions_excludeSelectors: (a: number, b: number) => void;
 export const wasmconversionoptions_extractImages: (a: number) => number;
 export const wasmconversionoptions_extractMetadata: (a: number) => number;
-export const wasmconversionoptions_from: (a: number) => number;
-export const wasmconversionoptions_fromUpdate: (a: number) => number;
 export const wasmconversionoptions_headingStyle: (a: number, b: number) => void;
 export const wasmconversionoptions_highlightStyle: (a: number, b: number) => void;
 export const wasmconversionoptions_includeDocumentStructure: (a: number) => number;
@@ -54,7 +59,7 @@ export const wasmconversionoptions_listIndentType: (a: number, b: number) => voi
 export const wasmconversionoptions_listIndentWidth: (a: number) => number;
 export const wasmconversionoptions_maxDepth: (a: number) => number;
 export const wasmconversionoptions_maxImageSize: (a: number) => bigint;
-export const wasmconversionoptions_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number, y: number, z: number, a1: number, b1: number, c1: number, d1: number, e1: number, f1: number, g1: number, h1: number, i1: number, j1: number, k1: number, l1: number, m1: number, n1: number, o1: number, p1: number, q1: number, r1: number, s1: number, t1: bigint, u1: number, v1: number, w1: number, x1: number, y1: number) => number;
+export const wasmconversionoptions_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number, y: number, z: number, a1: number, b1: number, c1: number, d1: number, e1: number, f1: number, g1: number, h1: number, i1: number, j1: number, k1: number, l1: number, m1: number, n1: number, o1: number, p1: number, q1: number, r1: number, s1: number, t1: number, u1: bigint, v1: number, w1: number, x1: number, y1: number, z1: number) => number;
 export const wasmconversionoptions_newlineStyle: (a: number, b: number) => void;
 export const wasmconversionoptions_outputFormat: (a: number, b: number) => void;
 export const wasmconversionoptions_preprocessing: (a: number) => number;
@@ -65,6 +70,7 @@ export const wasmconversionoptions_set_bullets: (a: number, b: number, c: number
 export const wasmconversionoptions_set_captureSvg: (a: number, b: number) => void;
 export const wasmconversionoptions_set_codeBlockStyle: (a: number, b: number) => void;
 export const wasmconversionoptions_set_codeLanguage: (a: number, b: number, c: number) => void;
+export const wasmconversionoptions_set_compactTables: (a: number, b: number) => void;
 export const wasmconversionoptions_set_convertAsInline: (a: number, b: number) => void;
 export const wasmconversionoptions_set_debug: (a: number, b: number) => void;
 export const wasmconversionoptions_set_defaultTitle: (a: number, b: number) => void;
@@ -110,19 +116,13 @@ export const wasmconversionoptions_visitor: (a: number) => number;
 export const wasmconversionoptions_whitespaceMode: (a: number, b: number) => void;
 export const wasmconversionoptions_wrap: (a: number) => number;
 export const wasmconversionoptions_wrapWidth: (a: number) => number;
-export const wasmconversionoptionsbuilder_build: (a: number) => number;
-export const wasmconversionoptionsbuilder_excludeSelectors: (a: number, b: number, c: number) => number;
-export const wasmconversionoptionsbuilder_keepInlineImagesIn: (a: number, b: number, c: number) => number;
-export const wasmconversionoptionsbuilder_preprocessing: (a: number, b: number) => number;
-export const wasmconversionoptionsbuilder_preserveTags: (a: number, b: number, c: number) => number;
-export const wasmconversionoptionsbuilder_stripTags: (a: number, b: number, c: number) => number;
-export const wasmconversionoptionsbuilder_visitor: (a: number, b: number) => number;
 export const wasmconversionoptionsupdate_autolinks: (a: number) => number;
 export const wasmconversionoptionsupdate_brInTables: (a: number) => number;
 export const wasmconversionoptionsupdate_bullets: (a: number, b: number) => void;
 export const wasmconversionoptionsupdate_captureSvg: (a: number) => number;
 export const wasmconversionoptionsupdate_codeBlockStyle: (a: number, b: number) => void;
 export const wasmconversionoptionsupdate_codeLanguage: (a: number, b: number) => void;
+export const wasmconversionoptionsupdate_compactTables: (a: number) => number;
 export const wasmconversionoptionsupdate_convertAsInline: (a: number) => number;
 export const wasmconversionoptionsupdate_debug: (a: number) => number;
 export const wasmconversionoptionsupdate_default: () => number;
@@ -145,7 +145,7 @@ export const wasmconversionoptionsupdate_listIndentType: (a: number, b: number)
 export const wasmconversionoptionsupdate_listIndentWidth: (a: number) => number;
 export const wasmconversionoptionsupdate_maxDepth: (a: number) => number;
 export const wasmconversionoptionsupdate_maxImageSize: (a: number, b: number) => void;
-export const wasmconversionoptionsupdate_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number, y: number, z: number, a1: number, b1: number, c1: number, d1: number, e1: number, f1: number, g1: number, h1: number, i1: number, j1: number, k1: number, l1: number, m1: number, n1: number, o1: number, p1: number, q1: number, r1: number, s1: number, t1: bigint, u1: number, v1: number, w1: number, x1: number, y1: number) => number;
+export const wasmconversionoptionsupdate_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number, y: number, z: number, a1: number, b1: number, c1: number, d1: number, e1: number, f1: number, g1: number, h1: number, i1: number, j1: number, k1: number, l1: number, m1: number, n1: number, o1: number, p1: number, q1: number, r1: number, s1: number, t1: number, u1: bigint, v1: number, w1: number, x1: number, y1: number, z1: number) => number;
 export const wasmconversionoptionsupdate_newlineStyle: (a: number, b: number) => void;
 export const wasmconversionoptionsupdate_outputFormat: (a: number, b: number) => void;
 export const wasmconversionoptionsupdate_preprocessing: (a: number) => number;
@@ -156,6 +156,7 @@ export const wasmconversionoptionsupdate_set_bullets: (a: number, b: number, c:
 export const wasmconversionoptionsupdate_set_captureSvg: (a: number, b: number) => void;
 export const wasmconversionoptionsupdate_set_codeBlockStyle: (a: number, b: number) => void;
 export const wasmconversionoptionsupdate_set_codeLanguage: (a: number, b: number, c: number) => void;
+export const wasmconversionoptionsupdate_set_compactTables: (a: number, b: number) => void;
 export const wasmconversionoptionsupdate_set_convertAsInline: (a: number, b: number) => void;
 export const wasmconversionoptionsupdate_set_debug: (a: number, b: number) => void;
 export const wasmconversionoptionsupdate_set_defaultTitle: (a: number, b: number) => void;
@@ -242,7 +243,7 @@ export const wasmdocumentmetadata_twitterCard: (a: number) => number;
 export const wasmdocumentnode_annotations: (a: number, b: number) => void;
 export const wasmdocumentnode_attributes: (a: number) => number;
 export const wasmdocumentnode_children: (a: number, b: number) => void;
-export const wasmdocumentnode_content: (a: number, b: number) => void;
+export const wasmdocumentnode_content: (a: number) => number;
 export const wasmdocumentnode_default: () => number;
 export const wasmdocumentnode_id: (a: number, b: number) => void;
 export const wasmdocumentnode_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => number;
@@ -311,7 +312,6 @@ export const wasmimagemetadata_set_title: (a: number, b: number, c: number) => v
 export const wasmimagemetadata_src: (a: number, b: number) => void;
 export const wasmimagemetadata_title: (a: number, b: number) => void;
 export const wasmlinkmetadata_attributes: (a: number) => number;
-export const wasmlinkmetadata_classifyLink: (a: number, b: number) => number;
 export const wasmlinkmetadata_default: () => number;
 export const wasmlinkmetadata_href: (a: number, b: number) => void;
 export const wasmlinkmetadata_linkType: (a: number, b: number) => void;
@@ -325,6 +325,39 @@ export const wasmlinkmetadata_set_text: (a: number, b: number, c: number) => voi
 export const wasmlinkmetadata_set_title: (a: number, b: number, c: number) => void;
 export const wasmlinkmetadata_text: (a: number, b: number) => void;
 export const wasmlinkmetadata_title: (a: number, b: number) => void;
+export const wasmnodecontent_content: (a: number, b: number) => void;
+export const wasmnodecontent_default: () => number;
+export const wasmnodecontent_definition: (a: number, b: number) => void;
+export const wasmnodecontent_description: (a: number, b: number) => void;
+export const wasmnodecontent_entries: (a: number) => number;
+export const wasmnodecontent_format: (a: number, b: number) => void;
+export const wasmnodecontent_grid: (a: number) => number;
+export const wasmnodecontent_headingLevel: (a: number) => number;
+export const wasmnodecontent_headingText: (a: number, b: number) => void;
+export const wasmnodecontent_label: (a: number, b: number) => void;
+export const wasmnodecontent_language: (a: number, b: number) => void;
+export const wasmnodecontent_level: (a: number) => number;
+export const wasmnodecontent_nodeType: (a: number, b: number) => void;
+export const wasmnodecontent_ordered: (a: number) => number;
+export const wasmnodecontent_set_content: (a: number, b: number, c: number) => void;
+export const wasmnodecontent_set_definition: (a: number, b: number, c: number) => void;
+export const wasmnodecontent_set_description: (a: number, b: number, c: number) => void;
+export const wasmnodecontent_set_entries: (a: number, b: number) => void;
+export const wasmnodecontent_set_format: (a: number, b: number, c: number) => void;
+export const wasmnodecontent_set_grid: (a: number, b: number) => void;
+export const wasmnodecontent_set_headingLevel: (a: number, b: number) => void;
+export const wasmnodecontent_set_headingText: (a: number, b: number, c: number) => void;
+export const wasmnodecontent_set_label: (a: number, b: number, c: number) => void;
+export const wasmnodecontent_set_language: (a: number, b: number, c: number) => void;
+export const wasmnodecontent_set_level: (a: number, b: number) => void;
+export const wasmnodecontent_set_nodeType: (a: number, b: number, c: number) => void;
+export const wasmnodecontent_set_ordered: (a: number, b: number) => void;
+export const wasmnodecontent_set_src: (a: number, b: number, c: number) => void;
+export const wasmnodecontent_set_term: (a: number, b: number, c: number) => void;
+export const wasmnodecontent_set_text: (a: number, b: number, c: number) => void;
+export const wasmnodecontent_src: (a: number, b: number) => void;
+export const wasmnodecontent_term: (a: number, b: number) => void;
+export const wasmnodecontent_text: (a: number, b: number) => void;
 export const wasmnodecontext_attributes: (a: number) => number;
 export const wasmnodecontext_default: () => number;
 export const wasmnodecontext_indexInParent: (a: number) => number;
@@ -339,10 +372,8 @@ export const wasmnodecontext_set_nodeType: (a: number, b: number) => void;
 export const wasmnodecontext_set_parentTag: (a: number, b: number, c: number) => void;
 export const wasmnodecontext_set_tagName: (a: number, b: number, c: number) => void;
 export const wasmnodecontext_tagName: (a: number, b: number) => void;
-export const wasmpreprocessingoptions_applyUpdate: (a: number, b: number) => void;
 export const wasmpreprocessingoptions_default: () => number;
 export const wasmpreprocessingoptions_enabled: (a: number) => number;
-export const wasmpreprocessingoptions_from: (a: number) => number;
 export const wasmpreprocessingoptions_new: (a: number, b: number, c: number, d: number) => number;
 export const wasmpreprocessingoptions_preset: (a: number, b: number) => void;
 export const wasmpreprocessingoptions_removeForms: (a: number) => number;
@@ -387,22 +418,25 @@ export const wasmtablegrid_new: (a: number, b: number, c: number, d: number) =>
 export const wasmtablegrid_set_cells: (a: number, b: number, c: number) => void;
 export const wasmtextannotation_default: () => number;
 export const wasmtextannotation_end: (a: number) => number;
-export const wasmtextannotation_kind: (a: number, b: number) => void;
+export const wasmtextannotation_kind: (a: number) => number;
 export const wasmtextannotation_new: (a: number, b: number, c: number) => number;
 export const wasmtextannotation_set_end: (a: number, b: number) => void;
 export const wasmtextannotation_set_kind: (a: number, b: number) => void;
 export const wasmtextannotation_set_start: (a: number, b: number) => void;
 export const wasmtextannotation_start: (a: number) => number;
 export const wasmvisitorhandle_new: (a: number) => number;
-export const wasmpreprocessingoptions_fromUpdate: (a: number) => number;
+export const wasmnodecontent_new: () => number;
 export const wasmheadermetadata_set_depth: (a: number, b: number) => void;
 export const wasmnodecontext_set_depth: (a: number, b: number) => void;
 export const wasmtablegrid_set_cols: (a: number, b: number) => void;
 export const wasmtablegrid_set_rows: (a: number, b: number) => void;
+export const wasmnodecontent_set_imageIndex: (a: number, b: number) => void;
 export const wasmheadermetadata_depth: (a: number) => number;
 export const wasmnodecontext_depth: (a: number) => number;
 export const wasmtablegrid_cols: (a: number) => number;
 export const wasmtablegrid_rows: (a: number) => number;
+export const wasmannotationkind_new: () => number;
+export const wasmnodecontent_imageIndex: (a: number) => number;
 export const __wbg_wasmpreprocessingoptionsupdate_free: (a: number, b: number) => void;
 export const __wbindgen_export: (a: number, b: number) => number;
 export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;

package/pkg/nodejs/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright 2024-2025 Na'aman Hirschfeld
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/pkg/nodejs/README.md

@@ -0,0 +1,233 @@
+# html-to-markdown
+
+<div align="center" style="display: flex; flex-wrap: wrap; gap: 8px; justify-content: center; margin: 20px 0;">
+  <a href="https://github.com/kreuzberg-dev/alef">
+    <img src="https://img.shields.io/badge/Bindings-alef%20%D7%90-007ec6" alt="Bindings">
+  </a>
+  <!-- Language Bindings -->
+  <a href="https://crates.io/crates/html-to-markdown-rs">
+    <img src="https://img.shields.io/crates/v/html-to-markdown-rs?label=Rust&color=007ec6" alt="Rust">
+  </a>
+  <a href="https://pypi.org/project/html-to-markdown/">
+    <img src="https://img.shields.io/pypi/v/html-to-markdown?label=Python&color=007ec6" alt="Python">
+  </a>
+  <a href="https://www.npmjs.com/package/@kreuzberg/html-to-markdown-node">
+    <img src="https://img.shields.io/npm/v/@kreuzberg/html-to-markdown-node?label=Node.js&color=007ec6" alt="Node.js">
+  </a>
+  <a href="https://www.npmjs.com/package/@kreuzberg/html-to-markdown-wasm">
+    <img src="https://img.shields.io/npm/v/@kreuzberg/html-to-markdown-wasm?label=WASM&color=007ec6" alt="WASM">
+  </a>
+  <a href="https://central.sonatype.com/artifact/dev.kreuzberg/html-to-markdown">
+    <img src="https://img.shields.io/maven-central/v/dev.kreuzberg/html-to-markdown?label=Java&color=007ec6" alt="Java">
+  </a>
+  <a href="https://pkg.go.dev/github.com/kreuzberg-dev/html-to-markdown/packages/go/v3/htmltomarkdown">
+    <img src="https://img.shields.io/github/v/tag/kreuzberg-dev/html-to-markdown?label=Go&color=007ec6&filter=v3*" alt="Go">
+  </a>
+  <a href="https://www.nuget.org/packages/KreuzbergDev.HtmlToMarkdown/">
+    <img src="https://img.shields.io/nuget/v/KreuzbergDev.HtmlToMarkdown?label=C%23&color=007ec6" alt="C#">
+  </a>
+  <a href="https://packagist.org/packages/kreuzberg-dev/html-to-markdown">
+    <img src="https://img.shields.io/packagist/v/kreuzberg-dev/html-to-markdown?label=PHP&color=007ec6" alt="PHP">
+  </a>
+  <a href="https://rubygems.org/gems/html-to-markdown">
+    <img src="https://img.shields.io/gem/v/html-to-markdown?label=Ruby&color=007ec6" alt="Ruby">
+  </a>
+  <a href="https://hex.pm/packages/html_to_markdown">
+    <img src="https://img.shields.io/hexpm/v/html_to_markdown?label=Elixir&color=007ec6" alt="Elixir">
+  </a>
+  <a href="https://kreuzberg-dev.r-universe.dev/htmltomarkdown">
+    <img src="https://img.shields.io/badge/R-htmltomarkdown-007ec6" alt="R">
+  </a>
+  <a href="https://pub.dev/packages/h2m">
+    <img src="https://img.shields.io/pub/v/h2m?label=Dart&color=007ec6" alt="Dart">
+  </a>
+  <a href="https://central.sonatype.com/artifact/dev.kreuzberg/html-to-markdown-android">
+    <img src="https://img.shields.io/maven-central/v/dev.kreuzberg/html-to-markdown-android?label=Kotlin&color=007ec6" alt="Kotlin">
+  </a>
+  <a href="https://github.com/kreuzberg-dev/html-to-markdown/tree/main/packages/swift">
+    <img src="https://img.shields.io/badge/Swift-SPM-007ec6" alt="Swift">
+  </a>
+  <a href="https://github.com/kreuzberg-dev/html-to-markdown/tree/main/packages/zig">
+    <img src="https://img.shields.io/badge/Zig-package-007ec6" alt="Zig">
+  </a>
+  <a href="https://github.com/kreuzberg-dev/html-to-markdown/releases">
+    <img src="https://img.shields.io/badge/C-FFI-007ec6" alt="C FFI">
+  </a>
+
+  <!-- Project Info -->
+  <a href="https://github.com/kreuzberg-dev/html-to-markdown/blob/main/LICENSE">
+    <img src="https://img.shields.io/badge/License-MIT-007ec6" alt="License">
+  </a>
+  <a href="https://docs.html-to-markdown.kreuzberg.dev">
+    <img src="https://img.shields.io/badge/Docs-html--to--markdown-007ec6" alt="Documentation">
+  </a>
+</div>
+
+<div align="center" style="margin: 24px 0 0;">
+  <a href="https://kreuzberg.dev">
+    <img alt="html-to-markdown" src="https://github.com/user-attachments/assets/478a83da-237b-446b-b3a8-e564c13e00a8" />
+  </a>
+</div>
+
+<div align="center" style="display: flex; flex-wrap: wrap; gap: 12px; justify-content: center; margin: 28px 0 24px;">
+  <a href="https://discord.gg/xt9WY3GnKR">
+    <img height="22" src="https://img.shields.io/badge/Discord-Chat-007ec6?logo=discord&logoColor=white" alt="Join Discord">
+  </a>
+  <a href="https://docs.html-to-markdown.kreuzberg.dev/demo/">
+    <img height="22" src="https://img.shields.io/badge/Live%20Demo-Open-007ec6?logo=webassembly&logoColor=white" alt="Live Demo">
+  </a>
+</div>
+
+Pure WebAssembly build of html-to-markdown for browsers, Deno, Cloudflare Workers, and other JS
+runtimes without a Node.js native-addon ABI. Single `.wasm` artifact loaded via `wasm-bindgen`,
+shipped with TypeScript types and dist targets for nodejs, web, bundler, and deno.
+
+## What This Package Provides
+
+- **Same renderer as every binding** — output matches Rust, Python, Node.js, Ruby, PHP, Go, Java, .NET, Elixir, R, Dart, Swift, Zig, C FFI, and WASM.
+- **Structured conversion result** — Markdown plus metadata, links, headings, images, tables, and warnings where the binding exposes them.
+- **Production defaults** — HTML is parsed with the Rust core, sanitized by default, and rendered without runtime-specific Markdown drift.
+
+## Installation
+
+```bash
+pnpm add @kreuzberg/html-to-markdown-wasm
+```
+
+## Performance Snapshot
+
+## Quick Start
+
+Basic conversion:
+
+```javascript
+import init, { convert } from "@kreuzberg/html-to-markdown-wasm";
+
+await init();
+
+const html = "<h1>Hello</h1><p>This is <strong>fast</strong>!</p>";
+const result = convert(html);
+const markdown = result.content;
+console.log(markdown);
+```
+
+With conversion options:
+
+```javascript
+import init, { convert } from "@kreuzberg/html-to-markdown-wasm";
+
+await init();
+
+const result = convert('<h1>Hello</h1><img src="pic.jpg">', {
+  headingStyle: "atx",
+  skipImages: true,
+});
+const markdown = result.content;
+console.log(markdown);
+```
+
+## API Reference
+
+### Core Function
+
+### Options
+
+**`ConversionOptions`** – Key configuration fields:
+
+- `heading_style`: Heading format (`"underlined"` | `"atx"` | `"atx_closed"`) — default: `"underlined"`
+- `list_indent_width`: Spaces per indent level — default: `2`
+- `bullets`: Bullet characters cycle — default: `"*+-"`
+- `wrap`: Enable text wrapping — default: `false`
+- `wrap_width`: Wrap at column — default: `80`
+- `code_language`: Default fenced code block language — default: none
+- `extract_metadata`: Enable metadata extraction into `result.metadata` — default: `false`
+- `extract_tables`: Enable structured table extraction into `result.tables` — default: `false`
+- `output_format`: Output markup format (`"markdown"` | `"djot"` | `"plain"`) — default: `"markdown"`
+
+## Djot Output Format
+
+The library supports converting HTML to [Djot](https://djot.net/), a lightweight markup language similar to Markdown but with a different syntax for some elements. Set `output_format` to `"djot"` to use this format.
+
+### Syntax Differences
+
+| Element        | Markdown   | Djot       |
+| -------------- | ---------- | ---------- |
+| Strong         | `**text**` | `*text*`   |
+| Emphasis       | `*text*`   | `_text_`   |
+| Strikethrough  | `~~text~~` | `{-text-}` |
+| Inserted/Added | N/A        | `{+text+}` |
+| Highlighted    | N/A        | `{=text=}` |
+| Subscript      | N/A        | `~text~`   |
+| Superscript    | N/A        | `^text^`   |
+
+### Example Usage
+
+Djot's extended syntax allows you to express more semantic meaning in lightweight text, making it useful for documents that require strikethrough, insertion tracking, or mathematical notation.
+
+## Plain Text Output
+
+Set `output_format` to `"plain"` to strip all markup and return only visible text. This bypasses the Markdown conversion pipeline entirely for maximum speed.
+
+Plain text mode is useful for search indexing, text extraction, and feeding content to LLMs.
+
+## Metadata Extraction
+
+The metadata extraction feature enables comprehensive document analysis during conversion. Extract document properties, headers, links, images, and structured data in a single pass — all via the standard `convert()` function.
+
+**Use Cases:**
+
+- **SEO analysis** – Extract title, description, Open Graph tags, Twitter cards
+- **Table of contents generation** – Build structured outlines from heading hierarchy
+- **Content migration** – Document all external links and resources
+- **Accessibility audits** – Check for images without alt text, empty links, invalid heading hierarchy
+- **Link validation** – Classify and validate anchor, internal, external, email, and phone links
+
+**Zero Overhead When Disabled:** Metadata extraction adds negligible overhead and happens during the HTML parsing pass. Pass `extract_metadata: true` in `ConversionOptions` to enable it; the result is available at `result.metadata`.
+
+### Example: Quick Start
+
+## Examples
+
+## Links
+
+- **GitHub:** [github.com/kreuzberg-dev/html-to-markdown](https://github.com/kreuzberg-dev/html-to-markdown)
+- **Discord:** [discord.gg/xt9WY3GnKR](https://discord.gg/xt9WY3GnKR)
+
+## Part of Kreuzberg.dev
+
+- [Kreuzberg](https://github.com/kreuzberg-dev/kreuzberg) — document intelligence: text, tables, metadata from 90+ formats with optional OCR.
+- [Kreuzberg Cloud](https://github.com/kreuzberg-dev/kreuzberg-cloud) — managed extraction API with SDKs, dashboards, and observability.
+- [kreuzcrawl](https://github.com/kreuzberg-dev/kreuzcrawl) — web crawling and scraping with HTML→Markdown and headless-Chrome fallback.
+- [liter-llm](https://github.com/kreuzberg-dev/liter-llm) — universal LLM API client with native bindings for 14 languages and 143 providers.
+- [tree-sitter-language-pack](https://github.com/kreuzberg-dev/tree-sitter-language-pack) — tree-sitter grammars and code-intelligence primitives.
+- [alef](https://github.com/kreuzberg-dev/alef) — the polyglot binding generator that produces every per-language binding across the 5 polyglot repos.
+- [Discord](https://discord.gg/xt9WY3GnKR) — community, roadmap, announcements.
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](https://github.com/kreuzberg-dev/html-to-markdown/blob/main/CONTRIBUTING.md) for details on:
+
+- Setting up the development environment
+- Running tests locally
+- Submitting pull requests
+- Reporting issues
+
+All contributions must follow our code quality standards (enforced via pre-commit hooks):
+
+- Proper test coverage (Rust 95%+, language bindings 80%+)
+- Formatting and linting checks
+- Documentation for public APIs
+
+## License
+
+MIT License – see [LICENSE](https://github.com/kreuzberg-dev/html-to-markdown/blob/main/LICENSE). Copyright © Kreuzberg, Inc.
+
+## Support
+
+If you find this library useful, consider [sponsoring the project](https://github.com/sponsors/kreuzberg-dev).
+
+Have questions or run into issues? We're here to help:
+
+- **GitHub Issues:** [github.com/kreuzberg-dev/html-to-markdown/issues](https://github.com/kreuzberg-dev/html-to-markdown/issues)
+- **Issues:** [github.com/kreuzberg-dev/html-to-markdown/issues](https://github.com/kreuzberg-dev/html-to-markdown/issues)
+- **Discord Community:** [discord.gg/xt9WY3GnKR](https://discord.gg/xt9WY3GnKR)