mdspec - auto sync your md files

mdspec is a Git‑native tool that synchronizes markdown files from a repository to external platforms such as ClickUp, S3, Notion, and Confluence. Users place a .mdspecmap file in a folder to define the integration and scope, then add a single step to a GitHub Actions workflow; on each push to the main branch the service detects changed files via git diff and publishes only those updates to the configured destinations.

The system supports multiple integrations from a single repository, allowing different folders to target different tools while sharing the same code base. Optional agent templates can transform specifications after publishing, for example generating task summaries or release notes. Files removed from the repository remain in the target tool, providing a backup of published documentation.

mdspec runs on Vercel infrastructure that holds SOC 2 Type II and ISO 27001 certifications, and it does not retain content outside the source repository, ensuring compliance and security for engineering teams that need automated markdown distribution.