# Custom navbar ## HTML If you need custom navigation, you can create a HTML-based navigation bar. !> Note that documentation links begin with `#/`. ```html
``` ## Markdown Alternatively, you can create a custom markdown-based navigation file by setting `loadNavbar` to **true** and creating `_navbar.md`, compare [load-navbar configuration](configuration.md#load-navbar). ```html ``` ```markdown - [En](/) - [chinese](/zh-cn/) ``` !> You need to create a `.nojekyll` in `./docs` to prevent GitHub Pages from ignoring files that begin with an underscore. `_navbar.md` is loaded from each level directory. If the current directory doesn't have `_navbar.md`, it will fall back to the parent directory. If, for example, the current path is `/guide/quick-start`, the `_navbar.md` will be loaded from `/guide/_navbar.md`. ## Nesting You can create sub-lists by indenting items that are under a certain parent. ```markdown - Getting started - [Quick start](quickstart.md) - [Writing more pages](more-pages.md) - [Custom navbar](custom-navbar.md) - [Cover page](cover.md) - Configuration - [Configuration](configuration.md) - [Themes](themes.md) - [Using plugins](plugins.md) - [Markdown configuration](markdown.md) - [Language highlight](language-highlight.md) ``` renders as ![Nesting navbar](_images/nested-navbar.png "Nesting navbar") ## Combining custom navbars with the emoji plugin If you use the [emoji plugin](plugins#emoji): ```html ``` you could, for example, use flag emojis in your custom navbar Markdown file: ```markdown - [:us:, :uk:](/) - [:cn:](/zh-cn/) ```