Is it possible to put the nav tabs in the top nav bar?

[swills1]

We all know we can have a top nav, but that nav is under the bar with the site title, search, git info, etc. If you have maybe two links, an entire separate second bar under that top bar doesn't make sense / wastes space. Also, if your links are in the top bar, they scroll with the page and are always right there to click.

Is it possible to move the nav top / nav tabs into the very top navbar next to the site title?

[kamilkrzyskow]

Hello @swills1,
yes it's possible, though it's considered a heavy customization which requires custom templates and CSS.

You could look at the Blender developer docs to see how they implemented a custom header, and do so similarly.
You can look at nav.html and nav-item.html templates to see how they process the Navigation provided by MkDocs.

Reference:

• https://squidfunk.github.io/mkdocs-material/customization/#extending-the-theme
• https://developer.blender.org/docs/
• https://projects.blender.org/blender/blender-developer-docs/src/branch/main/theme_overrides
• https://github.com/squidfunk/mkdocs-material/blob/4c0004e16b1d51511fbd3c8537394069f004ecfe/src/templates/partials/header.html
• https://github.com/squidfunk/mkdocs-material/blob/4c0004e16b1d51511fbd3c8537394069f004ecfe/src/templates/partials/nav.html
• https://github.com/squidfunk/mkdocs-material/blob/4c0004e16b1d51511fbd3c8537394069f004ecfe/src/templates/partials/nav-item.html

[swills1]

Thanks, I see exacty how they did it.