Markdown block elements
Samples of Hugo’s extended CommonMark syntax to give a quick impression of the default layout.
Headings introduce and order content segments on a page. Heading levels need to descend without interruption. We can modify headings only visually when we want to skip some levels.
Paragraphs are the essential building blocks of text. A comfortable line length and surrounding whitespace contribute to their legibility.
To quote someone means to recognize her or his thoughts as part of our own. We may agree or disagree, but we should refer to them correctly.
A simple list is unordered and groups a set of related items. Any item may contain a sub-list.
Ordered lists group related items and mark them with ascending counters. They provide a very clear structure for a relatively short number of items.
The main text column offers space for 80 characters of code in one line. When we need more to fit in one line, we can let it expand into the marginal column(s).
Sometimes the separation of page segments by space is not clear enough. Then we can add this layout element as an explicit visual separation.
Definition lists consist of terms as list markers, which are associated with details in the list entries.
Footnotes are best suited for (formal) information, which is not essential for the meaning of the text.
Markdown tables need some care, because their layout breaks, when the content of one row exceeds the available width.
A task list on a web page should be an interactive element which directly changes the corresponding Markdown. A theme can’t establish such a connection on its own.
We can preprocess images (rotate, change ratio, and zoom) and have several options for placing them in and around the text. We can add a caption. All this is achieved by additional parameters associated with the image source.
The theme relies on the powerful integrated Hugo methods.
On large screens, code blocks expand into the margins as long as possible and may include up to 160 characters in one line.