There are two kinds of posts:

Status

The default, add some words into the textarea and press the publish button. Any markdown is valid.

Any tags are automatically linked to tag archives.

Select some text and paste a link over it to turn the selection into a markdown link, e.g. selecting Lamb and pasting https://example.com produces [Lamb](https://example.com).

Add images by dragging files onto the editor, or by pasting an image straight from the clipboard (for example a screenshot). Either way the image is uploaded and a markdown image link is inserted at the cursor. JPEG and PNG uploads are automatically converted to WebP to keep files small; GIF, WebP, and AVIF are stored as-is.

Permalinks for statuses are in the form of /status/<integer>.

This is a status post #hello

Page

This is a status plus YAML-parsed front-matter, this is metadata and will not be rendered.

---
title: About me
---

Hi I'm John Sheeple and the example author of this site.

Slugs for pages are derived from the title on creation unless you explicitly provide slug: in the front-matter. The slug for the example above is about-me and the permalink is /about-me.

Editing the slug: line (or the title, when no explicit slug is set) reslugs the post, and Lamb automatically stores a 301 redirect from the old slug — good URLs don’t change, so bookmarks and inbound links keep working. See Redirections.

Slugs are unique. If a slug is already taken by another post (or matches a built-in route like /search), Lamb appends the post’s id to keep the URL distinct, and writes the final slug back into the post’s front-matter so you can see — and edit — the slug the post is actually served under.

You can also set a created: date in the front-matter. A future date schedules the post — see Scheduling.

iOS note: iOS “Smart Punctuation” rewrites a typed --- into em/en dashes (for example —-). Lamb recognises a mangled opening and closing fence and restores it to --- automatically, so front-matter still works from an iPhone or iPad. If you’d rather type plain dashes everywhere, turn the feature off under Settings → General → Keyboard → Smart Punctuation.

System types

The following sections of the site are special:

• /tags/<name> are tags linked in content
• /search/<keywords> search the content for keywords
• /login and /logout to login and out.
• /feed for the Atom newsfeed.

Related

• Media: Add images by drag-and-drop or paste; JPEG/PNG are converted to WebP.
• Drafts: Add draft: true to front-matter to save a post as a draft.
• Scheduling: Add a future created: date to publish a post later.
• Menu Items: Page posts with slugs can be pinned as menu items.
• Reply posts: Add in-reply-to: to front-matter to mark a post as a reply to another URL.
• Syntax Highlighting: Fenced code blocks with a language hint are highlighted server-side.