Steps

The steps shortcode wraps a Markdown ordered list and applies a visual treatment: numbered circles connected by a vertical rail. Use it for installation guides, tutorials and any sequential process where order matters.

Usage

Write a standard Markdown ordered list inside the shortcode:

{{< steps >}}
1. Install Hugo (v0.141 or later).
2. Clone your documentation repository.
3. Run `hugo server` to start the local preview.
{{< /steps >}}

Rich content per step

Each list item renders as full Markdown, so steps can contain paragraphs, code blocks, callouts and other shortcodes:

{{< steps >}}
1. **Create the config file.**

   Copy the starter config to your project root:

   ```toml
   baseURL = "https://docs.example.com/"
   theme   = "bora"
   ```

2. **Add your content.**

   Place Markdown files under `content/docs/`.

3. **Deploy.**

   Push to your hosting provider. Bora generates a fully static site.
{{< /steps >}}

Parameters

This shortcode takes no parameters. It styles the first ordered list inside its body.

Notes

• The shortcode targets the outermost <ol> inside the block. Nested lists are unaffected.
• Unordered lists (- or *) do not receive the step treatment.