markoun
Markoun is a lightweight, self-hosted, file-based Markdown editor designed for privacy-focused users who prioritize simplicity over features.
Ficha actualizada 23 sept 2026, 4:01 · upstream 23 sept 2026, 3:45 · release v0.2.8
Qué es markoun
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
A self-hosted, file-based Markdown editor that works directly on local files without requiring databases or indexing. The UI layout is inspired by Haptic and Obsidian, offering a clean interface with smooth animations. Key features include version history tracking, MCP (Model Context Protocol) integration for AI agent workspace management, LaTeX support in live preview, clipboard image paste functionality, and flexible configuration via config.yaml.
- Personal note-taking on local devices without cloud dependencies
- Privacy-focused documentation where data should never leave the machine
- Academic or research workflows with version control for documents
- Lightweight collaboration tools that don't require a central server
- Archiving and preserving Markdown content offline
- Simple note-taking apps for users who prefer minimal interfaces
- Fully file-based architecture with no database or indexing required, making it portable and privacy-friendly
- MCP integration allows AI agents to manage workspace files through scoped API keys
- Live LaTeX preview in the Markdown editor for technical documentation
- Keyboard shortcuts including paste clipboard images without leaving the editor
- Drag-and-drop file uploads directly into folders within the sidebar
- Version history tracking with branching support for document evolution
- Static image routes lack authentication checks, meaning unauthenticated users can view protected media
- File system architecture could be further optimized for performance and scalability
- UI animations are incomplete, resulting in inconsistent feedback during interactions
- Limited settings expansion beyond the current config.yaml options
- MCP and API key management is unavailable when authentication is disabled
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Deploy Markoun using Docker (with or without compose), Nix flakes, or manual installation. For Docker Compose, copy docker-compose.yaml to a local .env file with PORT, MARKOUN_ROOT, and admin credentials. The default admin password can be changed via environment variables at startup. Persistent data is stored in XDG user directories under $XDG_DATA_HOME/markoun/data/. Always backup your config.yaml before modifying it.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.