Support
Help with Badger Markdown for Mac and Windows.
Email support@lonebadger.tech with your macOS or Windows version, the app version (Badger Markdown › About Badger Markdown on Mac, Help › About on Windows) and what happened. If a document doesn't render as expected, attaching it helps.
Views
- ⌘E switches between the rendered preview and the source.
- ⌘\ shows source and preview side by side; they scroll together (turn this off in Settings).
- ⌃⌘S shows or hides the outline. Click a heading to jump to it.
- Settings › Open documents in chooses the view new windows start in.
Several documents at once
Each document opens in its own window. Window › Arrange Side by Side (⌥⌘A) tiles every open document across the screen.
“Images need your permission to show”
macOS lets Badger Markdown read only the document you opened. To show images stored next to it, click Allow Access… and choose the folder (or a folder above it, such as your projects folder, to cover everything inside). Badger Markdown remembers the permission.
Live reload
When another app or an AI agent changes an open document, Badger Markdown updates it automatically. If you have unsaved edits, a banner lets you reload the new version or keep yours.
Make Badger Markdown the default for .md files
Open Badger Markdown › Settings and click Make Default. Or, in Finder, choose a .md file, press ⌘I, pick Badger Markdown under Open with, and click Change All….
Quick Look
Select a .md file in Finder and press Space. If you see plain text instead, open Badger Markdown once, then check that its extension is on in System Settings › General › Login Items & Extensions › Quick Look.
On Windows
- Shortcuts: use Ctrl where the Mac uses ⌘. Ctrl+E switches between preview and source, Ctrl+\ shows them side by side, and Ctrl+Alt+S shows or hides the outline. Window › Arrange Side by Side is Ctrl+Alt+A.
- Saving: press Ctrl+S. Unlike on Mac, changes aren't saved automatically; a dot in the title bar means you have unsaved edits.
- Default app: right-click a .md file and choose Open with › Choose another app, pick Badger Markdown and select Always.
- Right-click preview: with the downloaded installer, Preview with Badger Markdown is in File Explorer's right-click menu, under Show more options on Windows 11. With the Microsoft Store version, make it your default app to see this option, or use Open with.
- Security warning when installing: the downloaded installer isn't code-signed, so Windows may warn about an unknown publisher. Choose More info, then Run anyway. The Microsoft Store version doesn't show this warning.
- Linked files: a link to a program shows the file in File Explorer rather than running it, and documents can't load images from network locations other than their own.
- Uninstalling: use Settings › Apps › Installed apps.
Supported Markdown
CommonMark plus GitHub extensions: tables, task lists, strikethrough, autolinks, footnotes and alerts (> [!NOTE]). Also YAML front matter, KaTeX math ($…$ and $$…$$) and Mermaid diagrams in ```mermaid code blocks. Scripts in documents never run.
Privacy
See the privacy policy. In short, we don't collect any data.