HN Showcase
Back to browse
GitHub Repository
3 starsTypeScript

Dirsv – dir browser, battery packed Markdown previewers

by letientai299·Mar 25, 2026·2 points·0 comments
Visit ProjectView on HN

AI Analysis

●●SolidCozySlick

Better markserv with PlantUML, D2, and synced Neovim plugin for live preview workflow.

Strengths
  • •Client-side WASM rendering for Mermaid, PlantUML, Graphviz, D2, and DBML without server processing
  • •Neovim plugin syncs scroll position, cursor line, and visual selection with browser preview
  • •JSON/YAML tree view with collapsible nodes and per-node copy buttons for config inspection
Weaknesses
  • •markserv, glow, and mkdocs serve already cover most markdown preview use cases adequately
  • •215 commits for a directory browser suggests scope creep — consider what problem you're solving
Target Audience

Technical writers, developers writing design docs, note-takers

Similar To

markserv · mkdocs serve · docsify

Post Description

This is my 2nd time sharing this tool. It is a local directory browser with live reload. Single Go binary, embedded web UI.

IMO, it is a better markserv [0] that supports more features I needed for my workflow with markdown and general dir browsing:

- Math heavy note. - Tech design docs with heavy mermaid diagrams. - Code file, images, preview. Last time I used markserv, when browsing into an unsupported text files, it is downloaded. dirsv will render the file with syntax highlighting.

I also built the companion nvim for this: https://github.com/letientai299/dirsv.nvim

Compare to my last Show HN sharing, many bugs was fixed, and a few changes was made:

- Sync scroll, cursorline and visual selection between nvim plugin can the previewer. - Change default port ranges to 3579+, to avoid conflict with many other tools that like to use 8xxx range.

Disclaimer: this was built with claude code, and, I do code review seriously to make sure I can still work on it without any AI tools.

[0]: https://github.com/markserv/markserv

Similar Projects