search

oprypin / mkdocs-literate-nav

MkDocs plugin to specify the navigation in Markdown instead of YAML
https://oprypin.github.io/mkdocs-literate-nav
MIT License
73 stars 8 forks source link

Allow headers to define sections #12

Open adamant-pwn opened 2 years ago

adamant-pwn commented 2 years ago

For larger sites, whole navigation table could take much more than a single screen. It would be very nice if using headers at least for top-level sections is allowed. So, e.g.

# section 1
    - subsection 1
        - [article 1](...)
        - [article 2](...)
    - [article 3](...)
# section 2
...

Ideal scenario would be to allow freely changing between headers and lists.

oprypin commented 1 year ago

This makes sense to me. Just seems painful to implement