/help/blogs
Blog
Long-form writing with full markdown, file attachments, and citations to the source catalog.
Writing a post
- A title, a topic tag from the catalog, and a body. Extra tags are optional.
- The body takes full markdown — see the markdown cheatsheet.
- A code fence can carry a filename:
```ts [app/server.ts]. ASCII / UTF-8 art:```art(monospace, spaces kept).
Attachments and embeds
- Attach images (png/jpg/gif/webp), audio, video, PDF, torrent, or
.emlwhen you create or edit a post (5 GB each). - Images insert as inline markdown
. Other files use::audio,::video,::pdf,::torrent, or::emlwith a same-originsrc. - Torrent embeds scrape HTTP and UDP trackers when you open the panel (seeds / peers / snatched).
- Email (
.eml) embeds are a collapsed accordion (filename + icons). Expand to read; see the glossary below. - Uploads inherit the post’s visibility — an unpublished post’s files 404 for guests.
Citing sources
- Pick any number of people or organizations from the source catalog.
- They appear under the post, and the post appears on each source’s page.
- Selected sources float to the top of the picker; everything else is alphabetical.
Who can do what
- Create: signed-in members with the post role.
- Edit: the author, or post mods.
- Delete: post mods and hub only — authors do not delete their own posts.
Browsing
- The left rail has three tabs: By tag (facets filter the main list via
?topic=), All users (authors with their posts), and Mine (your posts and compose,?mine=1). Mine only shows when you can create posts. - Dice and clock clear facets and open a random spotlight or newest list — Blog prefs (header gear), or
?pick=random|latest. - Search titles from the rail (
?q=). Matching posts replace the random/latest landing, up to 200. - Thumbs up/down on the post and on comments. Signed-in only; click again to clear.
- Public posts: RSS at
/rss/blogs.xml, or/rss/tag/{tag}(same as/rss/blogs.xml?tag=). Members-only and unpublished never appear.
Who can see it
- Public — everyone, signed in or not.
- Members — anyone signed in on this origin. Guests get a login prompt.
- Unpublished — you and the kind’s mods. Guests get a plain 404, so nothing leaks.
- New items default to public. You can change it any time unless a mod locks it.
Icon glossary
- Expand / collapse — Email embeds start collapsed. Chevron (or Formatted / Raw) opens the panel.
- Download — Save the original `.eml` file from an email embed.
- Formatted — Readable view of the message — From / To / Date / Subject and the body text. Opens the accordion if closed.
- Raw — The unmodified `.eml` source (headers and MIME as stored). Opens the accordion if closed.