This section is a work in progress.
To remove the ability to switch on dark mode, there is an option
themeConfig.disableDarkMode, which is implicitly set to
With the enabled
defaultDarkMode option you could set dark mode by default. However, in this case, the user's preference will not be taken into account until they manually sets the desired mode via toggle in the navbar.
You can configure a default image that will be used for your meta tag, in particular
Sometimes you want to announce something in your website. Just for such a case, you can add an announcement bar. This is a non-fixed and dismissable panel above the navbar.
React hook to access theme context. This context contains functions for setting light and dark mode and boolean property, indicating which mode is currently in use.
The component calling
useThemeContext must be a child of the
Navbar title & logo
You can add a logo and title to the navbar via
themeConfig.navbar. Logo can be placed in static folder. Logo URL is set to base URL of your site by default. Although you can specify your own URL for the logo, if it is an external link, it will open in a new tab. In addition, you can override a value for the target attribute of logo link, it can come in handy if you are hosting docs website in a subdirectory of your main website, and in which case you probably do not need a link in the logo to the main website will open in a new tab.
To improve dark mode support, you can also set a different logo for this mode.
You can add links to the navbar via
React Router should automatically apply active link styling to links, but you can use
activeBasePath in edge cases. For cases in which a link should be active on several different paths (such as when you have multiple doc folders under the same sidebar), you can use
activeBaseRegex is a more flexible alternative to
activeBasePath and takes precedence over it -- Docusaurus parses it into a regular expression that is tested against the current URL.
Outbound (external) links automatically get
target="_blank" rel="noopener noreferrer" attributes.
Navbar items can also be dropdown items by specifying the
items, an inner array of navbar links.
Auto-hide sticky navbar
You can enable this cool UI feature that automatically hides the navbar when a user starts scrolling down the page, and show it again when the user scrolls up.
Docusaurus uses Prism React Renderer to highlight code blocks.
By default, we use Palenight as syntax highlighting theme. You can specify a custom theme from the list of available themes. If you want to use a different syntax highlighting theme when the site is in dark mode, you may also do so.
If you use the line highlighting Markdown syntax, you might need to specify a different highlight background color for the dark mode syntax highlighting theme. Refer to the docs for guidance.
You can set a default language for code blocks if no language is added after the opening triple backticks (i.e. ```). Note that a valid language name must be passed, e.g.: