Skip to content

Frontmatter title not shown in nav-menu when more than one subdirectories #140

@Rfromearth

Description

@Rfromearth

Hello,

thank you for your useful plugin. I don't know if it's a bug or if I missed something.
My observation is that when there are more than one subdirectories the frontmatter 'title' doesn't override the directory name in the nav menu.
The existing filestructure is a book with >120 index.md-Files where every file is situated in its own directory.

The file structure for this example is:

── docs
│   ├── 1.10 notebook
│   │   └── index.md
│   ├── 1.20 notebook (how to get the frontmatter title displayed here)
│   │   ├── 1.20.10 notebook
│   │   │   └── index.md
│   │   ├── 1.20.30 notebook
│   │   │   └── index.md
│   │   └── index.md
│   ├── 2 sitemap
│   │   └── index.md
│   ├── index.md
│   └── .nav.yml
└── mkdocs.yml

.nav.yml:

flatten_single_child_sections: true

nav:
  - index.md
  - "*"
  - "2 sitemap/index.md"

/docs/1.20 notebook (how to get the frontmatter title displayed here)/index.md:

---
title: "Title 1.20"
date: 2025-10-11
categories: 
  - "texte"
---

blabla

The result:

Image

Versions:
mkdocs == 1.6.1
mkdocs-awesome-nav == 3.2.0
(mkdocs-material == 9.6.21)

My simple question is: How do I get 'Title 1.20' displayed in the nav menu?

Thank you in advance for taking a look into my issue.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions