BearletterDocsllms.txtbearletter.comDashboard

Blog format

Properties

The key: value block at the top of a file, and every property each file accepts.

A file may start with a block of properties between two lines of ---, one key: value per line:

---
title: Reading slowly
published_date: 2026-10-02 09:30
tags: books, habits
---
One page a day is still a book a year.

Keys are lower case. A file that does not start with --- has no properties. An unknown key, or a value in the wrong form, is refused with its line number.

Articles (posts/) and pages (pages/)#

PropertyValue
titleRequired. Up to 300 characters.
published_date2026-10-02 or 2026-10-02 09:30, in the blog's time zone. A future date schedules it.
tagsComma-separated, at most 20, each up to 60 characters.
publishfalse keeps it offline.
aliasOld addresses, comma-separated paths such as /old-name, at most 10.
canonical_urlWhere the original lives, if it was first published elsewhere.
meta_descriptionThe summary for search and sharing. Without it, the first paragraph is used.
meta_imageThe image for sharing. Without it, a card is generated.
langA language code such as en or zh-CN, when it differs from the blog's.
class_nameExtra class names for the page's <body>, for styling one article.
make_discoverablefalse keeps it off the front page.

Articles also take:

PropertyValue
post_header, post_footer, post_asidefalse hides that part on this article.
pinnedtrue pins it on the blog's fediverse profile.

true and false are written exactly so.

home.md#

PropertyValue
titleRequired. The blog's name, up to 200 characters.
seo_titleA different title for search results.
meta_descriptionThe blog's summary for search, sharing and feeds.
meta_imageThe image for sharing.
faviconThe icon's address.

Site parts#

FileProperties
footer.mdenabled, powered_by (false hides the Bearletter credit; Pro)
post-header.md, post-footer.md, post-aside.mdenabled

nav.md, social.md, blogroll.md, directories.md, redirects.md and styles.css have no properties.

Markdown#

Bodies are CommonMark with GitHub tables, strikethrough and footnotes. HTML is allowed and cleaned; on Free, <style> elements and style attributes are removed, on Pro they are kept.

Bearletter · bearletter.com · Every page is also Markdown: llms.txt