Components
Text
Documentation starts with a clear title and a useful paragraph. Use bold for actions, code for identifiers and links to a specific task.
A subsection
Keep headings in sentence case. Reading text is 17px. Labels and code stay at least 14px.
- Show the next action.
- Keep prerequisites visible.
- Explain how to check the result.
Keep the detail that changes what the reader needs to do.
Typography and Markdown examples
Code
export default {
presets: ["classic"],
themes: ["docusaurus-theme-quiet"],
};
Code blocks, commands and highlighted lines
Callouts
Restart the development server after changing the theme configuration.
Changing document slugs can break existing links. Add redirects when a URL must change.
All callout types and their source
Tabs
- npm
- pnpm
npm install docusaurus-theme-quiet
pnpm add docusaurus-theme-quiet
Tab syntax and keyboard behavior
Accordions
Can I keep my current content?
Yes. Quiet extends Classic. Keep your document files, IDs, routes and navigation. Review old CSS and component overrides when adopting a new theme.
Tables
| Setting | Light mode | Dark mode |
|---|---|---|
| Background | White | Near black |
| Text | Near black | Near white |
| Accent | Configurable | Configurable |
Cards
Steps
Install the package
Add Quiet to an existing Docusaurus site.
Enable the theme
Add the package to the
themesarray and restart your server.Check the result
Review a page in light mode, dark mode and on a phone.
Diagrams
The document moves from writing to review and publication.