Markopolis
Self-hosted server and API to publish Markdown notes
180 stars 3 forks last commit first released MIT
Likely dormant
No commits since 21 Oct 2024. Expect to maintain it yourself or pick an alternative.
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.
Categories:
Tags:
Tech Stack:
Similar to Markopolis
EventCatalog
Documentation portal for event-driven and microservice architectures
Open source architecture documentation tool to model and document domains, services, events, and schemas for event-driven and microservice systems.
Superdesk
End-to-end newsroom platform and headless CMS for news publishing
Open-source digital newsroom platform for news creation, curation, workflow, and multi-channel distribution, built around an API-centric headless CMS.
linkding
Minimal self-hosted bookmark manager with tags, notes, and archiving
Self-hosted bookmark manager with tagging, notes, read-it-later, sharing, archiving, import/export, browser extensions, and a REST API.
Papra
Minimalistic document management and archiving platform
Minimalistic document management and archiving platform for long-term storage, full-text search, tagging, and automated ingestion via email or folders.
flatnotes
Database-less Markdown note-taking web app with full-text search
Self-hosted, database-less note-taking web app that stores notes as plain Markdown files in a folder, with tagging, wiki links, and full-text search.
Zen
Lightweight self-hosted notes app with Markdown and SQLite
Zen is a minimal self-hosted notes app that stores notes as Markdown with a local SQLite database, featuring fast full-text search, tagging, templates, and low resource usage.
