Does this skill support asynchronous operations?

Yes, it includes support for an 'async-visitor' feature gate, allowing the visitor to perform non-blocking tasks like network requests or database lookups during conversion.

How does the performance compare to standard conversion?

The architecture follows 'zero-cost' principles. If the visitor features are disabled in Cargo.toml, there is no performance overhead. When enabled, it provides a direct, high-performance hook into the streaming parser.

What is the primary benefit of using the Visitor Pattern here?

It allows for highly extensible and customizable HTML-to-Markdown conversion without modifying the core library, enabling you to define exactly how specific HTML tags should be rendered in Markdown.

Can I access HTML attributes during the conversion process?

Absolutely. Every visitor method receives a NodeContext which includes a BTreeMap of all attributes present on the original HTML element.

Visitor Pattern for HTML-to-Markdown

Name: Visitor Pattern for HTML-to-Markdown
Author: kreuzberg-dev

bykreuzberg-dev

•

480

•

Content Management

Extends the HTML-to-Markdown conversion pipeline with custom visitor hooks for element-level inspection and transformation.

This skill provides a standardized framework for implementing the Visitor Pattern within the html-to-markdown library, allowing developers to intercept and modify the conversion of over 60 HTML element types. It offers granular control over the transformation process, enabling complex workflows such as custom syntax highlighting, attribute-based element filtering, and context-aware formatting based on nesting depth or parent nodes. By utilizing this skill, you can create highly specialized Markdown outputs tailored for documentation engines, CMS platforms, or clean data extraction from web sources.

Key Features

01Attribute-based routing for handling custom data attributes or conditional styling

02Flexible output control via VisitResult to skip, replace, or apply default conversion

03Context-aware processing with access to node depth, parent types, and sibling positions

04Support for both synchronous and asynchronous visitor implementations

05480 GitHub stars

06Granular hooks for 60+ HTML element types including tables, media, and semantic tags

Use Cases

01Customizing documentation output to include anchor links and specialized code block formatting

02Filtering and cleaning scraped HTML to extract specific content while ignoring navigational elements

03Transforming standard HTML links into reference-style Markdown or plain text based on parent context

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kreuzberg-dev/html-to-markdown visitor-pattern-usage

For use in Claude.ai and ChatGPT

Download Skill