Getting started
Install Bungu, open your first document, and learn the four view modes.
Requirements
- macOS 14 (Sonoma) or later
- Apple Silicon (M1 or later) — Bungu’s on-device AI is built for Apple Silicon and requires it
- Disk space for AI models if you use chat: about 8.6 GB for the full set (fast model 3.4 GB, deep model 4.9 GB, embedder 340 MB). The editor works fully without them.
Install
Download the DMG from the download page, open it, and drag Bungu to Applications. The app is notarized; macOS may ask you to confirm the first launch.
Open something
- A file: ⌘O, drag a
.mdfile onto the window, or double-click one in Finder once Bungu is your default markdown app. - A folder: ⌘⇧O adds it to the sidebar. Each folder shows its markdown tree (
.md,.markdown,.mdown, and friends), live-refreshes when files change on disk, and persists across launches. Add as many folders as you want and drag to reorder them. - Quick Open: ⌘K fuzzy-finds any file across your workspace folders — including by meaning, not just filename, once the workspace index is built.
View modes
| Shortcut | Mode |
|---|---|
| ⌘1 | Raw — just the markdown source |
| ⌘2 | Raw + Polished — source and rendered page side by side (default) |
| ⌘3 | Polished — just the rendered page |
| ⌘4 | Diff — your working copy against git HEAD |
Both panes are editable: type markdown on the left, or click into the rendered page and edit there — changes round-trip back to the source.
Make Bungu your default markdown app
Finder → right-click a .md file → Get Info → Open With → Bungu → Change All…
Or from the terminal, covering every markdown extension:
brew install duti
duti -s app.bungu.mac md all
duti -s app.bungu.mac markdown all
duti -s app.bungu.mac net.daringfireball.markdown all