Contributing

Writing Markdown

Markdown syntax and MDC components available in this portal.

Standard Markdown

All standard Markdown syntax is supported: headings, bold, italic, links, lists, tables, blockquotes, and code blocks.

Headings

## Section Title
### Subsection Title

Each heading generates an anchor and appears in the table of contents.

Text Formatting

StyleSyntaxResult
Bold**bold**bold
Italic*italic*italic
Strikethrough~~strike~~strike
Code`code`code
[External link](https://example.com)
[Internal link](/docs/about)

Code Blocks

Use fenced code blocks with a language identifier:

```ts
const greeting = 'Hello, Ontopix'
```

You can add a filename label:

```ts [nuxt.config.ts]
export default defineNuxtConfig({
  // ...
})
```

MDC Components

This portal uses MDC (Markdown Components) syntax to embed Vue components in Markdown.

Callouts

This is an informational note.
::note
This is an informational note.
::
A helpful tip for the reader.
::tip
A helpful tip for the reader.
::
Something to be careful about.
::warning
Something to be careful about.
::

Cards

::card-group
  :::card
  ---
  icon: i-lucide-wrench
  title: Engineering
  to: /engineering
  ---
  Engineering handbook documentation.
  :::
::

Tabs

::tabs
  :::tab{label="npm"}
  npm install my-package
  :::

  :::tab{label="pnpm"}
  pnpm add my-package
  :::
::

Steps

::steps
1. First step description
2. Second step description
3. Third step description
::
See the Nuxt UI documentation for the full list of available prose components.