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

"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 thehttps://is converted to a link. - Permissive Email Autolinks
Any email address is converted to amailto: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 →