Hi everyone 👋

I’d like to share an open-source side project I made: marp-server – a docker-compose powered environment that combines:

• 📄 Left pane: VS Code in the browser (via code-server)

• 🎞 Right pane: Live-reloading slide preview from marp-cli using browser-sync

Everything runs in a single web page – open your browser, and you can write and preview slides in real-time side-by-side.

✨ Key Features

• Live two-pane interface: Write Markdown in the VS Code editor on the left and instantly see the rendered slides on the right.

• Fully Dockerized: Just run docker-compose up -d and it works.

• Based on Marp CLI's server mode but enhanced with collaborative editing and better UX.

• LAN-friendly: Perfect for local teams – deploy once on a machine and let others in the same network access and collaborate on slide decks via browser.

• Open-source: Modify and host your own version freely.

💡 Use Cases

• Team slide collaboration in offices or classrooms

• Shared editing in family networks

• Local demo setup to showcase Marp

• Self-hosted Markdown slide environment with no vendor lock-in

🖼 Demo Screenshot

🔧 Try it out

git clone https://github.com/moskensoap/marp-server.git
cd marp-server
sudo docker-compose up -d

Then open http://localhost:38888/ (or replace with your server’s IP) in your browser.

If you encounter permission issues, you can navigate to the parent directory (marp-server/..) and run sudo chmod -R 0777 marp-server to fix the permissions.

Let me know what you think, and I’d love feedback or suggestions!

Thanks to the awesome Marp team for the tools 🙌