# markopolis

> Markopolis is an open-source, self-hosted web app and API server that publishes Markdown notes as websites with full-text search and Obsidian-compatible syntax.

- **Category:** Notes & Editors
- **Licence:** MIT
- **Latest version:** 3.0.2
- **Open source:** oss
- **Languages:** Typescript, Svelte
- **Platforms:** Docker Compose
- **Tags:** Markdown, CLI, REST API, Publishing, Sveltekit, Obsidian, Pocketbase, Docker, Self Hosted, Note Taking

## Description

Markopolis is a self-hosted Markdown publishing platform created by Rishikanth Chandrasekaran. It lets you point the server at a folder of Markdown files and instantly serves them as a website with a clean UI. The platform includes a PocketBase backend exposing a REST API for programmatic access to notes, a SvelteKit frontend with dark/light themes, full-text fuzzy search, and support for Obsidian-flavored Markdown including callouts, equations, Mermaid diagrams, and code highlighting. A Python CLI tool (requiring Python 3.12+) handles publishing notes to the server. Deployment is via a single Docker image (ghcr.io/rishikanthc/markopolis) that runs both PocketBase on port 8080 and the frontend on port 3000. The project is MIT-licensed and actively maintained.

## Links

- [Homepage](https://github.com/rishikanthc/markopolis)
- [Website](https://markopolis.app)
- [Docker](ghcr.io/rishikanthc/markopolis)
- [GitHub Repository](https://github.com/rishikanthc/markopolis)

---
Source: https://selfhost.directory/project/markopolis