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/
├── assets/
│   ├── images/
│   │   └── favicon.png
│   ├── javascripts/
│   │   ├── lunr/
│   │   │   └── min/
│   │   └── workers/
│   └── stylesheets/
├── docs/
│   ├── draft/
│   │   └── index.html
│   └── index.html
├── index.html
└── test/
    └── index.html