New Tool: dsh-better-markdown

New Tool: dsh-better-markdown

When you write documentation that mixes prose, diagrams, and equations, the rendering pipeline can break under load or in browsers with limited support. A single failure—whether a Mermaid chart fails to load or a KaTeX expression throws an error—can leave readers staring at blank spaces or raw markup. Developers need a way to keep the content flowing, even when parts of the stack stumble.

What You Need to Know

dsh-better-markdown is a TypeScript library that wraps the markstream-react streaming engine with a DeepSeek Harness Web plugin. The plugin intercepts the markdown stream, parses fenced blocks for Mermaid syntax and KaTeX delimiters, and sends each piece to the appropriate renderer. If a renderer throws an exception or times out, the plugin swaps in a safe fallback that displays the original source or a placeholder image.

Because the whole pipeline works as a stream, the library can start showing content as soon as the first chunk arrives, rather than waiting for the entire file to download. This reduces perceived latency on large documents or slow connections. The output is a React component that can be dropped into any existing JSX tree, with props to control timeout thresholds and fallback styling.

The project is published under an MIT license on npm, with a minimal bundle size (~12 KB gzipped) and no peer dependencies beyond

📌 Source: Github