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.10.tar.gz (34.6 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.10-py3-none-any.whl (35.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mdv_live-0.1.10.tar.gz
  • Upload date:
  • Size: 34.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.14

File hashes

Hashes for mdv_live-0.1.10.tar.gz
Algorithm Hash digest
SHA256 186e151b81299f92e6bf5ab4bacada769847f738fa93f98310302640b10a54b3
MD5 2fb032a89a831121b659a28fce293f0f
BLAKE2b-256 471c25c7dc480be02a275f6713f65e283292868f66f0968bce2a42e6d842fd4e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mdv_live-0.1.10-py3-none-any.whl
  • Upload date:
  • Size: 35.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.14

File hashes

Hashes for mdv_live-0.1.10-py3-none-any.whl
Algorithm Hash digest
SHA256 928494fcc4524033bea75a12d5b601fe0126549142084d7f632cb595564155a5
MD5 b5c762545b7075ecf8894e16b9d635c6
BLAKE2b-256 4368c7713a8e9dd07842c747a877299a04f9facf7279df7fb818f2976e2687ef

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