Markdown Basics

eziwiki supports full GitHub Flavored Markdown (GFM). This guide covers all the syntax you need.

Headings

markdown
# Heading 1

## Heading 2

### Heading 3

#### Heading 4

##### Heading 5

###### Heading 6

Text Formatting

markdown
**Bold text**
_Italic text_
**_Bold and italic_**
~~Strikethrough~~
`Inline code`

Bold text Italic text Bold and italic Strikethrough Inline code

Lists

Unordered Lists

markdown
- Item 1
- Item 2
  - Nested item 2.1
  - Nested item 2.2
- Item 3
  • Item 1
  • Item 2
    • Nested item 2.1
    • Nested item 2.2
  • Item 3

Ordered Lists

markdown
1. First item
2. Second item
3. Third item
   1. Nested item 3.1
   2. Nested item 3.2
  1. First item
  2. Second item
  3. Third item
    1. Nested item 3.1
    2. Nested item 3.2

Task Lists

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

Links

markdown
[Link text](https://example.com)
[Link with title](https://example.com 'Title text')
[Internal link](/getting-started/quick-start)

Link text Link with title Internal link

Images

markdown
![Alt text](/images/screenshot.png)
![Alt text with title](/images/screenshot.png 'Image title')

Code Blocks

Inline Code

markdown
Use `const` instead of `var` in JavaScript.

Use const instead of var in JavaScript.

Code Blocks with Syntax Highlighting

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

See Code Blocks for more details.

Blockquotes

markdown
> This is a blockquote.
> It can span multiple lines.
>
> > Nested blockquote

This is a blockquote. It can span multiple lines.

Nested blockquote

Tables

markdown
| Header 1 | Header 2 | Header 3 |
| -------- | -------- | -------- |
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |
Header 1Header 2Header 3
Cell 1Cell 2Cell 3
Cell 4Cell 5Cell 6

Alignment

markdown
| Left | Center | Right |
| :--- | :----: | ----: |
| L1   |   C1   |    R1 |
| L2   |   C2   |    R2 |
LeftCenterRight
L1C1R1
L2C2R2

Horizontal Rules

markdown
---

---

---

HTML in Markdown

You can use HTML tags in Markdown:

markdown
<div style="color: red;">
  This text is red.
</div>

<details>
  <summary>Click to expand</summary>
  Hidden content here.
</details>
Click to expand Hidden content here.

Escaping Characters

Use backslash to escape special characters:

markdown
\*Not italic\*
\[Not a link\]
\`Not code\`

*Not italic* [Not a link] `Not code`

Line Breaks

Two spaces at the end of a line create a line break:

markdown
First line  
Second line

Or use a blank line for a paragraph break:

markdown
First paragraph

Second paragraph

Footnotes

markdown
Here's a sentence with a footnote[^1].

[^1]: This is the footnote content.

Emoji

Use emoji shortcodes:

markdown
:smile: :heart: :rocket: :tada:

Or use Unicode emoji directly:

markdown
šŸ˜Š ā¤ļø šŸš€ šŸŽ‰

šŸ˜Š ā¤ļø šŸš€ šŸŽ‰

Best Practices

Use Descriptive Link Text

markdown
āœ… Good: [Read the installation guide](/getting-started/installation)
āŒ Bad: [Click here](/getting-started/installation)

Keep Lines Short

Break long lines for better readability:

markdown
āœ… Good:
This is a long paragraph that has been broken into
multiple lines for better readability in the source.

āŒ Bad:
This is a long paragraph that goes on and on without any line breaks making it hard to read in the source file.

Use Consistent Formatting

markdown
āœ… Good:

- Item 1
- Item 2
- Item 3

āŒ Bad:

- Item 1

* Item 2

- Item 3

Add Alt Text to Images

markdown
āœ… Good: ![Dashboard screenshot showing user analytics](/images/dashboard.png)
āŒ Bad: ![](/images/dashboard.png)

Next Steps