Extensions

Beyond standard Markdown, Dorcs includes several extensions that make your docs more interactive.

Tabs

Show alternative content — perfect for platform-specific instructions:

:::tabs
::tab macOS
brew install my-tool
::tab Linux
apt install my-tool
::tab Windows
winget install my-tool
:::

brew install my-tool

apt install my-tool

winget install my-tool

The first tab is active by default. Readers click to switch.

Badges

Label features, sections, or status with inline badges:

## New Feature NEW

This API is BETA and may change.

The old method is DEPRECATED.

Built-in types:

• NEW — new features
• BETA — beta / preview
• DEPRECATED — being phased out
• EXPERIMENTAL — early stage
• REQUIRED — mandatory items

Any custom text works too: v2.0, PRO, COMING SOON.

Accordions

Hide content that’s useful but not essential:

:::accordion Advanced configuration
Put detailed or optional content here.
Readers expand it only if they need it.
:::

Video embeds

Embed YouTube or Vimeo videos directly in your docs:

Supported formats:

• https://www.youtube.com/watch?v=ID
• https://youtu.be/ID
• https://www.youtube.com/embed/ID
• https://vimeo.com/ID

Videos render as responsive 16:9 iframes.

Mermaid diagrams

Create diagrams from text using Mermaid:

```mermaid
graph TD
  A[Write Markdown] --> B[Run Dorcs]
  B --> C[Beautiful site]
```

graph TD
  A[Write Markdown] --> B[Run Dorcs]
  B --> C[Beautiful site]

Mermaid supports flowcharts, sequence diagrams, Gantt charts, and more.

Math with KaTeX

Write math formulas with LaTeX syntax.

Inline: $E = mc^2$ renders as $E = mc^2$

Block:

$$
\int_0^1 x^2 \, dx = \frac{1}{3}
$$

$$\int_0^1 x^2 \, dx = \frac{1}{3}$$

Syntax highlighting

Code blocks are highlighted automatically based on the language. The color scheme matches your theme — no setup needed.

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

function greet(name) {
  return `Hello, ${name}!`;
}

Dorcs supports all major languages — just specify the name after the triple backticks.