MarkFlowy is a local-first Markdown editor for macOS, Windows, and Linux. Write visually or in source, organize your own folders, and bring in AI when it helps. Local editing works without an account or an AI provider.
Download · Website · User guide · Release notes
Features
- Write your way. Switch between visual editing, Markdown source, and reading mode. Work with tables, task lists, code, math, Mermaid diagrams, and reusable snippets. Use Zen mode when you want to focus.
- High-performance editing. Optimized loading and rendering make large Markdown documents easier to open, scroll through, and edit.
- Stay in your own folders. Open individual files or a workspace, organize the file tree, use tabs and split editors, and navigate with bookmarks and an outline. Quick Open and workspace search help you return to an idea.
- Revisit your work. Compare local history, recover saved drafts after a normal exit or reload, and handle changes made by other applications. Local history complements your own backups.
- Make it feel right. Choose light or dark themes, create themes with the visual editor, customize shortcuts and typography, and set automatic, left-to-right, or right-to-left document text direction.
- Use AI on your terms. Chat, summarize, translate, or enable Copilot with your configured provider: OpenAI-compatible services, DeepSeek, Google, or Ollama. Chat and Copilot have separate model settings. See the Ollama guide.
- Share your writing. Export HTML or images, print to PDF, or install Pandoc for DOCX, ODT, and EPUB. The CLI supports local file and export automation.
Cloud AI and remote endpoints receive the context sent to them. Local inference requires a local Ollama endpoint and a local model.
A closer look
Get started
- Install a package for your platform from GitHub Releases.
- Open a Markdown file, or open a folder as a workspace.
- Choose an editing mode from the editor's More menu. Use Cmd/Ctrl + P for Quick Open and Cmd/Ctrl + Shift + P for commands.
- Adjust appearance and shortcuts in Settings. Configure AI only if you want to use it.
The user guide covers editing, search, history, export, and common shortcuts. The separate Web App Beta has its own storage and workspace behavior; these screenshots and instructions describe Desktop.
Download
Available for Windows, macOS and Linux, from the latest release.
Windows
Download and run one of the x64 builds:
MarkFlowy_v<version>_x64-setup.exe or MarkFlowy_v<version>_x64.msi — installer.MarkFlowy_v<version>_offline_installer_x64-setup.exe / .msi — same, with the WebView2 runtime bundled.MarkFlowy_v<version>_x64_portable.zip — unpack and run, no installation.
macOS
Download MarkFlowy_v<version>_aarch64.dmg (Apple silicon) or MarkFlowy_v<version>_x64.dmg (Intel).
On macOS, drag MarkFlowy into Applications. If a download from the official release page is blocked, follow Apple’s Open Anyway instructions in System Settings → Privacy & Security.
Linux
x86_64 only for now.
Flatpak
On FlatPark — app page:
flatpak remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo
flatpak install flatpark io.github.drl990114.MarkFlowy
Install script
Installs the .deb or .rpm for your distribution, or the AppImage if it is not recognized:
curl -fsSL https://raw.githubusercontent.com/drl990114/MarkFlowy/main/scripts/install-linux.sh -o install-linux.sh
sh install-linux.sh
Use wget -O install-linux.sh <url> if curl is unavailable. Add --appimage to force the AppImage, or --uninstall to remove MarkFlowy.
Why
Actually, the initial inspiration for MarkFlowy stemmed from a casual conversation with a friend a few years ago. As developers, we shared many expectations for an ideal Markdown editor. After trying many existing applications, I felt they couldn't fully meet our comprehensive needs in terms of efficiency, aesthetics, lightweight design, and workflow integration. We envisioned our ideal editor together. Although we later went our separate ways and lost touch, that seed of desire to create something beautiful has always remained in my heart.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
