https://github.com/tiwut/docker-md-server
A lightweight, 100% C++ written web server for hosting Markdown files, featuring an integrated web file manager.
https://github.com/tiwut/docker-md-server
docker markdown-language web-server
Last synced: about 1 month ago
JSON representation
A lightweight, 100% C++ written web server for hosting Markdown files, featuring an integrated web file manager.
- Host: GitHub
- URL: https://github.com/tiwut/docker-md-server
- Owner: tiwut
- License: mit
- Created: 2026-05-23T18:21:41.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-23T18:27:29.000Z (about 2 months ago)
- Last Synced: 2026-05-23T20:17:17.091Z (about 2 months ago)
- Topics: docker, markdown-language, web-server
- Language: C++
- Homepage: https://hub.docker.com/r/tiwutdev/docker-md-server
- Size: 9.77 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Tiwut Docker Markdown Server
```yaml
version: '3.8'
services:
md-server:
image: tiwutdev/docker-md-server:latest
ports:
- "8080:8080"
- "8081:8081"
volumes:
- ./www:/app/www
restart: unless-stopped
```
A lightweight, 100% C++ written web server for hosting Markdown files, featuring an integrated web file manager.
## Architecture
- **Pure C++17:** Zero external dependencies (only requires libc/libstdc++).
- **Public Port (8080):** Renders `.md` files dynamically in the browser using `marked.js`. Supports custom CSS and JS.
- **Admin Port (8081):** Full web UI for file management (editor, upload, folder creation, rename, delete, copy).
## Setup & Run
1. Build and start the container using Docker Compose:
```bash
docker-compose up -d --build
```
- **Accessing the Server:**
- **Frontend:** [http://localhost:8080](https://www.google.com/search?q=http://localhost:8080)
- **Admin UI:** [http://localhost:8081](https://www.google.com/search?q=http://localhost:8081)
## File Structure
All files are saved in the local directory ./www, mounted into the container via Docker volumes.
- index.md: The main page.
- style.css: Styling (dark mode design included).
- script.js: Your custom JavaScript.
## Admin Panel Features
- **Live Editor:** Edit Markdown, CSS, and JS files directly in the browser.
- **Hotkeys:** Save changes quickly using Ctrl + S.
- **Upload:** Use the upload button to easily deploy assets like images or PDFs.
- **Security:** Path sanitization blocks directory traversal attacks (../).