mrmd

Collaborative markdown notebooks - edit and run code together.

Quick Start

# Run directly with uvx (no install needed)
uvx mrmd

# Or install and run
pip install mrmd
mrmd

What it does

mrmd opens a collaborative markdown editor in your browser. You can:

Write markdown with live preview
Add executable code blocks (Python, JavaScript, etc.)
Collaborate in real-time with others
Run code and see output inline

Usage

# Open editor in current project
mrmd

# Use custom docs directory
mrmd --docs ./notes

# Use custom port
mrmd --port 3000

# Don't open browser automatically
mrmd --no-browser

How it works

mrmd automatically detects your project root by looking for common markers:

.git - Git repository
.venv - Python virtual environment
pyproject.toml - Python project
package.json - Node.js project
etc.

It then:

Starts a sync server for real-time collaboration (Yjs/CRDT)
Starts a Python runtime for code execution
Serves the editor UI
Opens your browser

Documents are saved to the docs/ directory in your project (or notebooks/, notes/ if they exist).

Development

# Clone the repo
git clone https://github.com/anthropics/mrmd-packages
cd mrmd-packages/mrmd

# Install in development mode
uv pip install -e .

# Run
mrmd

License

MIT

Metadata

Release files for mrmd 0.10.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mrmd 0.10.1
File	Size	Uploaded
mrmd-0.10.1.tar.gz	37.3 kB	Jan 25, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mrmd 0.10.1
File	Interpreter	ABI	Platform	Reset
mrmd-0.10.1-py3-none-any.whl 44.3 kB Jan 25, 2026	Python 3	none	any	Details

Total release size: 81.6 kB

Release files / mrmd-0.10.1.tar.gz

Download URL	mrmd-0.10.1.tar.gz
Size	37.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`33fe9c786dc848f71cbf8e9a043d8858529e1ebe541f0031af2ed94068f98bfe`
BLAKE2b-256 checksum How to use checksums	`f8cbab7b77c15a1fcd39f637cd9c9a81b1df5dc326e326de5a2d98005c2577c0`
Upload date	Jan 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.12`

Release files / mrmd-0.10.1-py3-none-any.whl

Download URL	mrmd-0.10.1-py3-none-any.whl
Size	44.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c6802e7f7410b260d52d181b3ecf6c068ff09a22b388399158c0ea658a470fc2`
BLAKE2b-256 checksum How to use checksums	`cfc972334e5a02eed17551b2c36597d4449d96b4dc837867ee18e457b3ac4c1a`
Upload date	Jan 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.12`