Automatic entries for nav in mkdocs.yml

[DorKeinath]

Is it possible not to have to write the md-site-urls into mkdocs.yml and instead of this all pages in my folder-structure are displayed automatically?

For example is it possible to write something like the following?

nav:
    - Folder One:
        - Intro: folder1/index.md
        - Content of Folder One:
            - {list all md-pages from folder1 here}

[alexvoss]

The default behaviour if you do not have a nav: section is to list the pages as they appear in the directory. However, once you specify more than an empty nav:section in mkdocs.yml you need to specify the full contents. You could write a hook that attaches itself to the on_nav event and modifies the navigation to suit your needs.

[alexvoss]

Or, as I am just learning myself by looking at another post, it seems that the mkdocs-awesome-pages-plugin might help?

[kamilkrzyskow]

You could use the awesome-pages plugin
https://github.com/lukasgeiter/mkdocs-awesome-pages-plugin

You'd move the nav creation to another file, and then only specify the directory name to list all pages inside it.