html-to-markdown 2.29.0-x86_64-linux → 3.0.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49299fdb1105ea4dbec8393ac879dd0f8928064543f6c4ff743aa82e94d63f88
-  data.tar.gz: 9896cb02971863cb1e99ba5e84bbba8419b16b0edf50496f23db7d6ba6138fc1
+  metadata.gz: 07d676f000540af84276c48d2b0e84768e9f4708098cdda3de3d999520e7e716
+  data.tar.gz: 3b7fbe10fc72c7af0965ded5f770e0cf6fec353e39497d029f80d7c77f6c7f24
 SHA512:
-  metadata.gz: fb71dbe83523eff32aa73642276468f7f2fe5fc8707f339c39097ad9946b6da5924930e1515986dbb3c1b091b58e1f9e4bf71805bc9d2890bf8678b7d0ae08bf
-  data.tar.gz: ed4c79f974c170565c46b7ef836d3f11e4e4826d8b9cc98dce76f7f9792a12d5090c377f00a981cb3b10a3020ca6cbe6cb103c343ca646a2ea66e56fbbec0199
+  metadata.gz: 207023e2ce048eb36df739aa1166af50b2086ea8c388016250d838230b8c7dba1b5be208540c9afb93277538a9551183a83370d46aa6f71b750073bb71a8cb91
+  data.tar.gz: 8801822711dc240f82151044a45248bcc3656080ddf3d922ec6391c4371d49ce801227b0c85cfb5a4488827af1474a8e84c650b576272d1ae6f6c97e0d9cc1ad

data/Gemfile.lock

@@ -1,13 +1,13 @@
 PATH
   remote: .
   specs:
-    html-to-markdown (2.29.0)
+    html-to-markdown (3.0.0)
       rb_sys (>= 0.9, < 1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (8.1.2)
+    activesupport (8.1.3)
       base64
       bigdecimal
       concurrent-ruby (~> 1.0, >= 1.3.1)
@@ -20,28 +20,20 @@ GEM
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
       uri (>= 0.13.1)
-    addressable (2.8.9)
-      public_suffix (>= 2.0.2, < 8.0)
     ast (2.4.3)
     base64 (0.3.0)
-    bigdecimal (4.0.1)
+    bigdecimal (4.1.0)
     concurrent-ruby (1.3.6)
     connection_pool (3.0.2)
     csv (3.3.5)
     diff-lcs (1.6.2)
     drb (2.2.3)
-    ffi (1.17.3-aarch64-linux-gnu)
-    ffi (1.17.3-arm64-darwin)
-    ffi (1.17.3-x64-mingw-ucrt)
-    ffi (1.17.3-x86_64-darwin)
-    ffi (1.17.3-x86_64-linux-gnu)
+    ffi (1.17.4-arm64-darwin)
+    ffi (1.17.4-x86_64-linux-gnu)
     fileutils (1.8.0)
     i18n (1.14.8)
       concurrent-ruby (~> 1.0)
-    json (2.19.2)
-    json-schema (6.2.0)
-      addressable (~> 2.8)
-      bigdecimal (>= 3.1, < 5)
+    json (2.19.3)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     listen (3.10.0)
@@ -49,18 +41,15 @@ GEM
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     logger (1.7.0)
-    mcp (0.9.0)
-      json-schema (>= 4.1)
     minitest (6.0.2)
       drb (~> 2.0)
       prism (~> 1.5)
     mutex_m (0.3.0)
     parallel (1.27.0)
-    parser (3.3.10.2)
+    parser (3.3.11.1)
       ast (~> 2.4.1)
       racc
     prism (1.9.0)
-    public_suffix (7.0.5)
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.3.1)
@@ -72,7 +61,7 @@ GEM
       ffi (~> 1.0)
     rb_sys (0.9.124)
       rake-compiler-dock (= 1.11.0)
-    rbs (3.10.3)
+    rbs (3.10.4)
       logger
       tsort
     regexp_parser (2.11.3)
@@ -89,11 +78,10 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.7)
-    rubocop (1.85.1)
+    rubocop (1.86.0)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
-      mcp (~> 0.6)
       parallel (~> 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
@@ -138,12 +126,8 @@ GEM
     uri (1.1.1)
 
 PLATFORMS
-  aarch64-linux
   arm64-darwin
-  x64-mingw-ucrt
-  x86_64-darwin
   x86_64-linux
-  x86_64-linux-gnu
 
 DEPENDENCIES
   html-to-markdown!
@@ -156,37 +140,30 @@ DEPENDENCIES
   steep
 
 CHECKSUMS
-  activesupport (8.1.2) sha256=88842578ccd0d40f658289b0e8c842acfe9af751afee2e0744a7873f50b6fdae
-  addressable (2.8.9) sha256=cc154fcbe689711808a43601dee7b980238ce54368d23e127421753e46895485
+  activesupport (8.1.3) sha256=21a5e0dfbd4c3ddd9e1317ec6a4d782fa226e7867dc70b0743acda81a1dca20e
   ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
   base64 (0.3.0) sha256=27337aeabad6ffae05c265c450490628ef3ebd4b67be58257393227588f5a97b
-  bigdecimal (4.0.1) sha256=8b07d3d065a9f921c80ceaea7c9d4ae596697295b584c296fe599dd0ad01c4a7
+  bigdecimal (4.1.0) sha256=6dc07767aa3dc456ccd48e7ae70a07b474e9afd7c5bc576f80bd6da5c8dd6cae
   concurrent-ruby (1.3.6) sha256=6b56837e1e7e5292f9864f34b69c5a2cbc75c0cf5338f1ce9903d10fa762d5ab
   connection_pool (3.0.2) sha256=33fff5ba71a12d2aa26cb72b1db8bba2a1a01823559fb01d29eb74c286e62e0a
   csv (3.3.5) sha256=6e5134ac3383ef728b7f02725d9872934f523cb40b961479f69cf3afa6c8e73f
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  ffi (1.17.3-aarch64-linux-gnu) sha256=28ad573df26560f0aedd8a90c3371279a0b2bd0b4e834b16a2baa10bd7a97068
-  ffi (1.17.3-arm64-darwin) sha256=0c690555d4cee17a7f07c04d59df39b2fba74ec440b19da1f685c6579bb0717f
-  ffi (1.17.3-x64-mingw-ucrt) sha256=5f1d7d067a9a1058ad183dba25b05557cd51c85fc1768c49338eabc1cf242d7c
-  ffi (1.17.3-x86_64-darwin) sha256=1f211811eb5cfaa25998322cdd92ab104bfbd26d1c4c08471599c511f2c00bb5
-  ffi (1.17.3-x86_64-linux-gnu) sha256=3746b01f677aae7b16dc1acb7cb3cc17b3e35bdae7676a3f568153fb0e2c887f
+  ffi (1.17.4-arm64-darwin) sha256=19071aaf1419251b0a46852abf960e77330a3b334d13a4ab51d58b31a937001b
+  ffi (1.17.4-x86_64-linux-gnu) sha256=9d3db14c2eae074b382fa9c083fe95aec6e0a1451da249eab096c34002bc752d
   fileutils (1.8.0) sha256=8c6b1df54e2540bdb2f39258f08af78853aa70bad52b4d394bbc6424593c6e02
-  html-to-markdown (2.29.0)
+  html-to-markdown (3.0.0)
   i18n (1.14.8) sha256=285778639134865c5e0f6269e0b818256017e8cde89993fdfcbfb64d088824a5
-  json (2.19.2) sha256=e7e1bd318b2c37c4ceee2444841c86539bc462e81f40d134cf97826cb14e83cf
-  json-schema (6.2.0) sha256=e8bff46ed845a22c1ab2bd0d7eccf831c01fe23bb3920caa4c74db4306813666
+  json (2.19.3) sha256=289b0bb53052a1fa8c34ab33cc750b659ba14a5c45f3fcf4b18762dc67c78646
   language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
   lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
   listen (3.10.0) sha256=c6e182db62143aeccc2e1960033bebe7445309c7272061979bb098d03760c9d2
   logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
-  mcp (0.9.0) sha256=a0a3737b0ac9df0772f4ef7e2b013c260ddbcf217a5d50a66bff0baeddf03e47
   minitest (6.0.2) sha256=db6e57956f6ecc6134683b4c87467d6dd792323c7f0eea7b93f66bd284adbc3d
   mutex_m (0.3.0) sha256=cfcb04ac16b69c4813777022fdceda24e9f798e48092a2b817eb4c0a782b0751
   parallel (1.27.0) sha256=4ac151e1806b755fb4e2dc2332cbf0e54f2e24ba821ff2d3dcf86bf6dc4ae130
-  parser (3.3.10.2) sha256=6f60c84aa4bdcedb6d1a2434b738fe8a8136807b6adc8f7f53b97da9bc4e9357
+  parser (3.3.11.1) sha256=d17ace7aabe3e72c3cc94043714be27cc6f852f104d81aa284c2281aecc65d54
   prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
-  public_suffix (7.0.5) sha256=1a8bb08f1bbea19228d3bed6e5ed908d1cb4f7c2726d18bd9cadf60bc676f623
   racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
   rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
   rake (13.3.1) sha256=8c9e89d09f66a26a01264e7e3480ec0607f0c497a861ef16063604b1b08eb19c
@@ -195,14 +172,14 @@ CHECKSUMS
   rb-fsevent (0.11.2) sha256=43900b972e7301d6570f64b850a5aa67833ee7d87b458ee92805d56b7318aefe
   rb-inotify (0.11.1) sha256=a0a700441239b0ff18eb65e3866236cd78613d6b9f78fea1f9ac47a85e47be6e
   rb_sys (0.9.124) sha256=513476557b12eaf73764b3da9f8746024558fe8699bda785fb548c9aa3877ae7
-  rbs (3.10.3) sha256=70627f3919016134d554e6c99195552ae3ef6020fe034c8e983facc9c192daa6
+  rbs (3.10.4) sha256=b17d7c4be4bb31a11a3b529830f0aa206a807ca42f2e7921a3027dfc6b7e5ce8
   regexp_parser (2.11.3) sha256=ca13f381a173b7a93450e53459075c9b76a10433caadcb2f1180f2c741fc55a4
   rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587
   rspec-core (3.13.6) sha256=a8823c6411667b60a8bca135364351dda34cd55e44ff94c4be4633b37d828b2d
   rspec-expectations (3.13.5) sha256=33a4d3a1d95060aea4c94e9f237030a8f9eae5615e9bd85718fe3a09e4b58836
   rspec-mocks (3.13.8) sha256=086ad3d3d17533f4237643de0b5c42f04b66348c28bf6b9c2d3f4a3b01af1d47
   rspec-support (3.13.7) sha256=0640e5570872aafefd79867901deeeeb40b0c9875a36b983d85f54fb7381c47c
-  rubocop (1.85.1) sha256=3dbcf9e961baa4c376eeeb2a03913dca5e3987033b04d38fa538aa1e7406cc77
+  rubocop (1.86.0) sha256=4ff1186fe16ebe9baff5e7aad66bb0ad4cabf5cdcd419f773146dbba2565d186
   rubocop-ast (1.49.1) sha256=4412f3ee70f6fe4546cc489548e0f6fcf76cafcfa80fa03af67098ffed755035
   rubocop-rspec (3.9.0) sha256=8fa70a3619408237d789aeecfb9beef40576acc855173e60939d63332fdb55e2
   ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33

data/README.md

@@ -17,8 +17,8 @@
   <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/v2/htmltomarkdown">
-    <img src="https://img.shields.io/github/v/tag/kreuzberg-dev/html-to-markdown?label=Go&color=007ec6&filter=v2.29.0" alt="Go">
+  <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.0.0" 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#">
@@ -87,7 +87,6 @@ Apple M4 • Real Wikipedia documents • `convert()` (Ruby)
 | Mixed (Python wiki) | 656KB | 4.89ms | 134 MB/s |
 
 
-See [Performance Guide](../../examples/performance/) for detailed benchmarks.
 
 
 ## Quick Start
@@ -98,7 +97,8 @@ Basic conversion:
 require 'html_to_markdown'
 
 html = "<h1>Hello</h1><p>This is <strong>fast</strong>!</p>"
-markdown = HtmlToMarkdown.convert(html)
+result = HtmlToMarkdown.convert(html)
+markdown = result[:content]
 ```
 
 
@@ -109,60 +109,50 @@ With conversion options:
 require 'html_to_markdown'
 
 html = "<h1>Hello</h1><p>This is <strong>fast</strong>!</p>"
-markdown = HtmlToMarkdown.convert(html, heading_style: :atx, code_block_style: :fenced)
+result = HtmlToMarkdown.convert(html, heading_style: :atx, code_block_style: :fenced)
+markdown = result[:content]
 ```
 
 
 
 
-
-
 ## API Reference
 
-### Core Functions
-
-
-**`convert(html, options: nil) -> String`**
+### Core Function
 
-Basic HTML-to-Markdown conversion. Fast and simple.
 
-**`convert_with_metadata(html, options: nil, config: nil) -> [String, Hash]`**
+**`convert(html, options: nil, visitor: nil) -> ConversionResult`**
 
-Extract Markdown plus metadata (headers, links, images, structured data) in a single pass. See [Metadata Extraction Guide](../../examples/metadata-extraction/).
+Converts HTML to Markdown. Returns a `ConversionResult` hash with all results in a single call.
 
-**`convert_with_visitor(html, visitor:, options: nil) -> String`**
-
-Customize conversion with visitor callbacks for element interception. See [Visitor Pattern Guide](../../examples/visitor-pattern/).
-
-**`convert_with_inline_images(html, config: nil) -> [String, Array, Array]`**
-
-Extract base64-encoded inline images with metadata.
-
-**`convert_with_tables(html, options: nil, config: nil) -> ConversionWithTables`**
+```ruby
+require 'html_to_markdown'
 
-Extract structured table data (cells, headers, rendered markdown) alongside conversion.
+result = HtmlToMarkdown.convert(html)
+markdown = result[:content]       # Converted Markdown string
+metadata = result[:metadata]      # Metadata (when extract_metadata: true)
+tables   = result[:tables]        # Structured table data (when extract_tables: true)
+document = result[:document]      # Document-level info
+images   = result[:images]        # Extracted images
+warnings = result[:warnings]      # Any conversion warnings
+```
 
 
 
 ### 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`: Embed metadata as YAML frontmatter — default: `false`
+- `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"`
 
-**`MetadataConfig`** – Selective metadata extraction:
-- `extract_headers`: h1-h6 elements — default: `true`
-- `extract_links`: Hyperlinks — default: `true`
-- `extract_images`: Image elements — default: `true`
-- `extract_structured_data`: JSON-LD, Microdata, RDFa — default: `true`
-- `max_structured_data_size`: Size limit in bytes — default: `100KB`
-
 
 ## Djot Output Format
 
@@ -222,16 +212,17 @@ Plain text mode is useful for search indexing, text extraction, and feeding cont
 
 ## 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.
+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. Disable unused metadata types in `MetadataConfig` to optimize further.
+**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
 
@@ -240,27 +231,27 @@ The metadata extraction feature enables comprehensive document analysis during c
 require 'html_to_markdown'
 
 html = '<h1>Article</h1><img src="test.jpg" alt="test">'
-markdown, metadata = HtmlToMarkdown.convert_with_metadata(html)
-
-puts metadata[:document][:title]           # Document title
-puts metadata[:headers]                    # All h1-h6 elements
-puts metadata[:links]                      # All hyperlinks
-puts metadata[:images]                     # All images with alt text
-puts metadata[:structured_data]            # JSON-LD, Microdata, RDFa
+result = HtmlToMarkdown.convert(html, extract_metadata: true)
+
+puts result[:content]                             # Converted Markdown
+puts result[:metadata][:document][:title]         # Document title
+puts result[:metadata][:headers]                  # All h1-h6 elements
+puts result[:metadata][:links]                    # All hyperlinks
+puts result[:metadata][:images]                   # All images with alt text
+puts result[:metadata][:structured_data]          # JSON-LD, Microdata, RDFa
 ```
 
 
 
-For detailed examples including SEO extraction, table-of-contents generation, link validation, and accessibility audits, see the [Metadata Extraction Guide](../../examples/metadata-extraction/).
-
 
 
 
 ## Visitor Pattern
 
-The visitor pattern enables custom HTML→Markdown conversion logic by providing callbacks for specific HTML elements during traversal. Use visitors to transform content, filter elements, validate structure, or collect analytics.
+The visitor pattern enables custom HTML→Markdown conversion logic by providing callbacks for specific HTML elements during traversal. Pass a visitor as the third argument to `convert()`.
 
 **Use Cases:**
+
 - **Custom Markdown dialects** – Convert to Obsidian, Notion, or other flavors
 - **Content filtering** – Remove tracking pixels, ads, or unwanted elements
 - **URL rewriting** – Rewrite CDN URLs, add query parameters, validate links
@@ -291,20 +282,16 @@ class MyVisitor
 end
 
 html = '<a href="https://old-cdn.com/file.pdf">Download</a>'
-markdown = HtmlToMarkdown.convert_with_visitor(html, visitor: MyVisitor.new)
+result = HtmlToMarkdown.convert(html, visitor: MyVisitor.new)
+markdown = result[:content]
 ```
 
 
 
-For comprehensive examples including content filtering, link footnotes, accessibility validation, and asynchronous URL validation, see the [Visitor Pattern Guide](../../examples/visitor-pattern/).
-
 
 
 ## Examples
 
-- [Visitor Pattern Guide](../../examples/visitor-pattern/)
-- [Metadata Extraction Guide](../../examples/metadata-extraction/)
-- [Performance Guide](../../examples/performance/)
 
 ## Links
 

data/lib/html_to_markdown/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HtmlToMarkdown
-  VERSION = '2.29.0'
+  VERSION = '3.0.0'
 end

data/lib/html_to_markdown.rb

@@ -7,205 +7,24 @@ module HtmlToMarkdown
   autoload :CLI, 'html_to_markdown/cli'
   autoload :CLIProxy, 'html_to_markdown/cli_proxy'
 
-  class Options; end # rubocop:disable Lint/EmptyClass
-
   class << self
     alias native_convert convert
-    alias native_convert_with_inline_images convert_with_inline_images
-    alias native_convert_with_inline_images_handle convert_with_inline_images_handle
-    alias native_options options
-    alias native_convert_with_options convert_with_options
-    alias native_convert_with_metadata convert_with_metadata
-    alias native_convert_with_metadata_handle convert_with_metadata_handle
-    alias native_convert_with_visitor convert_with_visitor
-    alias native_convert_with_tables convert_with_tables
   end
 
   module_function
 
-  def convert(html, options = nil, visitor = nil)
-    if visitor
-      native_convert_with_visitor(html.to_s, options, visitor)
-    else
-      native_convert(html.to_s, options)
-    end
-  end
-
-  def convert_with_options(html, options_handle)
-    native_convert_with_options(html.to_s, options_handle)
-  end
-
-  def convert_with_inline_images(html, options = nil, image_config = nil, _visitor = nil)
-    # NOTE: visitor parameter is accepted for API compatibility but not used in inline images mode
-    # The visitor pattern is only supported in the standard convert() method
-    native_convert_with_inline_images(html.to_s, options, image_config)
-  end
-
-  def convert_with_inline_images_handle(html, options_handle, image_config = nil)
-    native_convert_with_inline_images_handle(html.to_s, options_handle, image_config)
-  end
-
-  def options(options_hash = nil)
-    native_options(options_hash)
-  end
-
-  # Convert HTML to Markdown with comprehensive metadata extraction.
-  #
-  # Performs HTML-to-Markdown conversion while extracting document metadata, headers,
-  # links, images, and structured data in a single pass. Ideal for content analysis,
-  # SEO workflows, and document indexing.
-  #
-  # @param html [String] HTML string to convert. Line endings are normalized (CRLF -> LF).
-  # @param options [ConversionOptions, Hash, nil] Optional conversion configuration.
-  #   When a Hash, keys should match ConversionOptions field names (as symbols or strings).
-  #   Common options:
-  #   - :heading_style [String] "atx", "atx_closed", or "underlined" (default: "underlined")
-  #   - :list_indent_type [String] "spaces" or "tabs" (default: "spaces")
-  #   - :list_indent_width [Integer] Spaces per indent level (default: 4)
-  #   - :wrap [true, false] Enable text wrapping (default: false)
-  #   - :wrap_width [Integer] Wrap at this column width (default: 80)
-  #   See ConversionOptions documentation for complete list.
-  #
-  # @param metadata_config [Hash, nil] Optional metadata extraction configuration.
-  #   Keys should be symbols or strings. Supported keys:
-  #   - :extract_headers [true, false] Extract h1-h6 heading elements (default: true)
-  #   - :extract_links [true, false] Extract hyperlinks with type classification (default: true)
-  #   - :extract_images [true, false] Extract image elements (default: true)
-  #   - :extract_structured_data [true, false] Extract JSON-LD/Microdata/RDFa (default: true)
-  #   - :max_structured_data_size [Integer] Size limit for structured data in bytes (default: 1_000_000)
-  #
-  # @return [Array<String, Hash>] Tuple of [markdown_string, metadata_hash]
-  #   markdown_string: String - The converted Markdown output
-  #
-  #   metadata_hash: Hash with keys:
-  #   - :document [Hash] Document-level metadata:
-  #     - :title [String, nil] From <title> tag
-  #     - :description [String, nil] From <meta name="description">
-  #     - :keywords [Array<String>] From <meta name="keywords">
-  #     - :author [String, nil] From <meta name="author">
-  #     - :language [String, nil] From lang attribute (e.g., "en")
-  #     - :text_direction [String, nil] "ltr", "rtl", or "auto"
-  #     - :canonical_url [String, nil] From <link rel="canonical">
-  #     - :base_href [String, nil] From <base href="">
-  #     - :open_graph [Hash<String, String>] Open Graph properties (og:* meta tags)
-  #     - :twitter_card [Hash<String, String>] Twitter Card properties (twitter:* meta tags)
-  #     - :meta_tags [Hash<String, String>] Other meta tags
-  #
-  #   - :headers [Array<Hash>] Heading elements:
-  #     - :level [Integer] 1-6
-  #     - :text [String] Header text content
-  #     - :id [String, nil] HTML id attribute
-  #     - :depth [Integer] Tree nesting depth
-  #     - :html_offset [Integer] Byte offset in original HTML
-  #
-  #   - :links [Array<Hash>] Hyperlinks:
-  #     - :href [String] Link URL
-  #     - :text [String] Link text content
-  #     - :title [String, nil] Title attribute
-  #     - :link_type [String] "anchor", "internal", "external", "email", "phone", or "other"
-  #     - :rel [Array<String>] Rel attribute values
-  #     - :attributes [Hash<String, String>] Additional HTML attributes
-  #
-  #   - :images [Array<Hash>] Image elements:
-  #     - :src [String] Image source URL or data URI
-  #     - :alt [String, nil] Alt text for accessibility
-  #     - :title [String, nil] Title attribute
-  #     - :dimensions [Array<Integer>, nil] [width, height] if available
-  #     - :image_type [String] "data_uri", "external", "relative", or "inline_svg"
-  #     - :attributes [Hash<String, String>] Additional HTML attributes
-  #
-  #   - :structured_data [Array<Hash>] Structured data blocks:
-  #     - :data_type [String] "json_ld", "microdata", or "rdfa"
-  #     - :raw_json [String] Raw JSON content
-  #     - :schema_type [String, nil] Schema type (e.g., "Article", "Event")
-  #
-  # @raise [StandardError] If conversion fails or invalid configuration
-  #
-  # @example Basic usage
-  #   html = <<~HTML
-  #     <html lang="en">
-  #       <head>
-  #         <title>My Article</title>
-  #         <meta name="description" content="A great read">
-  #       </head>
-  #       <body>
-  #         <h1 id="intro">Introduction</h1>
-  #         <p>Visit <a href="https://example.com">our site</a></p>
-  #         <img src="photo.jpg" alt="Beautiful landscape">
-  #       </body>
-  #     </html>
-  #   HTML
-  #
-  #   markdown, metadata = HtmlToMarkdown.convert_with_metadata(html)
-  #
-  #   puts metadata[:document][:title]  # => "My Article"
-  #   puts metadata[:document][:language]  # => "en"
-  #   puts metadata[:headers].length  # => 1
-  #   puts metadata[:headers][0][:text]  # => "Introduction"
-  #   puts metadata[:links].length  # => 1
-  #   puts metadata[:images].length  # => 1
-  #
-  # @example With selective metadata extraction
-  #   config = {
-  #     extract_headers: true,
-  #     extract_links: true,
-  #     extract_images: false,      # Skip images
-  #     extract_structured_data: false  # Skip structured data
-  #   }
-  #
-  #   markdown, metadata = HtmlToMarkdown.convert_with_metadata(html, nil, config)
-  #   puts metadata[:images].empty?  # => true (not extracted)
-  #
-  # @example With conversion options
-  #   options = {
-  #     heading_style: "atx",     # Use # H1, ## H2 style
-  #     wrap: true,
-  #     wrap_width: 80
-  #   }
-  #
-  #   config = { extract_headers: true }
-  #
-  #   markdown, metadata = HtmlToMarkdown.convert_with_metadata(html, options, config)
-  #   # Markdown uses ATX-style headings and wraps at 80 characters
-  #
-  # @see #convert Simple conversion without metadata
-  # @see #convert_with_inline_images Extract inline images during conversion
-  # @see ConversionOptions Detailed conversion configuration
-  def convert_with_metadata(html, options = nil, metadata_config = nil, _visitor = nil)
-    # NOTE: visitor parameter is accepted for API compatibility but not used in metadata extraction mode
-    # The visitor pattern is only supported in the standard convert() method
-    native_convert_with_metadata(html.to_s, options, metadata_config)
-  end
-
-  def convert_with_metadata_handle(html, options_handle, metadata_config = nil)
-    native_convert_with_metadata_handle(html.to_s, options_handle, metadata_config)
-  end
-
-  # Convert HTML to Markdown with table extraction.
-  #
-  # Performs HTML-to-Markdown conversion while extracting structured table data
-  # (cells, markdown representation, header row flags) in a single pass.
-  #
-  # @param html [String] HTML string to convert.
-  # @param options [Hash, nil] Optional conversion configuration.
-  # @param metadata_config [Hash, nil] Optional metadata extraction configuration.
-  #
-  # @return [Hash] A hash with keys:
-  #   - :content [String] The converted Markdown output
-  #   - :metadata [Hash, nil] Extended metadata (if metadata extraction was configured)
-  #   - :tables [Array<Hash>] Extracted tables, each with:
-  #     - :cells [Array<Array<String>>] Table cells organized as rows x columns
-  #     - :markdown [String] Complete rendered table in Markdown format
-  #     - :is_header_row [Array<Boolean>] Per-row flag indicating header rows
-  #
-  # @raise [StandardError] If conversion fails or invalid configuration
-  #
-  # @example Basic usage
-  #   html = '<table><thead><tr><th>Name</th></tr></thead><tbody><tr><td>Alice</td></tr></tbody></table>'
-  #   result = HtmlToMarkdown.convert_with_tables(html)
-  #   puts result[:tables].length    # => 1
-  #   puts result[:tables][0][:cells] # => [["Name"], ["Alice"]]
-  def convert_with_tables(html, options = nil, metadata_config = nil)
-    native_convert_with_tables(html.to_s, options, metadata_config)
+  # Convert HTML to Markdown, returning a Hash with:
+  #   - :content [String, nil] the converted Markdown output
+  #   - :document [nil] document structure (not yet exposed)
+  #   - :metadata [Hash, nil] extracted HTML metadata
+  #   - :tables [Array<Hash>] extracted tables with :grid and :markdown
+  #   - :images [Array<Hash>] extracted inline images
+  #   - :warnings [Array<Hash>] processing warnings
+  #
+  # @param html [String] HTML string to convert
+  # @param options [Hash, nil] optional conversion options
+  # @return [Hash] conversion result
+  def convert(html, options = nil)
+    native_convert(html.to_s, options)
   end
 end