Skip to content
Arabesque for Zola

Markdown, in the system's look

Every element Markdown writes, as the theme shows it: headings, lists, quotes, code, tables, images and footnotes.

3 min read

Running text is set in the reading face, at the reading measure, with an em between blocks. This page has one of everything, so you can see how yours will look. Hover over a heading for its own link.

Text🔗

A paragraph with strong words, emphasis, both at once, inline code, a link to the guide, a word struck out and a footnote.1 Smart punctuation turns “double” and ‘single’ quotes, – and — dashes, and three dots… into their proper forms.

A line can break without a new paragraph:
put a backslash at its end,
or two spaces.

A quotation has a rule at its start, and is muted. It’s for what someone else wrote.

It can run to more than one paragraph.


Inline HTML🔗

Markdown passes HTML through, for the few things it has no syntax for. Press Ctrl + K to search; highlight a phrase that matters; write H2O and E = mc2; and spell out an RTL layout on hover.

Lists🔗

  • An unordered list
  • With a second item
    • And one nested inside it
      • And one inside that
  • And a last one
  1. An ordered list
  2. Counts its items
    • With a bulleted list inside an item
    • That keeps its own markers
  3. In the page’s digits

A list after a paragraph can start at any number:

  1. This one starts at five
  2. And counts on from there
  • A task that’s done
  • A task that isn’t
  1. An item can hold more than one paragraph.

    Indent the next one to line up with the item’s text, and it stays inside.

    zola serve
  2. Code, too, as above.

Images🔗

An image on its own line fills the measure, and keeps its corners as the system’s.

A post on the theme, with “On this page” beside it.

Code🔗

// The theme's script, in brief.
import { initToc } from "../js/toc.js";
const strings = JSON.parse(document.getElementById("zt-strings").textContent);
initToc();
fn main() {
    let greeting = "مرحبا";
    println!("{greeting}, world");
}

Tables🔗

Columns of figures are aligned as figures, and a column can be set to the start, the centre or the end with colons in the rule under the head.

BreakpointWidthColumns
Small40rem1
Medium52rem2
Large64rem3

A wide table scrolls on its own, never the page. (The figures are made up.)

MonthPostsWordsMinutesImagesCodeTablesNotesQuotesListsLinksTagsLanguages
January1820402010132English
February21,460723101254English
March21,910915120263Both
April32,7301346231386Both

Headings🔗

A heading’s address comes from its words, or from an id you give it: this one is #headings-in-a-post.

A third-level heading🔗

A fourth-level heading🔗

Headings below the page’s title start at the second level; “On this page” lists the second-level ones.

1

Footnotes gather at the foot of the page, after a hairline.

Back to top