FAQ / Editing Pages

The HTML pages of your site are dynamically generated from Markdown files on disk. Each file is a page, each page is a file.

You can edit a page via the Edit link in the drop-down drawer at the top of the page, or via the Files page.

Here is the contents of a basic Markdown page:

---
title: My Page
layout: one-column center
date 2026-01-22
---
# My Page

![Image Title](/images/doggy.jpg)

"Quibusdam nostrum ut facilis." Eligendi ab adipisci dolor beatae
amet. **Voluptatibus atque** magnam ullam iusto rerum. Fugiat non
officia laborum --- aut inventore dolores odio accusantium commodi
quia repellat aperiam --- esse maiores consequatur et porro doloremque
voluptates consequuntur.

The top section between the two --- lines is metadata about the page. The lower section, after the second ---, is the page content.

Metadata

Bliptown uses a limited subset of YAML for metadata. YAML is an easy-to-read language for data.

Each metadata entry takes the form of a key and a value, separated by a colon:

title: My Page

Here the title “My Page” will be combined with the site title (in _title.txt) to form the full web page title: “Site Title – My Page”.

layout: one-column center

Here the layout key has a value of two layout classes: one-column and center. See Using Layouts below. n.b. using the same key twice will not work.

date: 2026-01-22

Here is the date in ISO 8601 format. This is useful when using file inclusion and placeholders.

Markdown

Markdown is a lightweight markup language for rendering plain text into formatted HTML. If you’re unfamiliar with Markdown, here is a cheatsheet.

Bliptown enables several extensions to Markdown:

  • Permissive URL Autolinks
    Any full URL that includes the https:// is converted to a link.
  • Permissive Email Autolinks
    Any email address is converted to a mailto: link.
  • Wikilinks
    Any text in [[double square brackets]] is converted to a link (relative to the current URL).
  • Tables
    GitHub-style tables are converted to HTML tables.
  • Strikethrough
    Text between tilde marks, e.g. ~foo bar~, is crossed out.

Typography

Bliptown converts the following ASCII typography into “smart typography”:

  • "double quotes" → “double quotes”
  • 'single quotes' → ‘single quotes’
  • -- → – (en dash)
  • --- → — (em dash)

Using Layouts

The metadata key layout sets the page layout classes. Pages can combine multiple layout classes:

---
title: My Page
layout: gallery-horizontal one-column
---

Pages can also include other pages, allowing for flexible designs.

You can easily add new layouts or override the existing layouts in your Style page.

Templates

If you have a file named _template.md in the same directory or any parent directory, when creating a new Markdown file, the contents of that file will be inserted automatically.

← Previous | Source | Next →