Writing Content with Markdown

One of the nice things about Zola is that you can write your content in plain Markdown. No HTML templates to edit just to publish an article.

Create a .md file in your content/ directory and start writing.

A basic page

Every page can start with a TOML front matter block:

+++
title = "My First Article"
description = "A short description of this page."
+++

Write your Markdown below the closing +++.

The basics

Headings

Use # for headings. Add more # characters for lower levels:

## A section

### A subsection

Emphasis

**Bold text**

*Italic text*

Lists

Unordered lists use hyphens:

- First item
- Second item
- Third item

Ordered lists use numbers:

1. First step
2. Second step
3. Third step

Links and images

[Zola](https://www.getzola.org/)

![A descriptive image caption](/images/example.jpg)

Place the image at static/images/example.jpg so Zola can serve it from /images/example.jpg.

Code

Inline code uses backticks:

Run `zola build` to generate your site.

For a code block, use triple backticks and specify the language:

```rust
fn main() {
    println!("Hello, Zolbare!");
}
```

Zola supports syntax highlighting for code blocks when configured. Check the Zola documentation if you want to customize its highlighting settings.

Quotes

Use > to create a blockquote:

> Keep it simple. Write good content.

Tags and series

You can organize pages with taxonomies in the front matter, provided they’re configured in zola.toml.

For example:

[ taxonomies ]
tags = ["markdown", "zola"]
series = ["Getting Started with Zolbare"]

Tags help readers find related content. A series groups articles that belong together.

Keep it readable

A few simple habits go a long way:

• Use headings to break up long articles.
• Write descriptive link text.
• Add alternative text to meaningful images.
• Keep paragraphs short enough to scan comfortably.
• Use code blocks for commands and source code.

That’s all you need to get started. Write in Markdown, let Zola build the site, and let Zolbare take care of the presentation.