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
| Style | Syntax | Result |
|---|---|---|
| Bold | **bold** | bold |
| Italic | *italic* | italic |
| Strikethrough | ~~strike~~ | |
| Code | `code` | code |
Links
[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
::