Skip to content

ThisIs-Developer/Markdown-Viewer

Repository files navigation

Markdown Viewer

Markdown Viewer Logo

Professional GitHub-style Markdown editor and previewer

Live preview, diagrams, math, export tools, and multi-document workflows — all in your browser.

Live Demo · Documentation · Issues · Releases

License Latest release Last commit Stars


Table of Contents


About the Project

Markdown Viewer is a full-featured Markdown editor and preview application that renders GitHub-flavored Markdown in real time. It is entirely client-side, lightweight, and optimized for a professional writing workflow — from quick notes to technical documentation with diagrams and LaTeX.


Features

Editor & Preview

  • Live split-screen rendering with instant updates
  • GitHub-flavored Markdown (GFM) support
  • Syntax highlighting for 190+ languages
  • GitHub-style alerts/admonitions ([!NOTE], [!TIP], [!WARNING], etc.)
  • Emoji shortcode rendering (JoyPixels) and native Unicode emoji support
  • YAML frontmatter parsing with a rendered metadata table

Diagrams & Math

  • LaTeX math rendering via MathJax (inline + block)
  • Mermaid diagrams with an interactive toolbar (zoom, pan, copy, PNG/SVG export)

File & Sharing Tools

  • Import from local files, drag & drop, or public GitHub URLs (multi-file selection)
  • Export as Markdown, HTML (standalone), or PDF
  • Share documents via URL with compressed content
  • Copy rendered HTML directly to clipboard

Productivity & Workflow

  • Multiple document tabs (new, rename, duplicate, delete)
  • Reset all tabs in one action
  • Drag-and-drop tab reordering
  • Tab/session state saved in localStorage
  • View modes: editor-only, preview-only, or split
  • Resizable editor/preview panes
  • Synchronized scrolling (toggleable)
  • Live content statistics (words, characters, reading time)
  • Keyboard shortcuts (export, copy, new/close tab, sync toggle, indentation)

UI & Accessibility

  • Responsive layout with a dedicated mobile menu
  • Light/dark themes with system preference support

Privacy & Security

  • 100% client-side processing
  • Sanitized HTML rendering with DOMPurify
  • No tracking, no cookies, no server storage

Screenshots

Code Syntax Highlighting

Code Syntax Highlighting

Mathematical Expressions Support

Mathematical Expressions

Mermaid Diagrams

Mermaid Diagrams

Tables Support

Tables Support


Getting Started

Option 1 — Docker (Recommended)

docker run -d \
  --name markdown-viewer \
  -p 8080:80 \
  --restart unless-stopped \
  ghcr.io/thisis-developer/markdown-viewer:latest

Open http://localhost:8080.

Option 2 — Docker Compose

git clone https://github.com/ThisIs-Developer/Markdown-Viewer.git
cd Markdown-Viewer
docker compose up -d

Option 3 — Static Web Server

git clone https://github.com/ThisIs-Developer/Markdown-Viewer.git
cd Markdown-Viewer
python3 -m http.server 8080

Option 4 — Desktop App

Download pre-built binaries from the Releases page or build from source (see the Desktop App guide).


Usage

  1. Write Markdown in the left editor pane.
  2. Preview the rendered output on the right.
  3. Import, export, share, or switch view modes using the toolbar.
  4. Use the tab bar to manage multiple documents.

Keyboard Shortcuts

  • Ctrl/Cmd + S → Export Markdown
  • Ctrl/Cmd + C → Copy rendered HTML (when no text is selected)
  • Ctrl/Cmd + Shift + S → Toggle sync scrolling (split view)
  • Ctrl/Cmd + T → New tab
  • Ctrl/Cmd + W → Close tab
  • Tab → Insert indentation in editor

Documentation

Explore the full documentation on the wiki:


Built With


Showcase

Built with Markdown Viewer

Project Description
Markdown Desk Native macOS wrapper built with Tauri, adding live reload and native file open/save.

Contributing

Contributions are welcome! Please review the Contributing Guide and open a pull request.


Contributors

Thanks to everyone who has contributed to Markdown Viewer.

Contributors


📈 Development Journey

Markdown Viewer has grown from a lightweight Markdown parser into a full-featured, professional application with advanced rendering, workflow, and export capabilities. Compare the current version with the original version to see the progress in UI design, performance optimization, and feature depth.


License

This project is licensed under the Apache License. See LICENSE for details.


Contact

Developed and maintained by ThisIs-Developer.

About

Markdown Viewer is a fast, GitHub-style Markdown editor and previewer. It features syntax highlighting, LaTeX math, Mermaid diagrams, a dark mode, and supports file import/export (MD/HTML/PDF), emoji support, and sync scrolling.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors