# Components

Source: https://docs.bearletter.com/blog/components

A component is a line of its own that starts with `::`, optionally with settings in braces:

```md
::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:

```md
---
title: Morning Pages
---
Notes on reading slowly and small websites.

::posts{limit="10"}
```

A footer on every post that invites replies:

```md
---
enabled: true
---
::reply
```
