A zero-config CLI tool to preview your local Markdown files in a browser.
npx mdts — and you're done.

🔗 Try the Live Demo

🔧 Features

• ⚡ Instant Markdown Preview – Run and view in seconds
• 🌐 Web UI – Clean, tree-based browser interface with three-panel layout
• 🔄 Live Reload – Automatically refreshes on file changes
• 🧘 Zero Setup – No config, no install, no nonsense
• 🎨 Custom Themes – 20+ beautiful application themes and syntax highlighting options

🚀 Quick Start

npx mdts

This starts a local server at http://localhost:8521 and opens your browser. Your current directory becomes a browsable Markdown tree.

💡 Use Cases

• Reviewing AI-generated docs
• Quickly checking README or note folders
• Lightweight local Markdown wiki

See detailed use cases for more examples and workflows.

📦 Requirements

• Node.js
• No installation needed – uses npx

🛠 Options

npx mdts <directory> --host 0.0.0.0 --port 3000 --silent

Option	Description	Example
<directory>	Directory to serve (default .)	./docs
--host, -H	Host to listen on (default localhost)	0.0.0.0
--port, -p	Port to serve on (default 8521)	8000
--silent, -s	Suppress server logs (default false)
--version, -V	Output version number
--help, -h	Display help for command

📚 Documentation

🔗 Live Demo

Experience mdts in action with real examples and interactive features.

📖 Documentation

• Use Cases
• Markdown Features
• Frontend Features
• Advanced Configuration
• API Reference
• Troubleshooting
• Comparison with other tools
• FAQ

Contributing

Found a bug? Have an idea? Want to send a PR?
See CONTRIBUTING.md for details — we'd love to have your help!