https://github.com/lukataylo/soffit

A native Mac workspace for markdown. Tile any folder. Edit. Preview. Sketch. All in one window.
https://github.com/lukataylo/soffit

anthropic appkit claude knowledge-management local-first macos markdown markdown-editor mermaid note-taking nssplitview obsidian-alternative swift swiftui

Last synced: 25 days ago
JSON representation

A native Mac workspace for markdown. Tile any folder. Edit. Preview. Sketch. All in one window.

• Host: GitHub
• URL: https://github.com/lukataylo/soffit
• Owner: lukataylo
• License: mit
• Created: 2026-04-19T12:41:59.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2026-05-03T11:47:37.000Z (2 months ago)
• Last Synced: 2026-05-03T12:09:03.377Z (2 months ago)
• Topics: anthropic, appkit, claude, knowledge-management, local-first, macos, markdown, markdown-editor, mermaid, note-taking, nssplitview, obsidian-alternative, swift, swiftui
• Language: Swift
• Homepage: https://github.com/lukataylo/soffit/wiki
• Size: 3.43 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


# Soffit

**A native Mac workspace for markdown.**

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

![](assets/hero.png)

![macOS 14+](https://img.shields.io/badge/macOS-14+-black?style=flat-square&logo=apple&logoColor=white)

![Swift 5.9](https://img.shields.io/badge/Swift-5.9-orange?style=flat-square&logo=swift&logoColor=white)

![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)

![Release](https://img.shields.io/github/v/release/lukataylo/soffit?style=flat-square&color=success)



## 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**](https://github.com/lukataylo/soffit/releases/latest) → 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](https://github.com/lukataylo/soffit/wiki/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](https://github.com/lukataylo/soffit/wiki) has the rest:

[Quickstart](https://github.com/lukataylo/soffit/wiki/Quickstart) · [Markdown editing](https://github.com/lukataylo/soffit/wiki/Markdown-editing) · [Search and navigation](https://github.com/lukataylo/soffit/wiki/Search-and-navigation) · [Keyboard shortcuts](https://github.com/lukataylo/soffit/wiki/Keyboard-shortcuts) · [Providers](https://github.com/lukataylo/soffit/wiki/Providers) · [Persistence](https://github.com/lukataylo/soffit/wiki/Persistence) · [Architecture](https://github.com/lukataylo/soffit/wiki/Architecture) · [FAQ](https://github.com/lukataylo/soffit/wiki/FAQ)

Implementation tradeoffs and decisions live in [`DECISIONS.md`](DECISIONS.md).

## License

MIT — see [LICENSE](LICENSE).