Skip to content

lukataylo/soffit

Repository files navigation

Soffit

A native Mac workspace for markdown.

Tile any folder. Edit. Preview. Sketch. All in one window.

macOS 14+ Swift 5.9 License: MIT Release

Why

Markdown lives in folders. Folders should live in panes.

Drag a tab. Split it. Edit a PRD beside a mermaid diagram beside a Figma frame beside a terminal running claude.

No vault. No plugin manager. No syncing service. Your files stay where you put them.

For the post-Obsidian crowd who'd rather not run Electron.

Install

Download Soffit-0.3.0.dmg → drag to Applications → right-click Open the first time.

Requires macOS 14. Apple Silicon preferred. Intel will do.

Or build from source — see the Quickstart.

In the box

  • Markdown editor — Preview, Source, Split. Real GFM rendering. Tables. Code. Lists. The works.
  • Search everything⌘P jumps to any file. ⌘⇧F searches every word in the workspace. [[wiki-links]] and a tag browser stitch your notes together.
  • Mermaid diagrams — render .mmd files inline. No internet required.
  • Web embeds — Figma frames, localhost dashboards, anything WKWebView loads.
  • Embedded terminal — drop into claude, git, vim. Whatever you'd put in iTerm.
  • Tile anything — drag any tab onto any pane. A compass picks the side.
  • It remembers — quit, reopen. Panes, tabs, modes: exactly where you left them.
  • Multi-window⌘N for a new window. Each one has its own panes; one workspace, one index, no conflict.

Docs

The wiki has the rest:

Quickstart · Markdown editing · Search and navigation · Keyboard shortcuts · Providers · Persistence · Architecture · FAQ

Implementation tradeoffs and decisions live in DECISIONS.md.

License

MIT — see LICENSE.