Mdviewer

Minimal Markdown viewer. Converts .md files to styled HTML and opens them in your browser.
Made by ecsimsw

Using Brew

Install via Homebrew to get the macOS app:

brew tap ecsimsw/tap
brew install --cask mdviewer

After installation, double-click any .md file to open it with MarkdownViewer.

Using NPM

npm install -g @ecsimsw/mdviewer

mdviewer README.md
mdviewer ./docs
mdviewer README.md --out ./export

Or without installing:

npx @ecsimsw/mdviewer README.md

Features

• 12 themes
  • Milk, Night, Space, Spring, Nugget, Forest, Ocean, Grape, Lemon, Wine, Sunset, Mocha
• Zoom controls
• Width, Margin adjustment
• Search & Replace
• Edit mode
• Code block copy button
• Table of Contents sidebar
• PDF / TXT download
• Temp file auto-cleanup after 24h

Stack

• Node.js >= 18
• Marked — Markdown to HTML parser
• Pretendard — Web font (CDN)
• AppleScript + osacompile — macOS .app bundle
• Homebrew Cask — macOS distribution

Single file CLI (cli.mjs), no build step, no framework.

How it works

Converts Markdown to a styled HTML file in a temp directory and opens it in your browser. Old temp files are automatically cleaned up on next launch.

Use --out to save the HTML file permanently.

Preview Milk

Preview Sunset

License

MIT