Structure and layout in MyST¶

The MyST forms of the specimens on Structure and layout, each rendered live by this page’s own Markdown parser.

Rubrics, centred lines and columns¶

Rubrics, centred lines and columns

```{rubric} An informal heading
```

```{centered} A centred *line*
```

````{hlist}
:columns: 3

- one
- two
- three
- four
- five
````

An informal heading

A centred line

three
four

five

Grouping blocks and classes¶

Grouping blocks and classes

```{container} ex-structure-box
A block with the class `ex-structure-box`.
```

````{compound}
Run the command

```shell
ubc build html docs
```

and open the page it writes.
````

```{rst-class} ex-structure-lead
```

A paragraph with the class `ex-structure-lead`.

A block with the class ex-structure-box.

Run the command

ubc build html docs

and open the page it writes.

A paragraph with the class ex-structure-lead.

Acknowledgements and authors¶

Acknowledgements and authors

````{acks}
- Ada
- Grace
````

```{sectionauthor} Ada <ada@example.com>
```

```{moduleauthor} Grace
```

```{codeauthor} Ada
```

The three author lines above print nothing.

Ada
Grace

The three author lines above print nothing.

Topics¶

A topic cannot sit inside a live specimen, so its source is shown first and the topic itself follows at the top level of this page.

```{topic} A topic
A self-contained aside, with a title of its own.
```

The source renders as:

Sidebars¶

```{sidebar} A sidebar
:subtitle: With a subtitle

Text that stands beside the page.
```

The source renders as:

A table of contents for the page¶

```{contents} On this page
:depth: 2
:backlinks: none
:class: this-will-duplicate-information-and-it-is-still-useful-here
```

The source renders as: