mdview-py 0.2.0

A professional Markdown to HTML converter and viewer

mdview-py

A professional command-line utility to convert Markdown files to standalone HTML files and display them in a local webview window or your favorite browser.

Features

• Fast Parsing: Powered by mistune 3.x.
• Extended Syntax:
  • Emojis (e.g., :rocket:, :))
  • MathJax compatibility (Inline $...$ and Block $$...$$)
  • Underlining (++text++)
  • Strikethrough, Task lists, Tables, Footnotes, etc.
• Syntax Highlighting: Beautiful code blocks via Pygments.
• Multiple Themes: GitHub Light, GitHub Dark, and Paper themes.
• Flexible Viewing:
  • Built-in pywebview desktop window.
  • "App Mode" in your default browser.
• Portable Design: Modular Python package structure.

Installation

pip install mdview-py

Note: For testing purposes, you can install the latest beta from TestPyPI using: pip install --index-url https://test.pypi.org/simple/ mdview-py

Usage

# Basic usage (opens in webview)
mdview document.md

# Use a specific theme
mdview document.md --theme github_dark

# Open in default browser (app mode)
mdview document.md --browser

# Generate HTML only (no viewer)
mdview document.md --no-view -o output.html

Build Executable (Windows)

Run makexe.bat to generate a standalone .exe using PyInstaller.