Skip to main content

Markdown Viewer - File tree + Live preview + Hot reload

Project description

MDV - Markdown Viewer

ファイルツリー + ライブプレビュー + ファイルブラウザ機能付きマークダウンビューア

Features

  • 📁 左側にフォルダツリー表示
  • 📄 マークダウンをHTMLでレンダリング
  • 🔄 ファイル更新時に自動リロード(WebSocket)
  • 🎨 シンタックスハイライト(highlight.js)
  • 📊 Mermaid図のレンダリング対応
  • 🌙 ダーク/ライトテーマ切り替え
  • ✏️ インラインエディタ(Cmd+E)
  • 📥 PDF出力(Cmd+P)
  • 🎬 動画/音声プレビュー

ファイルブラウザ機能

  • 右クリックコンテキストメニュー
    • ファイル:開く、ダウンロード、名前変更、パスコピー、削除
    • フォルダ:新規フォルダ、アップロード、名前変更、パスコピー、削除
  • ドラッグ&ドロップ
    • ファイル/フォルダをフォルダへ移動
    • 外部ファイルをドロップしてアップロード
  • キーボードショートカット
    • Delete/Backspace:選択アイテムを削除
    • F2:名前変更

Installation

# PyPIからインストール(推奨)
pip install mdv-live

# または開発版をインストール
git clone https://github.com/panhouse/mdv.git
cd mdv
pip install -e .

Usage

# カレントディレクトリを表示
mdv

# 特定のディレクトリを表示
mdv ./project/

# 特定のファイルを開く
mdv README.md

# ポート指定
mdv -p 9000

# ブラウザを自動で開かない
mdv --no-browser

# MarkdownをPDFに変換
mdv --pdf README.md
mdv --pdf README.md -o output.pdf

# サーバー管理
mdv -l        # 稼働中のサーバー一覧
mdv -k -a     # 全サーバー停止
mdv -k <PID>  # 特定サーバー停止

Keyboard Shortcuts

ショートカット 機能
Cmd/Ctrl + B サイドバー表示切替
Cmd/Ctrl + E 編集モード切替
Cmd/Ctrl + S 保存(編集モード時)
Cmd/Ctrl + P PDF出力
Cmd/Ctrl + W タブを閉じる
Delete/Backspace ファイル/フォルダ削除
F2 名前変更

Requirements

  • Python 3.9+
  • FastAPI
  • uvicorn
  • watchdog
  • markdown-it-py
  • python-multipart

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mdv_live-0.1.16.tar.gz (34.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mdv_live-0.1.16-py3-none-any.whl (34.9 kB view details)

Uploaded Python 3

File details

Details for the file mdv_live-0.1.16.tar.gz.

File metadata

  • Download URL: mdv_live-0.1.16.tar.gz
  • Upload date:
  • Size: 34.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.9

File hashes

Hashes for mdv_live-0.1.16.tar.gz
Algorithm Hash digest
SHA256 5410165147aa36ad61cde65d0544565eb016f88d9c8a48b3149ca6dd4e3abf1b
MD5 8ab9b54bfa76f90cc1c8c3bdbf53ba6b
BLAKE2b-256 49604390c6d84edd0c2eb7491f77b88d3b7656bb54ec61112ed14b2e9336042f

See more details on using hashes here.

File details

Details for the file mdv_live-0.1.16-py3-none-any.whl.

File metadata

  • Download URL: mdv_live-0.1.16-py3-none-any.whl
  • Upload date:
  • Size: 34.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.9

File hashes

Hashes for mdv_live-0.1.16-py3-none-any.whl
Algorithm Hash digest
SHA256 788984dbacb305cb04f8ba8433d1188c1e7a2ef403ec30cca309060d01fd88ca
MD5 04787710fa8714c781b1f95e4a53f1a1
BLAKE2b-256 ad115c7438c393f51e18f1c788ad0a4797411ce29a3880480aa994b8e41a13ca

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page