HTML to Markdown Converter

WHAT IT DOES

HTML to Markdown Converter extracts HTML content from the current web page and transforms it into clean, readable Markdown syntax. The tool captures selected text, editable field contents, or the entire page body and converts headings, paragraphs, bold and italic emphasis, links, images, lists, code blocks, blockquotes, and horizontal rules into their Markdown equivalents. A live side-by-side view shows the original HTML source on the left and the generated Markdown on the right, updating instantly. One click copies the Markdown output to your clipboard, ready for use in any Markdown-compatible editor, documentation system, or static site generator.

WHERE IT RUNS

The extension runs entirely within your browser's local environment using the BotGentz framework. All HTML parsing, content extraction, and Markdown generation occur on your machine without any network requests. No page content, HTML source, or Markdown output is ever transmitted, uploaded, or stored externally. The tool works on any website and respects the browser's same-origin policy, operating within the isolated extension sandbox.

HOW TO USE

Click the extension toolbar icon to open the converter panel. Choose your source: paste HTML directly into the input area, click "Extract Selected" to grab highlighted text, click "Extract Field" to capture content from the active input or textarea, or click "Extract Page" to convert the entire page's visible content. The Markdown output appears instantly in the result area. Use the "Copy to Clipboard" button to copy the Markdown text. Adjust conversion options like preserving whitespace or handling code blocks with the toggle switches. Close the panel with the Escape key or by clicking the toolbar icon again.

THE PARSE-TRAVERSE RENDERER — WHY IT WORKS

Unlike naive converters that rely on regex replacements and produce brittle output, this extension uses a two-stage parse-traverse architecture. Stage one builds a lightweight Document Object Model from the input HTML using the browser's native DOMParser, which guarantees well-formed, standards-compliant parsing. Stage two traverses this DOM using a depth-first recursive walker that maintains contextual state—tracking list nesting depth, blockquote levels, and emphasis scope. Each node type triggers a specific rendering strategy: block-level elements generate newlines and indentation, inline elements wrap content with the appropriate Markdown delimiters, and nested structures preserve proper hierarchy through an explicit stack. The renderer also intelligently handles edge cases: whitespace normalization preserves meaningful line breaks while collapsing unnecessary spacing, code blocks retain exact indentation, and link references are properly escaped. This approach ensures that every HTML structure produces semantically correct, human-readable Markdown that validates against the CommonMark specification.

THE PANEL

The converter panel is fully draggable by its title bar and remembers its position on screen per website. It snaps to the edges of your browser window for tidy alignment. Collapse the panel to a compact icon strip using the minimize button, restoring it with a single click. Resize the panel by dragging any edge or corner; the HTML input and Markdown output areas adjust proportionally. Press the Escape key to close the panel instantly. The panel maintains independent state for each browser tab, allowing you to convert content in multiple tabs simultaneously without interference.

PLEASE NOTE

This extension requires the free BotGentz extension framework to be installed and enabled. Websites evolve constantly and may change their structure or styling; while the converter handles most common HTML patterns, unusual layouts or custom elements may require updates. All HTML input and Markdown output are stored locally in your browser's storage and are never transmitted, logged, or shared. The extension requests no network permissions and functions entirely offline. The source code is fully auditable and available for review.