Markopolis

Markopolis is a web application and API server that publishes Markdown notes as websites while exposing a REST API to manage and interact with those notes programmatically. It is designed for personal knowledge bases and simple documentation sites, with an emphasis on Obsidian-compatible Markdown and easy self-hosting.

Key Features

• Publish a folder of Markdown files as a website with instant rendering and theme support
• REST API to upload, list, and retrieve Markdown content and document sections
• Obsidian-flavored Markdown compatibility (callouts, equations, code highlighting)
• Full-text fuzzy search across the notes vault
• CLI and Python package for automating uploads and publishing workflows
• Docker images and docker-compose examples for simple deployment
• API key protection for endpoints and simple site configuration via environment variables

Use Cases

• Host and publish a personal notes vault or Obsidian vault as a searchable website
• Drive static sites or custom frontends by consuming Markdown content through the REST API
• Lightweight documentation site for projects or teams that prefer Markdown-first workflows

Limitations and Considerations

• Relies on a PocketBase-backed datastore (SQLite by default), which may limit scalability for very large deployments
• CLI requires Python 3.12 or newer for some tooling and automation features
• Focused on personal/technical documentation use cases; advanced multi-tenant user management and enterprise access controls are limited

Markopolis is intended for users who want a simple, extensible Markdown publishing platform with an API-first approach. It balances quick setup and practical API access for building custom frontends or automations around Markdown notes.