Markdown Documentation Guide
A comprehensive guide to using Markdown in our documentation system
A comprehensive guide to using Markdown in our documentation system
Frontmatter is used at the top of Markdown files to define metadata. It's written in YAML format between triple-dashed lines:
---
title: Page Title
description: Page description that appears in meta tags
---
Available frontmatter fields:
title
: The page title (required)description
: Page description for SEO (recommended)Link to other pages within the documentation:
[Getting Started](/docs/documentation-editors/markdown-guide)
Link to external websites:a
[EternalCode Website](https://eternalcode.pl)
Create section headings using hash symbols:
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
**Bold text**
*Italic text*
~~Strikethrough~~
`Inline code`
Bold text
Italic text
Strikethrough
Inline code
- Item 1
- Item 2
- Nested item 2.1
- Nested item 2.2
- Item 3
1. First item
2. Second item
3. Third item
Create tables using pipes and dashes. Tables are automatically styled with enhanced formatting, including header styling, alternating row colors, hover effects, and responsive design:
| Header 1 | Header 2 | Header 3 |
| -------- | -------- | -------- |
| Cell 1 | Cell 2 | Cell 3 |
| Cell 4 | Cell 5 | Cell 6 |
Header 1 | Header 2 | Header 3 |
---|---|---|
Cell 1 | Cell 2 | Cell 3 |
Cell 4 | Cell 5 | Cell 6 |
The table styling includes:
You can align text in columns:
| Left-aligned | Center-aligned | Right-aligned |
| :----------- | :------------: | ------------: |
| Left | Center | Right |
| Text | Text | Text |
Left-aligned | Center-aligned | Right-aligned |
---|---|---|
Left | Center | Right |
Text | Text | Text |
You can use GitHub-style emoji shortcodes:
:smile: :heart: :rocket: :warning:
😄 ❤️ 🚀 ⚠️
Our documentation supports GitHub-style alerts using our custom Alert component:
<Alert type="info">
This is an information alert.
</Alert>
<Alert type="warning">
This is a warning alert.
</Alert>
<Alert type="danger">
This is a danger/error alert.
</Alert>
<Alert type="tip">
This is a tip/success alert.
</Alert>
<Alert type="question" title="Question">
Have you considered this approach?
</Alert>
<Alert type="important" title="Important">
This is a critical piece of information!
</Alert>
<Alert type="example" title="Example">
Here's how to implement this feature...
</Alert>
This is an information alert.
This is a warning alert.
This is a danger/error alert.
This is a tip/success alert.
Have you considered this approach?
This is a critical piece of information!
Here's how to implement this feature...
```javascript
function greet(name) {
return `Hello, ${name}!`;
}
## Code Tabs
Use the CodeTabs component to show code in multiple languages:
```markdown
<CodeTabs>
<CodeTab label="JavaScript">
```javascript
function hello() {
console.log("Hello JavaScript!");
}
```
</CodeTab>
<CodeTab label="TypeScript">
```typescript
function hello(): void {
console.log("Hello TypeScript!");
}
```
</CodeTab>
<CodeTab label="Python">
```python
def hello():
print("Hello Python!")
```
</CodeTab>
</CodeTabs>
function hello() {
console.log("Hello JavaScript!");
}
> This is a blockquote.
>
> It can span multiple lines.
This is a blockquote.
It can span multiple lines.
---

- [x] Completed task
- [ ] Incomplete task
- [ ] Another task