Skip to content

Don't merge docs folder

mkdocs.yml

# This example shows how to keep the docs folder embedded within your other docs.
site_name: ok-mkdocs-docs-no-merge
plugins:
  - simple:
        merge_docs_dir: false

Input

ok-mkdocs-docs-no-merge/
├── docs/
│   ├── draft.md
│   └── index.md
├── mkdocs.yml
├── README.md
└── test.md

Output

site/
├── docs/
│   ├── draft/
│   │   └── index.html
│   └── index.html
├── index.html
└── test/
    └── index.html