--- title: Editing Pages layout: one-column js-clipboard --- # [FAQ](/faq) / {{ title }} 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](https://yaml.org) 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](https://en.wikipedia.org/wiki/ISO_8601). This is useful when using [file inclusion](file_inclusion) and [placeholders](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](https://commonmark.org/help/). 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](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-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](/faq/layout_ref) classes. Pages can combine multiple layout classes: --- title: My Page layout: gallery-horizontal one-column --- Pages can also [include other pages](file_inclusion), allowing for flexible designs. You can easily add new layouts or override the existing layouts in your [Style page](style). ## 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](/faq/ai) | [Source](/_raw/faq/editing) | [Next →](/faq/style)