用途：当需要从 HTML 中获取结构化元数据而非（或除 Markdown 正文外）内容时使用，可提取页面标题、描述、语言、Open Graph 标签、结构化数据、标题大纲、链接或图片引用。
主要能力：元数据位于 result.metadata，并通过 CLI 的 --json 呈现；元数据默认提取，使用 --json 时以下子字段自动填充：document（title、description、language、open_graph）、headers（level、text）、links（href、link_type）、images（src、alt、image_type）、structured_data（JSON-LD、Microdata、RDFa 块）。没有逐字段提取标志，可用 jq 筛选所需内容。
使用方式：获取全部元数据：html-to-markdown --json input.html | jq '.metadata'；仅提取（跳过 Markdown 正文）：html-to-markdown --json --no-content input.html | jq '.metadata'。--extract-metadata 标志在纯文本模式（无 --json）下，将 title 与 meta 标签作为 HTML 注释头置于 Markdown 输出顶部。常见查询如按 link_type 筛选外链、读取 open_graph、读取 structured_data 等，均通过 jq 完成。
编程访问：Python 中 result = convert(html)，meta = result.metadata，可读取 meta.document.title、meta.document.language、meta.headers[0].text、meta.links[0].link_type、meta.images[0].alt 等。元数据可通过单次 convert() 调用在 Python、Rust、Go、Ruby、Elixir 中获得；TypeScript 从返回的结果对象读取；Rust 需要 metadata feature（默认开启）。
限制：资料未提供安装步骤、收费、价格、性能或平台支持细节；字段细节需参考 CLI 参考与配置文档。