# MDCMS

> Open-source headless CMS for Markdown and MDX content

## Docs

- [Agent Instructions](https://docs.mdcms.ai/agent-instructions.md): Copy-pasteable prompts for AI coding agents to set up and configure MDCMS
- [Agent Skills](https://docs.mdcms.ai/agent-skills.md): Install the MDCMS Skills Pack so your AI coding agent can set up MDCMS end-to-end
- [Authentication](https://docs.mdcms.ai/api-reference/authentication.md): API key, session, and CLI authentication endpoints
- [Content API](https://docs.mdcms.ai/api-reference/content.md): Document CRUD, publishing, versioning, and restoration endpoints
- [Error Handling](https://docs.mdcms.ai/api-reference/errors.md): Error response format, codes, and resolve errors
- [Media & Webhooks](https://docs.mdcms.ai/api-reference/media-and-webhooks.md): File upload, media management, and webhook configuration endpoints
- [API Overview](https://docs.mdcms.ai/api-reference/overview.md): Base URL, headers, response format, and pagination
- [Schema API](https://docs.mdcms.ai/api-reference/schema.md): Schema registry endpoints for listing, reading, and syncing content types
- [SDK](https://docs.mdcms.ai/api-reference/sdk.md): TypeScript client SDK for consuming the MDCMS Content API
- [Data Model](https://docs.mdcms.ai/architecture/data-model.md): Database schema, content lifecycle, and localization architecture
- [Migrations](https://docs.mdcms.ai/architecture/migrations.md): Schema evolution and content migration strategies
- [Module System](https://docs.mdcms.ai/architecture/module-system.md): How modules extend server, CLI, and Studio functionality
- [System Overview](https://docs.mdcms.ai/architecture/overview.md): Architecture, deployment topology, technology stack, and design principles
- [Request Flow](https://docs.mdcms.ai/architecture/request-flow.md): HTTP middleware chain, authentication, authorization, and permission model
- [Contributing](https://docs.mdcms.ai/development/contributing.md): Development workflow, branch naming, commit conventions, and code standards
- [Monorepo Packages](https://docs.mdcms.ai/development/packages.md): Overview of all apps and packages in the MDCMS monorepo
- [Local Development Setup](https://docs.mdcms.ai/development/setup.md): Prerequisites, installation, environment variables, and running MDCMS locally
- [Testing](https://docs.mdcms.ai/development/testing.md): Unit tests, integration tests, CI gates, and database migrations
- [CI/CD Integration](https://docs.mdcms.ai/guide/cli/ci-cd.md): Automating schema sync and content deployment in pipelines
- [Commands](https://docs.mdcms.ai/guide/cli/commands.md): Complete reference for all MDCMS CLI commands
- [Configuration](https://docs.mdcms.ai/guide/cli/configuration.md): mdcms.config.ts reference and local state files
- [Installation](https://docs.mdcms.ai/guide/cli/installation.md): Installing and setting up the MDCMS CLI
- [Key Concepts](https://docs.mdcms.ai/guide/concepts.md): Core terminology and mental model for MDCMS
- [Integrating MDCMS](https://docs.mdcms.ai/guide/integration.md): Embed MDCMS Studio and the content SDK into your own application
- [Quick Start](https://docs.mdcms.ai/guide/quickstart.md): Install MDCMS packages and start managing content in your project
- [Defining Content Types](https://docs.mdcms.ai/guide/schema/defining-types.md): Content type definitions, field types, modifiers, and validation with Zod
- [MDX Components](https://docs.mdcms.ai/guide/schema/mdx-components.md): Registering custom components for the Studio editor
- [References](https://docs.mdcms.ai/guide/schema/references.md): Cross-type references, resolution, and error handling
- [Self-Hosting](https://docs.mdcms.ai/guide/self-hosting.md): Stand up your own MDCMS server with Docker Compose
- [Content Editor](https://docs.mdcms.ai/guide/studio/content-editor.md): Creating, editing, and managing documents in the Studio
- [Dashboard](https://docs.mdcms.ai/guide/studio/dashboard.md): Studio dashboard overview, navigation, and embedding setup
- [Localization](https://docs.mdcms.ai/guide/studio/localization.md): Managing multilingual content in the Studio
- [Publishing & Version History](https://docs.mdcms.ai/guide/studio/publishing.md): Draft/publish workflow, version management, and document restoration
- [Settings](https://docs.mdcms.ai/guide/studio/settings.md): Read-only project context and API key management
- [MDCMS](https://docs.mdcms.ai/index.md): Open-source headless CMS for Markdown and MDX content

## OpenAPI Specs

- [openapi](https://docs.mdcms.ai/api-reference/openapi.json)

## Optional

- [GitHub](https://github.com/mdcms-ai/mdcms)