Skip to content

MkDocs Deploy

Reusable workflow for publishing MkDocs to Cloudflare Pages.

File: .github/workflows/docs-mkdocs-deploy.yml

Use it only after the publication and access-control model is clear.

When a project has no requirements.txt, the workflow installs the legacy toolset used by middagtec/image-bitbucket-ci, including mkdocs-material, include-markdown, mermaid2, section-index, glightbox, macros, minify, swagger-ui-tag, autolinks, and pymdown-extensions.

yaml
jobs:
  deploy-docs:
    uses: middag-io/.github-private/.github/workflows/docs-mkdocs-deploy.yml@workflows-v1
    with:
      project-name: my-project-docs
    secrets: inherit

MIDDAG Tecnologia