Get it for macOS

Edit Markdown files like a Word document, inserting tables, diagrams, callouts and templates from a / menu instead of typing syntax. A save rewrites only the blocks you changed, so untouched text keeps its exact bytes and git diffs stay small. Eight Mermaid starters render as live diagrams while you edit their source, and eleven document templates fill an empty file in one click. Every save checks the file's hash first: if an agent changed it while you typed, autosave pauses and you compare, keep yours or take theirs. Files with footnotes, reference-style links or $$ math open read-only in bb's preview; needs bb 0.49 or later and no account or external service.


Overview

View source

What you get

  • A rich editor for every Markdown file. .md and .markdown files open in the side panel as a formatted document, with a toolbar and a bubble over any selection for bold, italic, strikethrough, code and links.
  • A / menu and a + button for every block. Insert headings, quotes, dividers, bulleted, numbered and check lists, tables, code blocks, images, five GitHub callouts (Note, Tip, Important, Warning, Caution) and eight Mermaid diagram starters. Type to filter: /todo, /diagram, /warn.
  • Eleven document templates. An empty file offers README, meeting notes, ADR, PRD, RFC, changelog entry, bug report, runbook, PR description, incident postmortem and weekly status. Any template can also be inserted at the cursor.
  • Live Mermaid diagrams. A mermaid block renders as a diagram through bb's own renderer. Edit diagram shows the source, and the diagram follows as you type.
  • Tables you can type into. Tab moves between cells, Tab in the last cell adds a row, and a table toolbar adds or removes rows and columns.

How saving works

  • A save rewrites only the blocks you changed. Untouched blocks keep their exact bytes, including list markers, table padding, front matter, raw HTML and line endings, so git diffs stay small. Opening a file never writes to it.
  • Autosave runs 800 ms after you stop typing, and ⌘S saves at once.
  • Every write checks the file's hash first. If an agent changed the file while you had unsaved edits, autosave pauses and a banner offers Compare (a diff of both versions), Use theirs or Keep mine. If you have no unsaved edits, the agent's change appears in place without moving your cursor.

What opens read-only

A file the editor can't save back exactly opens in bb's normal preview, with the reason and an Edit source button: footnotes, reference-style links, $$ math, MDX, and files over 600 KB. Raw HTML is fine. It shows as source and is never executed.

Requirements

bb 0.49 or later. The editor reads and writes files on the machine they belong to through bb's own file API. It needs no account, API key or external service, and sends nothing off the machine.

The bundled agent skill tells agents which Markdown stays editable, such as callouts, mermaid fences and pipe tables, and which turns rich editing off.

To make it the default for Markdown, choose Markwright for md under Settings → File openers.

More from Muhammad Ahsan

GitHub PR DashboardSee why each pull request is stuck, and get it unstuck, without leaving bb. My PRs lists your pull requests, review requests for you and your teams, the ones you reviewed, and assigned ones by repository, each with its +/- lines and led by what blocks it: failing CI down to the job, changes requested, unresolved comments, conflicts or a stack. Reviewed turns amber when the author pushes after your review. Open one for its reviewers and their verdicts, labels, and tabs: Overview (the description, then comments and reviews), Checks with error annotations, Files with syntax-highlighted diffs and review threads under their lines, Commits with the ones since your review marked, and Comments. Edit the title and description, comment on a line or range, reply, delete your own comments, submit a review, mark your draft ready, and close or reopen, each only when you click. A menu links the PR to a bb thread, asks about it, explains it, or sends every finding to an agent, starting in the PR's project; Fix with agent does it for one comment or failed job. Jira keys open in bb's My Jira plugin. Search, hide or fold repositories, move by keyboard, switch gh accounts, and get alerts when CI fails or someone comments. Uses the GitHub CLI login or a token; github.com only.NewUsage ExplorerSee how much of your Claude plan is left and where your AI coding spend went, by session, day and model, across every agent CLI you use. Each limit window shows what is left, when it resets and where you will land at your current pace, with a plain verdict on whether there is room for a big task. Sessions carry their titles and projects; open one for its models and its cost by token type, or click a model to filter the whole page. Reads Claude Code, Codex, Gemini CLI, OpenCode and the other CLIs ccusage supports from their local logs, and draws each provider in its own colour. Prices come from LiteLLM's public price list, so a newly released model is priced without a plugin update. Plan limits use the Claude Code sign-in already on your machine and need a Claude subscription.Newbb DashboardsDashboards built by prompting an agent that open in their own side-panel tab, stay interactive, refresh their own data and change when you ask again.NewJira BoardSee every Jira ticket assigned to you in one bb tab, filtered and grouped the way you work, and move it along without opening Jira. Filter by status and type, search by key or words, and group by status, initiative and epic, or the boards that list each ticket. Open a ticket beside the list to read its lineage, description, subtasks and comments, then step to the next one with Previous and Next or the keyboard. Change a status in place from the moves your workflow allows. Needs Jira Cloud with Atlassian's Rovo MCP server allowed for your organization; you sign in with Atlassian in the browser and set up nothing else.New

More in File Viewers & Editors 40

Browse, open, preview, or edit files and document vaults.

View all
File ManagerManage the files on the machine bb runs on without a terminal: browse, upload, move, rename, extract and hand them to the agent. Opens as a sidebar page, as a tab beside a thread that can start in that thread's folder, and from a file link in a message. Double-click shows images, PDF, video, Markdown and code; Space looks inside zip, tar, 7z and rar archives without extracting them. Multi-gigabyte uploads resume after a dropped connection, and several files or a whole folder download as one zip. On a phone, selected rows get an Actions bar with the whole row menu. Access stays inside the home folder of the user bb runs as; tar, 7z and rar archives need tar and 7z on that machine.Foma677
FilesA VS Code-style file explorer and editor for the workspace behind a thread. Search in files finds a word across every file in the project: results are grouped by file with each hit highlighted, and clicking one opens the file on that line. It is smart case, with match-case, whole-word and regex toggles, and built for typing — file contents stay in memory between searches, so refining a query re-runs in tens of milliseconds, and a regex runs in its own worker so a runaway pattern cannot freeze BB. Around it: a file tree that shows dotfiles, editor tabs, a go-to-file palette (Cmd+P), find in the open file (Cmd+F), syntax highlighting in your BB code theme, and edit and save guarded so a change an agent made underneath you is never clobbered. Markdown files open rendered, with the source and the editor one click away. Two pickers choose the project and then its checkout or one of its worktrees; beside a thread it is pinned to that thread's worktree. Adds a `bb files` command so agents can browse and read the same workspace from the CLI, on whichever machine it lives.AbdElrahman Telb532