Skip to main content

Markdown reference

Test bench. Every element, one page. Move a token, read this.

Contents

This page holds no argument. It sets every element the site renders, so a change in the stylesheet shows its cost here first. The type specimen does the same for the font.

Headings

The page title is the only large size. A second-level heading speaks in small caps at the text size. Space carries the rest.

A third-level heading

Ink, at the text size, with large space above and half a space below. It groups paragraphs inside a part.

A fourth-level heading

Small and mute. The site rarely needs to go this deep before it reorganizes the page.

Paragraphs

A paragraph holds the reading measure and breathes by one space below. The line height is set for sustained reading, so short paragraphs can feel loose. That looseness is intended.

A second paragraph follows. The space between this one and the one above equals the text size, the one unit every space on the site counts in.

A third paragraph closes the run. One measure holds every prose element. Code and tables may break it on purpose.

Inline elements

A sentence carries emphasis, strong emphasis, a link inside the site, a link that leaves it, and inline code such as --color-ink. It cites a title, Designs for the Pluriverse, and ends with an endnote.[1]

The next sentences need HTML, the one place this site writes HTML in prose: a marked phrase, an abbreviation such as OFL, a key Esc, a formula H2O, an exponent x2, a date , and a default word its repair.

Bangla

বাংলায় অনুচ্ছেদ পরীক্ষা করার জন্য এই অংশ। বরেন্দ্র টাইপফেস ধরে রাখার চেষ্টা, যেখানে আছে যুক্তবর্ণ, সঠিক কার-চিহ্ন, এবং সাধারণ পঠনের ছন্দ। লাইন উচ্চতা একটু বেশি, সংখ্যাও বাংলা — ১, ২, ৩, ৪, ৫, ৬, ৭, ৮, ৯, ১০।

দ্বিতীয় অনুচ্ছেদ একই পরিমাপের ভেতর থেকে কথা বলে। ইংরেজির পাশে বসলে আকার সামান্য কমে — যেন একই কণ্ঠস্বর, ভিন্ন ভাষায়।

An English line with a Bangla word, ঘুম, keeps the English line height.

Lists

Unordered, with nesting

Ordered, with nesting

  1. Open a question.
  2. Sit with it:
    1. Name what changed.
    2. Name what stayed.
  3. Close the loop, or leave it open.

Definition list

Measure
The reading width every prose element answers to.
Edge
The paper margin, fluid with the screen.
Tint
Ink at eight percent, behind inline code and a table row under the hand.

Quotation

A page tells a reader, before any argument, whether it will punish them. Line length, size, contrast and the rhythm between paragraphs are the first layer of hospitality.

Section break

A paragraph above the break.


A paragraph below the break.

Code

Inline: font-size-adjust: 0.48. A block:

:root {
    --color-ink:    #221111;
    --color-mute:   #554433;
    --color-accent: #A03000;
    --text-normal:  clamp(1.25rem, 1.05rem + 0.75vw, 1.375rem);
    --width-text:   calc(var(--space) * 29);
}

Table

TokenValueUse
--space-small0.5inside a block
--space1between blocks
--space-large2before a heading
--space-huge3before a part

Figure

A default route runs straight from encounter to decision through recognition, precedence and persistence. A dotted route below reaches the same decision with more work. encounterdecision recognitionprecedencepersistence another route, more work
Figure 1. A figure is line art in SVG, drawn in the ink of the page.

Lists the site builds

Index rows and cards come from templates, never from Markdown. See them on Log and Lab. A form lives on a tool page, such as the passivity index.

  1. An endnote. On this site notes are endnotes: they wait at the end, and the number links both ways.