$ npm install
$ npm run start
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
The documentation is automatically deployed when changes are pushed to the master branch. GitHub Actions will:
- Build the documentation
- Deploy the updated content to GitHub Pages
- Make it available at the public URL
No manual deployment steps are required - just push your changes to master.
⚠ Build will fail if broken links / anchors are detected
- Create a new markdown file (
.md
or.mdx
) in the appropriate directory underdocs/
. - For images:
- Create an
/img/document-name
directory in the same folder as your document - Place related images in this directory
- Reference images using relative paths:

- Create an
Markdown documents can use the following Markdown front matter metadata fields, enclosed by a line --- on either side.
Example :
---
id: doc-markdown
title: Docs Markdown Features
hide_title: false
hide_table_of_contents: false
sidebar_label: Markdown
sidebar_position: 3
pagination_label: Markdown features
custom_edit_url: https://github.com/facebook/docusaurus/edit/main/docs/api-doc-markdown.md
description: How do I find you when I cannot solve this problem
keywords:
- docs
- docusaurus
tags: [docusaurus]
image: https://i.imgur.com/mErPwqL.png
slug: /myDoc
last_update:
date: 1/1/2000
author: custom author name
---
You can add a title
to the code block by adding a title key after the language (leave a space between them).
console.log('What a great log');
The following syntax will allow a link to [text](/url#my-explicit-id)
instead of the default [text](/url#hello-world)
### Hello World {#my-explicit-id}
```
### Admonitions
In addition to the basic Markdown syntax, we have a special admonitions syntax by wrapping text with a set of 3 colons, followed by a label denoting its type.
See [Admonitions how-to](https://docusaurus.io/docs/markdown-features/admonitions)
### See more
https://docusaurus.io/docs/category/guides