Basic Markdown Test

A compact tour of the Markdown elements a Hugo theme should render comfortably.

An H1 Inside the Article

This page is a deliberately ordinary Markdown document. It gives a theme a dependable baseline: a short sentence, a paragraph with enough texture to wrap across several lines, and a longer paragraph that lets us see whether the measure remains comfortable as the viewport changes. A good reading surface should make simple content feel unremarkable.

Here is a normal paragraph with bold text, italic text, bold italic text, struck-through text, and inline code. The code is not decoration: it should sit on the same baseline as the words around it without making the line jump or becoming impossible to select.

Here is a longer paragraph for line length and rhythm. A theme has to balance the width of the reading column with the size of its type, the amount of leading, and the quiet space between paragraphs. On a wide monitor, the column should not become a tennis court; on a narrow phone, words should not feel trapped between oversized margins. This paragraph intentionally contains a few precise terms—content width, readable measure, responsive padding, and semantic HTML—so the wrapping looks like real editorial copy rather than a collection of placeholder words.

Heading Level Two

The first section begins with a link to the posts index and an external link to Hugo. It also contains a long URL label: a documentation page with a deliberately verbose link label for checking wrapping at the edge of a narrow content column.

Heading Level Three

The text around a link should keep its color, underline, focus state, and hover state legible in both light and dark themes. The same is true for overflow-wrap: anywhere, which is useful when a browser has to decide what to do with an unbroken token.

Heading Level Four

This level is useful for checking indentation and the relationship between a nested heading and the paragraph that follows it.

Heading Level Five

Heading five is intentionally less prominent, but it still needs a sensible size, weight, and contrast.

Heading Level Six

Heading six is the smallest heading in this document. It should remain distinct from ordinary bold text.

Lists

An unordered list should have a clear marker and a comfortable gap between items:

  • A calm visual hierarchy
  • Predictable spacing between blocks
  • Enough contrast for quiet text
  • A focus ring that is visible without being loud

An ordered list should preserve the meaning of its sequence:

  1. Read the content model.
  2. Render the semantic elements.
  3. Resize the viewport.
  4. Check the result with a keyboard.

Nested lists should not collapse into an unreadable wall:

  • Primary item
    • Nested item with a little more detail
      • Deep item with inline code
    • Another nested item
  • A second primary item
    1. A mixed ordered child
    2. Another ordered child

Blockquotes

A quote with one paragraph should feel like a change in voice, not like a warning banner. Its border, tint, and spacing should support the words without competing with them.

A blockquote can contain more than one paragraph.

The second paragraph checks whether the theme keeps the internal rhythm of a quotation while still separating it from the surrounding prose.

A nested quote tests another layer of indentation and contrast.

A Horizontal Rule

The rule below separates two related thoughts without starting a new page.


After the rule, the document continues normally. Markdown is most useful when the content author can focus on the sentence and let the theme provide a consistent visual language. This final paragraph closes the baseline test with a sentence that is short enough to make the bottom spacing easy to inspect.