html-to-markdown 3.0.2 → 3.2.0

data/vendor/html-to-markdown-rs/src/converter/media/embedded.rs

@@ -78,11 +78,20 @@ pub(crate) fn handle_audio(
     };
 
     if should_output_media_link(&src) {
-        output.push('[');
-        output.push_str(&src);
-        output.push_str("](");
-        output.push_str(&src);
-        output.push(')');
+        if let Some(ref collector) = ctx.reference_collector {
+            let ref_num = collector.borrow_mut().get_or_insert(&src, None);
+            output.push('[');
+            output.push_str(&src);
+            output.push_str("][");
+            output.push_str(&ref_num.to_string());
+            output.push(']');
+        } else {
+            output.push('[');
+            output.push_str(&src);
+            output.push_str("](");
+            output.push_str(&src);
+            output.push(')');
+        }
         if !ctx.in_paragraph && !ctx.convert_as_inline {
             output.push_str("\n\n");
         }
@@ -132,11 +141,20 @@ pub(crate) fn handle_video(
     };
 
     if should_output_media_link(&src) {
-        output.push('[');
-        output.push_str(&src);
-        output.push_str("](");
-        output.push_str(&src);
-        output.push(')');
+        if let Some(ref collector) = ctx.reference_collector {
+            let ref_num = collector.borrow_mut().get_or_insert(&src, None);
+            output.push('[');
+            output.push_str(&src);
+            output.push_str("][");
+            output.push_str(&ref_num.to_string());
+            output.push(']');
+        } else {
+            output.push('[');
+            output.push_str(&src);
+            output.push_str("](");
+            output.push_str(&src);
+            output.push(')');
+        }
         if !ctx.in_paragraph && !ctx.convert_as_inline {
             output.push_str("\n\n");
         }
@@ -199,11 +217,20 @@ pub(crate) fn handle_iframe(tag: &HTMLTag, output: &mut String, ctx: &Context) {
         .map_or(Cow::Borrowed(""), |v| v.as_utf8_str());
 
     if !src.is_empty() {
-        output.push('[');
-        output.push_str(&src);
-        output.push_str("](");
-        output.push_str(&src);
-        output.push(')');
+        if let Some(ref collector) = ctx.reference_collector {
+            let ref_num = collector.borrow_mut().get_or_insert(&src, None);
+            output.push('[');
+            output.push_str(&src);
+            output.push_str("][");
+            output.push_str(&ref_num.to_string());
+            output.push(']');
+        } else {
+            output.push('[');
+            output.push_str(&src);
+            output.push_str("](");
+            output.push_str(&src);
+            output.push(')');
+        }
         if !ctx.in_paragraph && !ctx.convert_as_inline {
             output.push_str("\n\n");
         }

data/vendor/html-to-markdown-rs/src/converter/mod.rs

@@ -40,7 +40,7 @@
 //!
 //! Each submodule (block, inline, list, etc.) follows a consistent pattern:
 //!
-//! ```ignore
+//! ```text
 //! // Module declares handlers for specific element types
 //! pub fn dispatch_<category>_handler(
 //!     tag_name: &str,
@@ -74,7 +74,7 @@
 //! Once `converter.rs` is refactored to use `converter/main.rs`, the walk_node function
 //! will use dispatch functions like:
 //!
-//! ```ignore
+//! ```text
 //! use crate::converter::{block, inline, list, media, semantic, form};
 //!
 //! fn walk_node(...) {
@@ -103,6 +103,7 @@ pub mod media;
 mod metadata;
 pub mod plain_text;
 pub mod preprocessing_helpers;
+pub mod reference_collector;
 pub mod semantic;
 pub mod text;
 mod text_node;

data/vendor/html-to-markdown-rs/src/converter/reference_collector.rs

@@ -0,0 +1,69 @@
+//! Collector for reference-style link definitions.
+
+use std::cell::RefCell;
+use std::collections::HashMap;
+use std::rc::Rc;
+
+/// Shared handle for passing the collector through the conversion context.
+pub type ReferenceCollectorHandle = Rc<RefCell<ReferenceCollector>>;
+
+#[derive(Debug, Clone, Hash, Eq, PartialEq)]
+struct ReferenceKey {
+    url: String,
+    title: Option<String>,
+}
+
+/// Collects link/image references during conversion and produces a reference
+/// definitions section at the end of the document.
+#[derive(Debug, Default)]
+pub struct ReferenceCollector {
+    map: HashMap<ReferenceKey, usize>,
+    entries: Vec<(usize, String, Option<String>)>,
+}
+
+impl ReferenceCollector {
+    /// Create a new, empty reference collector.
+    pub fn new() -> Self {
+        Self::default()
+    }
+
+    /// Register a URL (and optional title) and return its 1-based reference number.
+    ///
+    /// If the same URL+title pair was already registered, the existing number is returned.
+    pub fn get_or_insert(&mut self, url: &str, title: Option<&str>) -> usize {
+        let key = ReferenceKey {
+            url: url.to_string(),
+            title: title.map(String::from),
+        };
+        if let Some(&num) = self.map.get(&key) {
+            return num;
+        }
+        let num = self.entries.len() + 1;
+        self.map.insert(key, num);
+        self.entries.push((num, url.to_string(), title.map(String::from)));
+        num
+    }
+
+    /// Produce the reference definitions section.
+    ///
+    /// Returns an empty string when no references were collected.
+    pub fn finish(&self) -> String {
+        if self.entries.is_empty() {
+            return String::new();
+        }
+        let mut out = String::new();
+        for (num, url, title) in &self.entries {
+            out.push('[');
+            out.push_str(&num.to_string());
+            out.push_str("]: ");
+            out.push_str(url);
+            if let Some(t) = title {
+                out.push_str(" \"");
+                out.push_str(&t.replace('"', "\\\""));
+                out.push('"');
+            }
+            out.push('\n');
+        }
+        out
+    }
+}

data/vendor/html-to-markdown-rs/src/converter/semantic/mod.rs

@@ -64,7 +64,7 @@ pub use summary::handle as handle_summary;
 ///
 /// # Example
 ///
-/// ```ignore
+/// ```text
 /// if dispatch_semantic_handler(tag_name, &node_handle, &parser, output, options, ctx, depth, dom_ctx) {
 ///     // Tag was handled
 /// } else {

data/vendor/html-to-markdown-rs/src/converter/utility/content.rs

@@ -166,7 +166,7 @@ pub(crate) fn is_block_level_element(tag_name: &str) -> bool {
 /// If `index` is already a char boundary it is returned unchanged.
 /// Otherwise it walks backwards to find one.  Returns 0 if no boundary
 /// is found before `index`.
-pub(crate) fn floor_char_boundary(s: &str, index: usize) -> usize {
+pub fn floor_char_boundary(s: &str, index: usize) -> usize {
     if index >= s.len() {
         s.len()
     } else {

data/vendor/html-to-markdown-rs/src/exports.rs

@@ -18,6 +18,7 @@ pub use crate::metadata::{
 };
 
 pub use crate::options::{
-    CodeBlockStyle, ConversionOptions, ConversionOptionsUpdate, HeadingStyle, HighlightStyle, ListIndentType,
-    NewlineStyle, OutputFormat, PreprocessingOptions, PreprocessingOptionsUpdate, PreprocessingPreset, WhitespaceMode,
+    CodeBlockStyle, ConversionOptions, ConversionOptionsBuilder, ConversionOptionsUpdate, HeadingStyle, HighlightStyle,
+    LinkStyle, ListIndentType, NewlineStyle, OutputFormat, PreprocessingOptions, PreprocessingOptionsUpdate,
+    PreprocessingPreset, WhitespaceMode,
 };

data/vendor/html-to-markdown-rs/src/inline_images.rs

@@ -26,7 +26,7 @@ pub const DEFAULT_INLINE_IMAGE_LIMIT: u64 = 5 * 1024 * 1024;
 /// corresponding fields unchanged when applied via [`InlineImageConfig::apply_update`].
 #[derive(Debug, Clone, Default)]
 #[cfg_attr(any(feature = "serde", feature = "metadata"), derive(serde::Deserialize))]
-#[cfg_attr(any(feature = "serde", feature = "metadata"), serde(rename_all = "camelCase"))]
+#[cfg_attr(any(feature = "serde", feature = "metadata"), serde(deny_unknown_fields))]
 pub struct InlineImageConfigUpdate {
     /// Optional maximum decoded size override in bytes.
     pub max_decoded_size_bytes: Option<u64>,

data/vendor/html-to-markdown-rs/src/lib.rs

@@ -77,9 +77,8 @@ mod validation;
 pub use exports::*;
 pub use types::{
     AnnotationKind, ConversionResult, DocumentNode, DocumentStructure, GridCell, NodeContent, ProcessingWarning,
-    TableGrid, TextAnnotation, WarningKind,
+    TableData, TableGrid, TextAnnotation, WarningKind,
 };
-// Note: types::TableData will replace convert_api::TableData when convert() is refactored
 
 // ============================================================================
 // Main Public API Functions

data/vendor/html-to-markdown-rs/src/metadata/config.rs

@@ -133,7 +133,7 @@ pub struct MetadataConfig {
 /// ```
 #[derive(Debug, Clone, Default)]
 #[cfg_attr(any(feature = "serde", feature = "metadata"), derive(serde::Deserialize))]
-#[cfg_attr(any(feature = "serde", feature = "metadata"), serde(rename_all = "camelCase"))]
+#[cfg_attr(any(feature = "serde", feature = "metadata"), serde(deny_unknown_fields))]
 pub struct MetadataConfigUpdate {
     /// Optional override for extracting document-level metadata.
     ///

data/vendor/html-to-markdown-rs/src/metadata/mod.rs

@@ -46,7 +46,7 @@
 //!
 //! ## Basic Usage with `convert()`
 //!
-//! ```ignore
+//! ```text
 //! use html_to_markdown_rs::convert;
 //!
 //! let html = r#"
@@ -87,7 +87,7 @@
 //!
 //! ## Selective Extraction
 //!
-//! ```ignore
+//! ```text
 //! use html_to_markdown_rs::{convert, ConversionOptions};
 //!
 //! let options = ConversionOptions {
@@ -102,7 +102,7 @@
 //!
 //! ## Analyzing Link Types
 //!
-//! ```ignore
+//! ```text
 //! use html_to_markdown_rs::convert;
 //! use html_to_markdown_rs::metadata::LinkType;
 //!
@@ -126,7 +126,7 @@
 //! All types in this module support serialization via `serde` when the `metadata` feature is enabled.
 //! This enables easy export to JSON, YAML, or other formats:
 //!
-//! ```ignore
+//! ```text
 //! use html_to_markdown_rs::convert;
 //!
 //! let result = convert(html, None)?;
@@ -160,7 +160,7 @@ use std::rc::Rc;
 ///
 /// # Examples
 ///
-/// ```ignore
+/// ```text
 /// let collector = MetadataCollector::new(MetadataConfig::default());
 /// let handle = Rc::new(RefCell::new(collector));
 ///

data/vendor/html-to-markdown-rs/src/options/conversion.rs

@@ -4,7 +4,7 @@
 
 use crate::options::preprocessing::PreprocessingOptions;
 use crate::options::validation::{
-    CodeBlockStyle, HeadingStyle, HighlightStyle, ListIndentType, NewlineStyle, OutputFormat, WhitespaceMode,
+    CodeBlockStyle, HeadingStyle, HighlightStyle, LinkStyle, ListIndentType, NewlineStyle, OutputFormat, WhitespaceMode,
 };
 
 /// Main conversion options for HTML to Markdown conversion.
@@ -13,7 +13,7 @@ use crate::options::validation::{
 ///
 /// # Example
 ///
-/// ```rust,ignore
+/// ```text
 /// use html_to_markdown_rs::ConversionOptions;
 ///
 /// let options = ConversionOptions::builder()
@@ -27,10 +27,7 @@ use crate::options::validation::{
     any(feature = "serde", feature = "metadata"),
     derive(serde::Serialize, serde::Deserialize)
 )]
-#[cfg_attr(
-    any(feature = "serde", feature = "metadata"),
-    serde(rename_all = "camelCase", default, deny_unknown_fields)
-)]
+#[cfg_attr(any(feature = "serde", feature = "metadata"), serde(default, deny_unknown_fields))]
 pub struct ConversionOptions {
     /// Heading style to use in Markdown output (ATX `#` or Setext underline).
     pub heading_style: HeadingStyle,
@@ -94,6 +91,8 @@ pub struct ConversionOptions {
     pub preserve_tags: Vec<String>,
     /// Skip conversion of `<img>` elements (omit images from output).
     pub skip_images: bool,
+    /// Link rendering style (inline or reference).
+    pub link_style: LinkStyle,
     /// Target output format (Markdown, plain text, etc.).
     pub output_format: OutputFormat,
     /// Include structured document tree in result.
@@ -114,7 +113,7 @@ impl Default for ConversionOptions {
             heading_style: HeadingStyle::default(),
             list_indent_type: ListIndentType::default(),
             list_indent_width: 2,
-            bullets: "-".to_string(),
+            bullets: "-*+".to_string(),
             strong_em_symbol: '*',
             escape_asterisks: false,
             escape_underscores: false,
@@ -142,6 +141,7 @@ impl Default for ConversionOptions {
             strip_tags: Vec::new(),
             preserve_tags: Vec::new(),
             skip_images: false,
+            link_style: LinkStyle::default(),
             output_format: OutputFormat::default(),
             include_document_structure: false,
             extract_images: false,
@@ -207,6 +207,7 @@ impl ConversionOptionsBuilder {
     builder_setter!(newline_style, NewlineStyle);
     builder_setter!(highlight_style, HighlightStyle);
     builder_setter_into!(code_language, String);
+    builder_setter!(link_style, LinkStyle);
     builder_setter!(autolinks, bool);
     builder_setter!(default_title, bool);
     builder_setter!(br_in_tables, bool);
@@ -289,10 +290,7 @@ use crate::options::preprocessing::PreprocessingOptionsUpdate;
     any(feature = "serde", feature = "metadata"),
     derive(serde::Serialize, serde::Deserialize)
 )]
-#[cfg_attr(
-    any(feature = "serde", feature = "metadata"),
-    serde(rename_all = "camelCase", deny_unknown_fields)
-)]
+#[cfg_attr(any(feature = "serde", feature = "metadata"), serde(deny_unknown_fields))]
 pub struct ConversionOptionsUpdate {
     /// Optional override for [`ConversionOptions::heading_style`].
     pub heading_style: Option<HeadingStyle>,
@@ -356,6 +354,8 @@ pub struct ConversionOptionsUpdate {
     pub preserve_tags: Option<Vec<String>>,
     /// Optional override for [`ConversionOptions::skip_images`].
     pub skip_images: Option<bool>,
+    /// Optional override for [`ConversionOptions::link_style`].
+    pub link_style: Option<LinkStyle>,
     /// Optional override for [`ConversionOptions::output_format`].
     pub output_format: Option<OutputFormat>,
     /// Optional override for [`ConversionOptions::include_document_structure`].
@@ -410,6 +410,7 @@ impl ConversionOptions {
         apply!(strip_tags);
         apply!(preserve_tags);
         apply!(skip_images);
+        apply!(link_style);
         apply!(output_format);
         apply!(include_document_structure);
         apply!(extract_images);
@@ -465,8 +466,8 @@ mod tests {
     #[test]
     fn test_conversion_options_partial_deserialization() {
         let partial_json = r#"{
-            "headingStyle": "atxClosed",
-            "listIndentWidth": 4,
+            "heading_style": "atxclosed",
+            "list_indent_width": 4,
             "bullets": "*"
         }"#;
 

data/vendor/html-to-markdown-rs/src/options/mod.rs

@@ -10,10 +10,10 @@ pub mod preprocessing;
 pub mod validation;
 
 // Re-exports for easy access
-pub use conversion::{ConversionOptions, ConversionOptionsUpdate};
+pub use conversion::{ConversionOptions, ConversionOptionsBuilder, ConversionOptionsUpdate};
 pub use preprocessing::{PreprocessingOptions, PreprocessingOptionsUpdate, PreprocessingPreset};
 pub use validation::{
-    CodeBlockStyle, HeadingStyle, HighlightStyle, ListIndentType, NewlineStyle, OutputFormat, WhitespaceMode,
+    CodeBlockStyle, HeadingStyle, HighlightStyle, LinkStyle, ListIndentType, NewlineStyle, OutputFormat, WhitespaceMode,
 };
 
 // Note: InlineImageConfig is re-exported from the inline_images module,

data/vendor/html-to-markdown-rs/src/options/preprocessing.rs

@@ -42,10 +42,7 @@ impl PreprocessingPreset {
     any(feature = "serde", feature = "metadata"),
     derive(serde::Serialize, serde::Deserialize)
 )]
-#[cfg_attr(
-    any(feature = "serde", feature = "metadata"),
-    serde(rename_all = "camelCase", deny_unknown_fields)
-)]
+#[cfg_attr(any(feature = "serde", feature = "metadata"), serde(default, deny_unknown_fields))]
 pub struct PreprocessingOptions {
     /// Enable HTML preprocessing globally
     pub enabled: bool,
@@ -70,10 +67,7 @@ pub struct PreprocessingOptions {
     any(feature = "serde", feature = "metadata"),
     derive(serde::Serialize, serde::Deserialize)
 )]
-#[cfg_attr(
-    any(feature = "serde", feature = "metadata"),
-    serde(rename_all = "camelCase", deny_unknown_fields)
-)]
+#[cfg_attr(any(feature = "serde", feature = "metadata"), serde(deny_unknown_fields))]
 pub struct PreprocessingOptionsUpdate {
     /// Optional global preprocessing enablement override
     pub enabled: Option<bool>,
@@ -91,7 +85,7 @@ pub struct PreprocessingOptionsUpdate {
 impl Default for PreprocessingOptions {
     fn default() -> Self {
         Self {
-            enabled: false,
+            enabled: true,
             preset: PreprocessingPreset::default(),
             remove_navigation: true,
             remove_forms: true,

data/vendor/html-to-markdown-rs/src/options/validation.rs

@@ -115,10 +115,10 @@ impl NewlineStyle {
 /// Determines how code blocks (`<pre><code>`) are rendered in Markdown.
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
 pub enum CodeBlockStyle {
-    /// Indented code blocks (4 spaces). Default. `CommonMark` standard.
-    #[default]
+    /// Indented code blocks (4 spaces). `CommonMark` standard.
     Indented,
-    /// Fenced code blocks with backticks (```). Supports language hints.
+    /// Fenced code blocks with backticks (```). Default (GFM). Supports language hints.
+    #[default]
     Backticks,
     /// Fenced code blocks with tildes (~~~). Supports language hints.
     Tildes,
@@ -172,6 +172,33 @@ impl HighlightStyle {
     }
 }
 
+/// Link rendering style in Markdown output.
+///
+/// Controls whether links and images use inline `[text](url)` syntax or
+/// reference-style `[text][1]` syntax with definitions collected at the end.
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
+pub enum LinkStyle {
+    /// Inline links: `[text](url)`. Default.
+    #[default]
+    Inline,
+    /// Reference-style links: `[text][1]` with `[1]: url` at end of document.
+    Reference,
+}
+
+impl LinkStyle {
+    /// Parse a link style from a string.
+    ///
+    /// Accepts "reference" or defaults to Inline.
+    /// Input is normalized (lowercased, alphanumeric only).
+    #[must_use]
+    pub fn parse(value: &str) -> Self {
+        match normalize_token(value).as_str() {
+            "reference" => Self::Reference,
+            _ => Self::Inline,
+        }
+    }
+}
+
 /// Output format for conversion.
 ///
 /// Specifies the target markup language format for the conversion output.
@@ -215,7 +242,8 @@ pub(crate) fn normalize_token(value: &str) -> String {
 #[cfg(any(feature = "serde", feature = "metadata"))]
 mod serde_impls {
     use super::{
-        CodeBlockStyle, HeadingStyle, HighlightStyle, ListIndentType, NewlineStyle, OutputFormat, WhitespaceMode,
+        CodeBlockStyle, HeadingStyle, HighlightStyle, LinkStyle, ListIndentType, NewlineStyle, OutputFormat,
+        WhitespaceMode,
     };
     use serde::{Deserialize, Serialize, Serializer};
 
@@ -239,6 +267,7 @@ mod serde_impls {
     impl_deserialize_from_parse!(NewlineStyle, NewlineStyle::parse);
     impl_deserialize_from_parse!(CodeBlockStyle, CodeBlockStyle::parse);
     impl_deserialize_from_parse!(HighlightStyle, HighlightStyle::parse);
+    impl_deserialize_from_parse!(LinkStyle, LinkStyle::parse);
     impl_deserialize_from_parse!(OutputFormat, OutputFormat::parse);
 
     // Serialize implementations that convert enum variants to their string representations
@@ -324,6 +353,19 @@ mod serde_impls {
         }
     }
 
+    impl Serialize for LinkStyle {
+        fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
+        where
+            S: Serializer,
+        {
+            let s = match self {
+                Self::Inline => "inline",
+                Self::Reference => "reference",
+            };
+            serializer.serialize_str(s)
+        }
+    }
+
     impl Serialize for OutputFormat {
         fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
         where

data/vendor/html-to-markdown-rs/src/types/document.rs

@@ -147,8 +147,10 @@ pub struct TextAnnotation {
 /// Uses internally tagged representation (`"annotation_type": "bold"`) for JSON serialization.
 #[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 #[serde(tag = "annotation_type", rename_all = "snake_case")]
+#[derive(Default)]
 pub enum AnnotationKind {
     /// Bold / strong emphasis.
+    #[default]
     Bold,
     /// Italic / emphasis.
     Italic,
@@ -173,3 +175,12 @@ pub enum AnnotationKind {
         title: Option<String>,
     },
 }
+
+impl Default for NodeContent {
+    fn default() -> Self {
+        Self::Heading {
+            level: 1,
+            text: String::new(),
+        }
+    }
+}

data/vendor/html-to-markdown-rs/src/types/result.rs

@@ -1,5 +1,7 @@
 //! The primary result type for HTML conversion and extraction.
 
+use serde::{Deserialize, Serialize};
+
 use super::document::DocumentStructure;
 use super::tables::TableData;
 use super::warnings::ProcessingWarning;
@@ -11,14 +13,14 @@ use super::warnings::ProcessingWarning;
 ///
 /// # Example
 ///
-/// ```rust,ignore
+/// ```text
 /// use html_to_markdown_rs::{convert, ConversionOptions};
 ///
 /// let result = convert("<h1>Hello</h1><p>World</p>", None)?;
 /// assert!(result.content.is_some());
 /// assert!(result.warnings.is_empty());
 /// ```
-#[derive(Debug, Clone, Default)]
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
 pub struct ConversionResult {
     /// Converted text output (markdown, djot, or plain text).
     ///
@@ -42,6 +44,7 @@ pub struct ConversionResult {
     ///
     /// Populated when `extract_images` is `true` in options.
     #[cfg(feature = "inline-images")]
+    #[serde(skip)]
     pub images: Vec<crate::inline_images::InlineImage>,
 
     /// Non-fatal processing warnings.

data/vendor/html-to-markdown-rs/src/types/tables.rs

@@ -3,7 +3,7 @@
 use serde::{Deserialize, Serialize};
 
 /// A structured table grid with cell-level data including spans.
-#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)]
 pub struct TableGrid {
     /// Number of rows.
     pub rows: u32,

data/vendor/html-to-markdown-rs/src/visitor/mod.rs

@@ -13,7 +13,7 @@
 //!
 //! # Example
 //!
-//! ```ignore
+//! ```text
 //! use html_to_markdown_rs::visitor::{HtmlVisitor, NodeContext, VisitResult};
 //!
 //! struct CustomVisitor;

data/vendor/html-to-markdown-rs/src/visitor_helpers/helpers/state.rs

@@ -42,7 +42,7 @@ use crate::visitor::NodeType;
 ///
 /// # Examples
 ///
-/// ```ignore
+/// ```text
 /// let ctx = build_node_context(
 ///     NodeType::Heading,
 ///     "h1",

data/vendor/html-to-markdown-rs/src/visitor_helpers/helpers/traversal.rs

@@ -51,7 +51,7 @@ use super::content::VisitorDispatch;
 ///
 /// # Examples
 ///
-/// ```ignore
+/// ```text
 /// let result = dispatch_visitor(
 ///     &visitor,
 ///     |v| v.visit_heading(&ctx, level, text, id),