docRepo
Share GitHub repo Markdown as a single HTML—math & diagrams
1 follower
Share GitHub repo Markdown as a single HTML—math & diagrams
1 follower
docRepo is a read-only Markdown viewer and sharing tool for founders and tech leaders who use GitHub as their single source of truth. View docs from private repos with full LaTeX (KaTeX), Mermaid diagrams, and syntax highlighting — cleanly on desktop and mobile. Export any page as a single, self-contained HTML file, as easy to share as a PDF, viewable offline and accessible even without a GitHub account.
Hi Product Hunt 👋
TL;DR
- docRepo is a read-only Markdown viewer and sharing tool for GitHub repos
- Exports any page as a single, self-contained HTML file you can share like a PDF — offline, no GitHub account needed
- Renders LaTeX (KaTeX), Mermaid diagrams, and highlighted code cleanly on desktop and mobile
- For founders and tech leaders who use private repos as their single source of truth
💡Why I built docRepo
I’m a business-minded developer.
In the AI era, my documents changed a lot: I started keeping more LLM conversation logs, and I write far more docs with equations in them. I take business ideas and technical ideas, write them out in text, and refine them by talking with LLMs in an iterative loop.
When I thought about version history and a sane file structure, the place that made the most sense for all of these docs was a private GitHub repository. For me, that’s become the single source of truth.
But the information inside private repos is surprisingly hard to share with other people.
The GitHub mobile app doesn’t render equations or diagrams, and it’s not great for quickly showing someone a math-heavy doc.
When I’m talking with people outside, or at a bar🍺, I often want to show a doc while we talk through an idea — and sometimes I want to hand them the file right there. Many of those people have never used GitHub, and some aren’t even familiar with Markdown. More than once I’ve found myself frustrated because “let me show you this spec” turned into friction.
I looked at other tools, but once I cared about all three:
- version history
- a real file-system-like structure for documents
- and easy sharing
every option felt like a compromise for my workflow.
I started building docRepo as a tool just for myself. As I kept polishing it, it became obvious that other people with similar habits probably have the same pain — so I decided to make it public and share it here.
⚡️What docRepo does
First, docRepo renders Markdown cleanly on both desktop and mobile.
LaTeX (KaTeX) equations, Mermaid diagrams, GitHub Flavored Markdown, and syntax-highlighted code all display without breaking the layout.
Then it lets you export any page as a single, self-contained HTML file, and share it as casually as a PDF.
- It looks good on both desktop and mobile
- It works offline
- The recipient doesn’t need a GitHub account or any knowledge of Markdown
If your Markdown references images in a private repo or on the public web, those images are embedded directly into the exported HTML.
Mermaid diagrams are pre-rendered to SVG and embedded as images in the same file (unlike many PDFs, large diagrams stay horizontally scrollable instead of getting chopped).
The CSS and fonts needed for math rendering are bundled too, so equations stay beautiful without extra setup.
In short, docRepo gives you a fully self-contained HTML file you can send around like a PDF, while keeping your actual docs in GitHub.
🎯Who this is for
docRepo is a tool for people like me:
- founders and tech leaders who use GitHub as their single source of truth for docs
- people dealing with AI-era documents with more equations and diagrams
And it’s also for anyone who’s tired of tools that demand manual O(N²) “attention” to keep links between notes alive. I’d rather spend that attention on real ideas — and if you feel the same, I’d love for you to try docRepo and tell me what you think.