paperhurts

free & open source · no account · no telemetry

Download doc-md.

A local-first markdown knowledge app. Live-preview editing, wiki links, kanban boards, sticky notes, screenshot capture, voice transcription, graph view, and full-text search — over plain markdown files in a folder you choose. Your notes never leave your computer, and neither does your audio.

Download

Fetching the latest version from GitHub…

How to install

On Windows

  1. Choose Download for Windows (.exe installer) above and save the file. Your browser's downloads list opens with Ctrl+J in Chrome, Edge, and Firefox.
  2. Open the downloaded file, named like doc-md_x.y.z_x64-setup.exe (x.y.z is the version number).
  3. If Windows shows a "Windows protected your PC" message (SmartScreen), choose More info, then Run anyway. By keyboard: press Tab until "More info" is focused, press Enter, then Tab to "Run anyway" and press Enter. doc-md releases aren't code-signed yet, so this screen is expected — the app is open source, and you can read every line of what you're running.
  4. Follow the installer — the defaults are all fine. It finishes by launching doc-md.
  5. On first launch, doc-md asks you to choose a vault: a normal folder where every note is stored as a plain markdown file. Pick or create any folder you like, for example Documents\Notes. You can open it in Explorer any time — there's no hidden database.

On macOS

  1. Choose Download for macOS (.dmg) above and open the downloaded file.
  2. Drag doc-md into the Applications folder shown next to it.
  3. First open only: right-click (or Control-click) doc-md in Applications, choose Open, then confirm Open. This is macOS Gatekeeper meeting a new app. If it still refuses: System Settings → Privacy & Security → "Open Anyway".
  4. Choose a vault folder on first launch — any folder; notes are plain markdown files inside it.

On Linux

  1. AppImage (any distro): make it executable and run it — chmod +x doc-md_*.AppImage && ./doc-md_*.AppImage
  2. Debian / Ubuntu: sudo apt install ./doc-md_*_amd64.deb
  3. Fedora / openSUSE: sudo dnf install ./doc-md-*.x86_64.rpm
  4. Launch doc-md from your app menu and choose a vault folder on first run.

A quick look

The doc-md main window. A file explorer sidebar on the left lists markdown notes. The main area shows a note in live preview: headings, bold text, and links appear fully formatted while you type, with markdown symbols hidden except on the line being edited.
Live preview editing. Formatted text as you type — the markdown syntax only appears on the line you're editing.
A doc-md note called Logo ideas in split view. The left pane shows the markdown source, including an image link that was just inserted into the attachments folder; the right pane renders the note with the captured logo image displayed inline between two sentences.
Screenshot capture & image paste. Ctrl+Shift+S anywhere — even with doc-md in the tray — freezes the screen, you drag a region, and the shot lands in your note. Pasting an image from the clipboard works the same way.
A doc-md transcription note named Design sync while recording: a recorder bar above the editor shows a Stop button, an elapsed time of nine seconds, and checkboxes for microphone and system audio. Below, a Transcript section lists timestamped lines labeled audio and me, rendered in both the markdown source and the formatted preview.
Voice transcription. A note can listen to your microphone and system audio and append timestamped transcript lines — transcribed locally by Whisper, so audio never leaves your computer.
A kanban board inside doc-md with columns titled To Do, Doing, and Done, each holding task cards. The board is an ordinary markdown file: columns are headings and cards are checklist items, shown here as draggable cards.
Kanban boards. Any note can become a board — columns and cards stay readable as plain markdown.
A small sticky-note window titled Welcome with a pin icon in its slim header. The note's content is fully formatted: a heading, a checklist with one item checked, and links — no markdown symbols visible.
Sticky notes. Pop any note out as an always-on-top desktop sticky, and toggle them all from the system tray.
The doc-md command palette open over the editor: a search box reading 'Type a command' above a list including Open file, New note, New from template, New kanban board, Daily note, Search notes, and view mode switches.
Command palette. Ctrl+K reaches everything — notes, boards, view modes — without touching the mouse.

Need help?

Something unclear, broken, or missing? Open an issue on GitHub — the templates walk you through what to include. The README covers every feature and keyboard shortcut.