I Built a Tool for Comfortable MD Viewing — Because My AI Won't Stop Writing

The Problem: A Flood of MarkDown (MD)

If you work with Claude Code (Anthropic's CLI), you know your life is MD. There's CLAUDE.md for project context. There are memory files in .claude/ that the tool writes and updates. There are specs written in Hebrew and translated to English. There are changelogs, saved prompts, and auto-generated documentation.

And it's not just Claude. All GenAI tools work this way — ChatGPT, Gemini, Copilot — they all "speak" in MD. It's the communication format of the AI era. Recently, MDX has also become a standard for modern documentation.

The problem is that raw MD files look terrible to the eye. Headers with ###, links in square brackets, code blocks wrapped in backticks. Sometimes you just need a tool for comfortable viewing of the rendered MD file — exactly as it looks on GitHub — without actually pushing it to GitHub.

Additionally, for those working a lot in Hebrew (translating documents, writing specs, and comparing Hebrew/English versions), most tools simply don't support RTL comfortably.

What I Tried (and Why It Didn't Work)

• VS Code Preview — It works, but it requires opening VS Code and doesn't allow for easy side-by-side comparison of two rendered MD files.
• Obsidian — An excellent tool, but its purpose is different (knowledge management and note-taking). It requires installation and isn't quite right for a quick file viewer.
• Typora — A good tool, but requires installation. I wanted something I could just open in a second.
• grip — Requires Python, a local server, and a GitHub API token. A bit overkill for a simple task.
• Online Tools — They require uploading the MD file to the cloud, which is not suitable for internal or sensitive files.

I wanted a simple solution: a single file, no installation, no server, and no internet. A tool that opens with a double-click, where you drag an MD file in and see a beautiful and comfortable result. With full RTL support and side-by-side comparison.

So I Built One

The irony? I built it using Claude Code itself. The very tool that creates mountains of MD helped me build a tool to display them nicely. I called it MD/MDX Viewer.

What's Inside?

• Single HTML file — Weighs only about 188KB. Everything is inline (including marked.js, highlight.js, and CSS). Zero external dependencies.
• Dual-pane comparison — Drag a file to the left, another to the right. Perfect for translations, before/after versions, or comparing specs.
• Independent RTL/LTR per pane — A direction toggle for each side, a must for those working in English and Hebrew simultaneously.
• Scroll Sync — Scrolling one pane moves the other with it. Critical for document comparison.
• Extra Features — Syntax highlighting, word count, Dark/Light mode of course, and a clean Drag & Drop interface for your MD files.

What's NOT Inside?

No server, no npm install, no Electron, no user account, no cloud, and no telemetry. Everything runs 100% locally via file:// in the browser. Chrome, Edge, Firefox — just open the MD file and you're good to go.

How to Start?

The tool is designed to be super intuitive and ready for immediate work:

1. Run directly from GitHub Pages — Download nothing, just go to the link, drag a file to the screen, and start working.
2. Download as a local file (index.html) — Download the file and double-click to work fully offline.