HTML pages use the same reading layout as Markdown pages. Supply the content inside the page; the site adds the title, navigation, and footer.

Write a content fragment

Create an .html file in content/. You only need the elements that belong inside the article.

<h2>A section heading</h2>
<p>Your content, with <strong>emphasis</strong>.</p>
<ul>
  <li>A useful detail</li>
  <li>Another useful detail</li>
</ul>

Use the elements you need

Standard elements inherit the site's typography. You can combine paragraphs, lists, tables, blockquotes, images, and expandable details.

A little more detail

This disclosure works with native HTML. Open it to reveal supporting information while keeping the main article easy to scan.

Use HTML when the structure helps the reader. Markdown remains a simple choice for most pages.

Register your page

Add your file to content/pages.json with a unique slug, a title, and a short description. The navigation follows the order of that list.

{
  "slug": "reference",
  "title": "Reference",
  "label": "Resources",
  "description": "Useful information in one place.",
  "file": "reference.html"
}

Keep the shared layout

Leave out <html>, <head>, and <body> tags. The site provides those. Keep the page title in the manifest, and begin article sections with <h2>.

Prefer plain text? Return to the Markdown guide.