Skip to content
jackskip22Public

About

Fast Markdown editor for notes, diagrams, drawing & watercolor painting in a single HTML file. Web, Android (Play Store), Windows & Linux. Phone-first, works anywhere, offline. Optional free sync to your own Cloudflare account. Collaborate with AI agents over MCP & WebMCP for free. Embeddable editor and lightweight Markdown reader build ~400kB

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Rapier - Markdown Editor & Art

Rapier is a minimalistic writing app designed to be fast and beautiful on any device, but the Android app provides the best experience. It also has a Draw mode with an SVG editor, freehand brushes, watercolors and typographic art. Supports Mermaid diagrams and flowcharts.

Everything is plain Markdown. Pictures, drawings and paintings are embedded inside the file. Documents in Rapier are single files you can open in other Markdown apps or any browser, now or in 20 years.

  • Write Markdown, plain text and code, with tables, checklists, footnotes, LaTeX, Mermaid diagrams, comments, compare and read aloud. Switch to the Markdown source without losing your place.
  • Add pictures that are saved inside the file as JPEG XL by Rapier's own encoder, so files stay small and pictures stay sharp.
  • Draw with a finger or a stylus. Boxes and arrows stay tidy, and drawings are SVGs you can edit later.
  • Paint with watercolors that flow, mix and dry, or with oil, pencil and MyPaint brushes.
  • Keep notes as cards with colors, pins, checklists, reminders and voice recordings. Import them from Google Keep, Apple Notes, Evernote, Notion, Obsidian and Joplin.
  • Open and export Word and PDF, and export an HTML page that opens offline in any browser.

Get Rapier

  • Android: Google Play. About 3 MB, no internet permission, no tracking, no ads.
  • Web: rapier.website. Add it to your home screen and it works offline.
  • One HTML file: rapier.html is the whole editor, and rapier-reader.html just reads. Open either in a browser.
  • Windows (beta): Rapier.exe (version 1.2.66). If SmartScreen warns, choose More info, then Run anyway.
  • Linux (beta, x86_64): rapier-linux (version 1.2.66). Run chmod +x rapier-linux && ./rapier-linux --install once. Requirements.

With AI agents

Claude, ChatGPT and any MCP client can work in a document with you. Connect to https://mcp.rapier.website/door/mcp and say "open Rapier". You watch every change and can undo any of it. In ChatGPT, add the OpenAI connector at https://mcp.rapier.website/openai/mcp in developer mode.

claude plugin marketplace add jackskip22/rapier-plugins && claude plugin install rapier@rapier
npx rapier-html notes.md                          # the editor and the document in one offline HTML file
npx rapier-html revised.md --compare original.md  # an edit beside its original

More in the agent guide, llms.txt, AGENT-TOOLS.json and the skills.

In your own app

import {Rapier} from 'rapier-embed';
const editor = Rapier.mount(document.querySelector('#editor'), {
  sessionId, documentId,
  load: {content, filename: 'notes.md', revision},
  save: ({requestId, content, baseRevision}) => store.writeOnce({documentId, requestId, content, baseRevision}),
});

Your app keeps the document and its storage. save returns {revision} once it is stored, or throws Rapier.conflict(currentRevision). build: 'reader' mounts the reader. See the embed skill and the embed contract.

Markdown

Rapier writes CommonMark that other Markdown apps read, with pictures inside the file: the standard, how other apps show it, adopting it and examples.

Build

  • (cd src && node tools/build.mjs) builds rapier.html from src/ (build.json).
  • (cd src && RAPIER_PROFILE=reader node tools/build.mjs) builds the reader.
  • npx wrangler deploy serves it with the included configuration.

License

AGPL-3.0-only with the stated terms. The reusable modules are MIT. A commercial license is available (LICENSING.md). Contributions are welcome: see CONTRIBUTING.md and SECURITY.md.

Related: rapier-jxl and will.

About

Fast Markdown editor for notes, diagrams, drawing & watercolor painting in a single HTML file. Web, Android (Play Store), Windows & Linux. Phone-first, works anywhere, offline. Optional free sync to your own Cloudflare account. Collaborate with AI agents over MCP & WebMCP for free. Embeddable editor and lightweight Markdown reader build ~400kB

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages