dsh-tool-markdown

When dealing with web pages, emails, or exported files, we often need to convert messy HTML into clean Markdown, or transform Markdown documents into HTML suitable for web display. Traditional approaches rely on bulky libraries like cheerio or jsdom, which not only add dependency overhead but may also introduce security risks. The dsh-tool-markdown plugin addresses this by providing a lightweight, secure set of conversion tools, solving issues like HTML entity errors, table chaos, and web noise that models encounter during document processing.

The plugin's core capabilities include bidirectional HTML↔Markdown conversion, GFM table normalization, and intelligent table of contents generation. It uses a hand-written recursive descent parser, achieving zero dependencies and zero execution surface, ensuring input content is processed securely—automatically stripping dangerous tags like scripts and styles, and outputting safe HTML via a whitelist mechanism. All conversions are deterministic, avoiding network requests and complex parsing, making it ideal for quick local document handling.

This plugin is particularly suited for developers, content creators, and AI models integrated into the DSH toolchain who need automated document processing. Whether you are cleaning up content scraped from websites, generating technical document directories, or seamlessly converting between formats, dsh-tool-markdown offers a reliable and efficient solution, letting you focus on content creation rather than format hassles.