Skip to content

appoly/markappoly

Repository files navigation

Markappoly

Pass Go, straight to preview.

Latest release User manual Platforms License

Markappoly

A desktop app that opens Markdown files and shows them formatted, the way they're meant to look. Double-click a .md and you're reading it, not staring at raw # and *. When you do need to change something, one key flips you into an editor and back.

It's built with Tauri and React, so the download is small and it feels like a real Mac app rather than a web page in a window. Windows and Linux builds come from the same code.

Screenshot

Markappoly previewing a Markdown file

Download

Grab the installer for your platform from the latest release:

On macOS, download the .dmg, open it, and drag Markappoly into Applications. The build is signed and notarized by Apple, so it opens without security warnings.

On Windows, download and run the .msi.

On Linux, download the .AppImage (make it executable, then run it) or install the .deb.

After the first launch the app keeps itself up to date: when a new version ships it asks before downloading, then restarts into the new one.

Features

Reading

  • Formatted preview by default, with GitHub-flavored Markdown: tables, task lists, strikethrough
  • Syntax-highlighted code, KaTeX math, Mermaid diagrams, and GitHub-style alerts (> [!NOTE])
  • Outline sidebar and folder browser, find-in-document (⌘F), and search across a whole folder
  • Open Recent, word count and reading time, live reload when the file changes on disk
  • Present mode (⌘⇧P): turn the document into slides, split on ---

Editing

  • Toggle to a CodeMirror source editor with a formatting toolbar, or a split view (⌘⇧E) with editor and preview side by side, scrolling together
  • Paste or drag an image into the editor to attach it next to the document
  • Tick a checkbox in the preview and it writes the change back to the source

Export: Text, HTML, JSON (AST), Word (.docx), and PDF, plus Copy as HTML for pasting rich text elsewhere. With Pandoc installed, also RTF, EPUB, LaTeX, and Pandoc-rendered Word and PDF.

Native polish: frosted vibrancy on macOS and acrylic on Windows, system/light/dark themes, a native menu bar, drag-and-drop, "open with" file association, and a window that reopens where you left it.

For a walkthrough of every feature, see the user manual.

Keyboard shortcuts

Action Shortcut Action Shortcut
Open ⌘O Find ⌘F
Open folder ⌘⇧O Toggle edit/preview ⌘E
Save ⌘S Split view ⌘⇧E
Reload from disk ⌘R Present ⌘⇧P
Toggle sidebar ⌘\ Zoom ⌘+ / ⌘- / ⌘0
Bold / Italic ⌘B / ⌘I Link ⌘K

Build from source

For contributors. You'll need Node 18+, Rust (via rustup), and your platform's Tauri prerequisites.

npm install
npm run tauri dev      # run the app with hot reload
npm run tauri build    # produce a native installer for your OS

DISTRIBUTION.md covers signing, notarization, the app icon, and auto-updates.

Stack: React + TypeScript + Vite · Tauri v2 (Rust) · unified/remark/rehype · CodeMirror 6 · KaTeX · Mermaid · remark-docx

License

MIT © Appoly Ltd


Built by Appoly · "Do not pass Go, just preview your markdown."

About

Markappoly — a fast, cross-platform Markdown viewer & editor (Tauri + React). Pass Go, straight to preview.

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors