-blue){kind=icon}
An open-source desktop Markdown AI editor and standalone markdown viewer built with Electron. Write, edit, and view Markdown files with syntax highlighting, live split-pane preview, and an integrated local AI assistant — all running privately on your machine.
Pre-built installers are available on the Releases page.
| Platform | Format |
|---|---|
| Windows | NSIS installer, portable ZIP |
| Linux | AppImage, DEB |
| macOS | DMG, ZIP (coming soon) |
- Edit, Split, and Preview modes — syntax-highlighted editor, side-by-side split view with synchronized scrolling, and a clean preview pane, cycled with `Ctrl+``
- Focus mode — one click hides both sidebars, maximizes the window, and switches to Split view for distraction-free writing
- File explorer — browse, create, rename, and open
.mdfiles from a folder, with Multi-level, Root-only, and Custom (no-folder) sidebar modes - Global search — find filenames and in-file content across the open folder (
Ctrl+Shift+F), with tag search via#tagortag:name - AI Assistant — ask the AI to edit your document, answer questions, or improve your writing
- Smart AI editing — document edits are applied silently and instantly; informational answers stream as chat
- Undo AI edits — every AI document change is reversible with the Undo button or
Ctrl+Z - Visual table builder — insert Markdown tables with a point-and-click grid editor
- File labels & tags — colour-tag files in the explorer for quick navigation, or add searchable tags stored in YAML frontmatter
- File backups & Version History — every save (manual, autosave, or AI edit) is snapshotted to the app's user data folder; right-click a file → "Version History…" to browse and restore prior versions
- File trash — delete files to the OS Recycle Bin from the context menu
- Multi-model support — connect any OpenAI-compatible API (Groq, OpenAI, Mistral, Together AI) or run Ollama locally
- Export to PDF — one-click export via native save dialog
- Dark / light theme — persisted across sessions
- Configurable editor — font size and font family settings
- Update notifications — an "Update" button appears in the header when a newer release is available
git clone https://github.com/moilstack/moilstack-md.git
cd moilstack-md
npm install
npm start
npm startusesnodemon— the app auto-reloads when you change any file insrc/.
npm run packageOutput goes to the dist/ folder. Targets: NSIS/ZIP (Windows), DMG/ZIP (macOS), AppImage/DEB (Linux).
DEB (Debian, Ubuntu, Mint, Pop!_OS, and other Debian-based distros):
sudo apt install ./moilstack-md_*.debAppImage (works on virtually any distro — Fedora, Arch, openSUSE, Ubuntu, etc. — no installation required):
chmod +x moilstack-md-*.AppImage
./moilstack-md-*.AppImageIf it fails to launch with a FUSE-related error (some minimal or newer distros, e.g. Fedora 41+, ship without FUSE2 by default), either install FUSE:
# Fedora
sudo dnf install fuse fuse-libs
# Ubuntu/Debian
sudo apt install fuseor skip FUSE entirely and extract-and-run instead:
./moilstack-md-*.AppImage --appimage-extract-and-runMoilStack .md relies on the standard OpenAI Chat Completions API architectural design, allowing you to instantly deploy powerful cloud models or execute complex workflows completely offline.
- Fully Offline & Private: Protect sensitive information by running local text operations straight on your machine through Ollama.
- High-Speed Cloud API Infrastructure: Connect native accounts from Google Gemini, Groq, OpenAI, Mistral, or Together AI.
For definitive step-by-step setup guides, free tier account endpoint links, local model terminal scripts, and detailed performance matrices, see our dedicated AI Configuration & Model Setup Guide.
MoilStack .md acts as an interactive markdown AI editor, allowing you to seamlessly communicate text changes directly to your local workspace.
Simply ask the AI assistant to modify your active file text:
- "Fix the grammar and layout flow in this document"
- "Add a clean summary section right at the top"
- "Convert this raw text paragraph into a clear bulleted list"
When the AI assistant processes an edit, changes are applied silently and instantly into the editor pane. A structural summary of the modifications appears inside the chat window.
- Instant Undo: Every single document modification made by the AI can be instantly reversed using the UI Undo button (↺) or by pressing
Ctrl+Z. - Automatic Snapshots: For absolute safety, MoilStack .md saves automatic file backups to the app's user data directory (not your workspace folder) before any AI processing occurs, and also before every manual save and autosave.
- Scoped Selections: Highlight specific sentences or code lines inside the editor pane before typing a prompt to limit the AI assistant's scope exclusively to that text selection.
| Shortcut | Action |
|---|---|
Ctrl+S |
Save file |
Ctrl+Z |
Undo (AI edits first, then native undo) |
| `Ctrl+`` | Cycle Edit → Split → Preview mode |
Ctrl+O |
Open folder picker |
Ctrl+N |
New untitled file (in-memory) |
Ctrl+Shift+N |
New file on disk in Explorer's active folder |
Ctrl+F |
Find & replace |
Ctrl+Shift+F |
Global search (filenames & content) |
Enter |
Send chat message |
Alt+Enter |
New line in chat input |
Escape |
Close any open modal or dropdown |
Every time your document is written to disk — an AI edit, Ctrl+S, or autosave — MoilStack .md automatically stores a version, keeping the last 10 backups per file. Empty or duplicate-content snapshots are skipped so the 10 slots aren't wasted.
Right-click any file in the Explorer and choose Version History… to view and restore past versions:
- A two-pane view lists every snapshot by date/time on the left; click one to see its raw text on the right.
- A pinned Current entry always shows the file's live content for comparison, and is selected by default when the panel opens.
- Restore This Version loads the selected snapshot back in (with a confirm step) and is disabled while Current is selected — restoring backs up whatever's there first, so nothing is lost either way.
Issues and pull requests are welcome. For significant changes, please open an issue first to discuss what you'd like to change.
See CHANGELOG.md for version history.
MIT — see LICENSE for details.
The project name, logo, and visual branding assets are not open source. See BRANDING.md for the Trademark & Branding Policy.