Skip to content

markview-app/markview

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

MarkView

πŸ“– What is MarkView?

A lightweight, open-source markdown viewer for Chrome, Edge & Chromium Browsers. This repository provides the core rendering engine with essential features, designed for transparency, security auditing, and self-hosted deployments.

Note: This is the open-source version of MarkView. For the full-featured extension with advanced productivity tools, visit MarkView on Chrome Web Store or MarkView on Edge Add-ons.

License: MIT Chrome Extension Edge Add-on PRs Welcome

✨ Features Included

  • βœ… Full GFM Support - GitHub Flavored Markdown (tables, task lists, strikethrough, footnotes)
  • βœ… Syntax Highlighting - Code blocks with basic theme (180+ languages supported)
  • βœ… Mermaid Diagrams - Flowcharts, sequence diagrams, class diagrams, and more
  • βœ… KaTeX Math Rendering - Beautiful LaTeX equations (inline and display)
  • βœ… Dark/Light Themes - Eye-friendly theme toggle
  • βœ… Basic Table of Contents - Auto-generated TOC for H1-H2 headings
  • βœ… GitHub-Style Alerts - Note, Tip, Important, Warning, Caution callouts
  • βœ… Extended Markdown - Superscript, subscript, insert, mark, abbreviations, definition lists
  • βœ… Local & Remote Files - View markdown from file:// and https:// URLs
  • βœ… Privacy-First - All processing happens locally, no data collection

πŸš€ Quick Start

Option 1: Install Full Extension (Recommended)

Get the complete MarkView experience with all productivity features:

Option 2: Build from Source (This Repository)

For developers, security auditing, or restricted environments:

# Clone the repository
git clone https://github.com/markview-app/markview.git
cd markview

# Install dependencies (requires pnpm)
pnpm install

# Build the extension
pnpm run build

# Load the unpacked extension
# 1. Open chrome://extensions/
# 2. Enable "Developer mode"
# 3. Click "Load unpacked"
# 4. Select the `dist/` folder

Requirements: Node.js 18+, pnpm 8+


πŸ’‘ Which Version Should You Choose?

Choose Open-Source Edition if you:

  • Need to audit the code for security/privacy
  • Work in a corporate environment requiring open-source software
  • Want a lightweight viewer for basic markdown files
  • Need to self-host or modify the extension
  • Are in a region where Chrome Web Store is blocked

Choose Full Extension if you:

  • Want productivity features like folder navigation and folder bookmarks
  • Want presentation mode for markdown slides
  • Need export to HTML and Word documents
  • Need advanced features like Mermaid fullscreen zoom, image viewer with gallery navigation
  • Prefer automatic updates from Chrome Web Store
  • And many more!

πŸ“š Documentation


πŸ› οΈ Technical Stack

  • TypeScript 5.0+ - Type-safe development
  • Webpack 5 - Module bundling with esbuild-loader
  • markdown-it 14.1.0 - Markdown parser with plugin ecosystem
  • highlight.js 11.6.0 - Syntax highlighting
  • Mermaid 11.4.0 - Diagram rendering
  • KaTeX 0.16.25 - Math equation rendering
  • Chrome Extension Manifest V3 - Modern extension platform

See package.json for complete dependencies.


🀝 Contributing

We welcome contributions to the core rendering features! Please read our Contributing Guidelines before submitting a pull request.

What Can You Contribute?

βœ… Welcome Contributions:

  • Bug fixes in core rendering
  • Performance improvements
  • New markdown-it plugins (if useful for everyone)
  • Documentation improvements
  • Translation improvements
  • Accessibility enhancements
  • Security fixes

❌ Not Accepting:

  • PRO-tier features (maintained separately)
  • Features that significantly increase bundle size
  • Breaking changes to existing APIs

πŸ› Issues & Support


πŸ“„ License

This open-source edition is released under the MIT License. See LICENSE for details.

Note: This is the open-source version of MarkView. For the full-featured extension with advanced productivity tools, visit MarkView on Chrome Web Store or MarkView on Edge Add-ons.


πŸ”— Related Links

MarkView Full Extension

Community


⭐ Show Your Support

If you find this project useful:

  • ⭐ Star this repository on GitHub
  • 🐦 Share it on social media
  • πŸ“ Write a review on Chrome Web Store
  • πŸ’¬ Join discussions in GitHub Discussions
  • πŸš€ Upgrade to PRO to support continued development

πŸ“œ Changelog

See CHANGELOG.md for release history.


Made with ❀️ by the MarkView Team

Website β€’ Chrome Web Store β€’ Edge Add-ons β€’ Support