BearletterDocsllms.txtbearletter.comDashboard

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.

ComponentShowsSettings
::postsA list of articles, newest first.limit (1–1000), tag, folder (a folder under posts/)
::tagsEvery tag, linked to the archive filtered by it.none
::socialThe links from social.md, with icons.none
::blogrollThe blogs in blogroll.md, with a link to follow them all.none
::subscribeThe email sign-up form, while the blog's list is collecting subscribers (Pro).none
::replyA "Reply by email" link for the post it is in.none
::podcastThe 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