Fast, minimal web editor that makes markdown editing collaborative and accessible to everyone.
> I want to edit markdown files with my friends, but sending/resending files, changing viewing access, version control, and previewing are just too much work.
> ? why not create a google doc for collaborative markdown editing, without having to log into Google, change view/edit access, worry about previewing the file, etc?
> Voilà, after hours of
LetsMarkdown.com is born!
- Live collaborative markdown editing and preview
- VSCode-like editor with support for command palette (syntax highlighting, autocomplete, editor themes…)
- Minimal setup with no login required – say goodbye to malicious trackers and privacy invasions
- Efficient backend built with Rust and WebAssembly
- Dark mode (duh)
- Emoji support with shortcuts enabled
- (Upcoming) cursors tracking, synced scrolling, subscript/footnote/insert support, and more
- Fontend: React.js (TypeSript), Vite.js, Chakra UI
- Editor & markdown preview: Monaco, mardown-it.js, highlight.js
- Banckend: Rust, WebAssembly, Node.js
- Deployment & hosting: Docker, DigitalOcean
- CI/CD: Github Action
- Formatting: Prettier, Rustfmt
- Design & prototyping: Figma
This application is built using a backend operational transformation control server written in Rust (based on Rustpad), and a frontend written in TypeScript using React.js.
The backend server supports real-time collaborative editing sessions, and the frontend offers a collaborative text editor with built-in markdown syntax highlighting and auto-completion. These parts of the application are connected via WebSocket communication.
For markdown previewing, I used the
markdown-it.js library to dynamically render
the markdown file. To style the markdown file, I also created a custom
To develop this application locally, you need to:
Node.js. Verify your installation
rustup -V && wasm-pack -V && npm -v
Then, build the WebAssembly part of the app:
wasm-pack build --target web letsmarkdown-wasm
After that, install the dependencies for the React application:
Next, you can compile and run the backend web server:
While the backend is running, open another shell and run the following command to start the frontend dev server.
npm run dev
This command will open a browser window to
http://localhost:3000, with hot
reloading enabled on saved changes.
LetsMarkdown.com is distributed as a single 12 MB
Docker image, which is built automatically from the
Dockerfile in this
repository. You can pull the latest version of this image from Docker Hub. It
has multi-platform support for linux/amd64 and linux/arm64.
docker pull cveinnt/letsmarkdown
(You can also manually build this image with
docker build -t rustpad . in the
project root directory.) To run locally, execute the following command, then
http://localhost:3030 in your browser.
docker run --rm -dp 3030:3030 cveinnt/letsmarkdown
I deploy a public instance of this image with DigitalOcean App Platform.
This project is still in a very early phase. If you’re interested in adding new features or fixing bugs, please reach out to me by creating a GitHub issue!
I plan to integrate this repository continuously, and the code base already
accounts for things like code style (Prettier, Rustfmt) and build success
(Docker). The current state of the
main branch is continuously deployed to the
production web server at LetsMarkdown.com.
LetsMarkdown.com is inspired by composing.studio, which is based on Rustpad.
All code is licensed under the MIT license.