Blog format
Components
The lines that start with :: and what each one shows.
A component is a line of its own that starts with ::, optionally with settings in braces:
::posts{limit="10" tag="books"}
Components work in home.md, pages, posts, footer.md and the post parts. A known component with a wrong setting is refused; an unknown one is kept as written.
| Component | Shows | Settings |
|---|---|---|
::posts | A list of articles, newest first. | limit (1–1000), tag, folder (a folder under posts/) |
::tags | Every tag, linked to the archive filtered by it. | none |
::social | The links from social.md, with icons. | none |
::blogroll | The blogs in blogroll.md, with a link to follow them all. | none |
::subscribe | The email sign-up form, while the blog's list is collecting subscribers (Pro). | none |
::reply | A "Reply by email" link for the post it is in. | none |
::podcast | The latest podcast episodes (Pro). | limit (1–1000) |
Write settings in double quotes. A component with nothing to show (no posts, no tags) leaves no trace on the page.
Examples#
A home page that lists the ten latest posts:
---
title: Morning Pages
---
Notes on reading slowly and small websites.
::posts{limit="10"}
A footer on every post that invites replies:
---
enabled: true
---
::reply
Bearletter · bearletter.com · Every page is also Markdown: llms.txt