Skip to content

How to write a new documentation article

You can add a new article by creating a new file in the pages/ directory or any of its subdirectories. Please only use Markdown files and do not change anything on the existing CSS or TypeScript.

Frontmatter

Each article must contain frontmatter specifying metadata like the title, category, and other relevant properties. Without it, the article will not appear in the sidebar or navigation and hence be inaccessible. Below you can see an example.

yaml
---
title: "Your title here"
category: "Docs" # optional, falls back to folder name
date: "yyyy-mm-dd"
deprecated: false # optional
archived: false # optional
---

Markdown

Markdown is a lightweight markup language with plain-text-formatting syntax, created in 2004. You can find a useful cheatsheet here, and a useful online editor for it here.

Other programming/markup languages

We recommend only using Markdown, but other languages can be used or included in the Markdown file:

  • HTML
  • CSS (using the style html tag)
  • JavaScript (using the script html tag)
  • Vue components

This website was made using the VitePress framework. View the source here!