Skip to content

Markdown in 5 minutes

Headers

# H1 Header
## H2 Header
### H3 Header
#### H4 Header
##### H5 Header
###### H6 Header

Text formatting

**bold text**
*italic text*
***bold and italic***
~~strikethrough~~
`inline code`


Links
[Link text](https://example.com)
[Link with title](https://example.com "Hover title")

Alternate link format: [Link text][link1] - Link #1
[link1]: https://example.com/ "Hover title"

Images
![Alt text](image.jpg)
![Image with title](image.jpg "Image title")
Alternate link format example: Link text - Link #1

markdown
* [`zensical new`  ][new]   - Create a new project
* [`zensical serve`][serve] - Start local web server
* [`zensical build`][build] - Build your site

[new  ]: https://zensical.org/docs/usage/new/
[serve]: https://zensical.org/docs/usage/preview/
[build]: https://zensical.org/docs/usage/build/
result

Lists

Unordered:

- Item 1
- Item 2
  - Nested item

Ordered:

1. First item
2. Second item
3. Third item

To create an unordered list nested inside an ordered list using Zensical, use standard Markdown nesting syntax with four spaces of indentation. Ref: Lists

Here is the exact syntax: 

1. First main item
2. Second main item
    - First nested bullet point
    - Second nested bullet point
3. Third main item

Blockquotes

> This is a blockquote
> Multiple lines
>> Nested quote

Code blocks

```javascript
function hello() {
  console.log("Hello, world!");
}
```

To display a fenced code block containing triple backticks (```), as in the javascript code block shown above, wrap the entire block in four backticks (````), which won’t show:

  ````
  ```javascript
  function hello() {
    console.log("Hello, world!");
  }
  ```
  ````

Tables

| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Row 1    | Data     | Data     |
| Row 2    | Data     | Data     |

Horizontal rule

---
or
***
or
___

Task lists

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

Escaping characters

Use backslash to escape: \* \_ \# \`

HTML entities for spaces

To escape space characters in Markdown—especially for maintaining specific spacing, indentation, or keeping words on the same line—you can use HTML entities.

Desired Space Type Markdown / HTML Code Best Used For
Non-breaking space   Preventing a line break between two words or adding a single forced space.
Two spaces (En space)   Adding a medium-sized visual gap.
Four spaces (Em space)   Paragraph indentations or aligning text horizontally.

Line breaks

Multiple stacked lines of text appear contiguous in a single paragraph.

End a line with two or more spaces  
to create a line break.

Use a blank line to start a new paragraph.