Markdown Web Editor

Edit Markdown. Locally. Beautifully.

A fast, browser‑based Markdown editor you can run in any folder — with live preview, autosave, Git integration, and an optional AI assistant (OpenAI + Anthropic).

npx markdown-web
View on npm GitHub
  • ⚡ Live Preview
  • 🧠 AI Ask + Adjust
  • 🔀 Git‑aware
  • 🌐 Optional ngrok

Features

📁

Explorer

Browse, create, rename, delete, and drag‑and‑drop files and folders with a clean, VS Code‑inspired UI.

👁️

Live Preview

GFM rendering with syntax highlighting. Toggle preview or use a resizable split view.

💾

Autosave

Automatic save after you pause typing. Manual save with Ctrl/Cmd+S.

🖱️

Context Menus

Right‑click on desktop or double‑tap on mobile for quick file and folder actions.

🧭

Deep Links

Open files directly via URL (e.g. #/docs/readme.md) and use browser back/forward.

📤

Export

Download the current file as Markdown or export a theme‑styled PDF in one click.

AI Assistant

Ask & Adjust

Ask questions about your document or describe changes to apply. Both modes respect text selection — if you’ve highlighted text, the AI operates only on that range.

  • Models: OpenAI (GPT‑5, Mini, Nano) and Anthropic (Claude Sonnet 4, Opus 4.1)
  • Selection‑aware and non‑destructive Ask mode
  • Per‑file cost tracking and running totals
Quick Start
# Open Settings → paste your API keys
# Choose a Default Model (only providers with keys appear)

# Use the ✨ AI button in the header
# Ask: Get a read‑only answer (markdown rendered)
# Adjust: Applies AI edits to your doc (or selection)

Git Integration

🔀

Status Colors

Repos are auto‑detected. Folders show red (unstaged) or yellow (staged). Files show green (untracked), yellow (modified), red (deleted).

✅

Stage & Commit

Stage new/changed/deleted files and commit with a title and optional message. Push with one click.

📥

Clone

Right‑click the root (or a folder) → Clone Repository… Paste a URL and you’re set.

📂

Drag & Drop

Move files/folders between directories; targets auto‑expand on hover. Expanded folders persist.

Install & Run

One‑liner

npx markdown-web

By default, a strong random password is generated on startup.

Common Flags

  • --auth <password> set a custom password
  • --disable-auth disable authentication (local only)
  • --openai-key <key> provide an OpenAI key via CLI
  • --ngrok-auth-token <token> and --ngrok-domain <domain> to expose via ngrok

Settings

Open the Settings (gear icon) to configure:

  • Theme, Preview layout, Sidebar mode
  • OpenAI / Anthropic API keys (stored locally)
  • Default Model and Provider

Settings persist to ~/.markdown-web/settings.json.