Markdown

Prismoire uses Markdown for formatting posts and replies. Markdown lets you add structure such as headings, lists, links, or emphasis by typing plain characters that get turned into formatted text when your post is rendered.

Each example below shows what you type on the left and what appears on the right.

Bold and italic

You type
**bold text** and *italic text*
What appears

bold text and italic text

You can also use __bold__ and _italic_ if you prefer underscores.

Strikethrough

You type
~~no longer accurate~~
What appears

no longer accurate

Links

You type
[the project page](https://example.com)
What appears

Images

You can include an image you've uploaded to a thread by referencing its filename with an exclamation mark and brackets. The text inside the brackets is the image's alt text — a short description for screen readers or anyone whose browser can't display the image.

You type
![Prismoire icon](icon-192.png)
What appears
Prismoire icon

Add a caption in quotes after the filename. The caption appears centered below the image. Captions are visible — alt text is for accessibility — so it's fine for them to say different things.

You type
![Prismoire icon](icon-192.png "Our mark, rendered at 192px.")
What appears
Prismoire icon
Our mark, rendered at 192px.

Images come from files you've attached to the thread — only the original poster can attach files, and only thread bodies (not replies) can carry images. When you upload an image, it's added to the body automatically.

External image URLs (![alt](https://example.com/x.png)) are intentionally rendered as plain links, not embedded.

Mentions and rooms

Type a username with an @ prefix to link to that user's profile. Type a room with a /r/ prefix to link to the room.

You type
hello @alice, see /r/general for context
What appears

hello @alice, see /r/general for context

Headings

Start a line with one or more # characters followed by a space. More # means a smaller heading.

You type
# Top-level heading
## Sub-heading
### Smaller heading
What appears

Top-level heading

Sub-heading

Smaller heading

Headings work only in thread bodies; not replies.

Lists

Unordered lists use - or * at the start of each line. Ordered lists use 1., 2., and so on.

You type
- apples
- oranges
- bananas

1. wake up
2. drink coffee
3. start thinking
What appears
  • apples
  • oranges
  • bananas
  1. wake up
  2. drink coffee
  3. start thinking

Blockquotes

Start a line with > to quote.

You type
> Reading is a means of thinking with another person's mind.
What appears

Reading is a means of thinking with another person’s mind.

Inline code

Wrap text with single backticks to mark it as code.

You type
Use `map` and `filter` together.
What appears

Use map and filter together.

Code blocks

Fence a block of code with three backticks on their own lines. Whitespace and indentation inside the block are preserved exactly.

You type
```
function greet(name) {
  return "hello, " + name;
}
```
What appears
function greet(name) {
  return "hello, " + name;
}

Tables

You type
| Fruit  | Color  |
| ------ | ------ |
| apple  | red    |
| banana | yellow |
What appears
Fruit Color
apple red
banana yellow

Horizontal rule

Three or more dashes on their own line draw a divider.

You type
---
What appears

Line breaks and paragraphs

A single newline starts a new line. A blank line starts a new paragraph. You usually don't have to think about this — type the way you'd type an email.

Smart punctuation

A few characters get tidied up automatically as you write:

You type
"Hi," she said. "Pages 1--5 cover the basics --- skim them..."
What appears

“Hi,” she said. “Pages 1–5 cover the basics — skim them…”

  • -- becomes an en dash (–)
  • --- becomes an em dash (—)
  • ... becomes an ellipsis (…)
  • Straight quotes become curly quotes

What's not supported

A few common Markdown features are intentionally left out so posts stay tidy:

  • External images. Image syntax pointing at another site (e.g. ![alt](https://example.com/x.png)) is rendered as a plain link rather than an embedded image. To inline an image, upload it as an attachment first — see the Images section above.
  • Raw HTML. HTML tags inside your post are stripped out.
  • Task list checkboxes. [ ] and [x] markers in list items are removed.

Where each feature works

Thread bodies support every feature on this page. Replies omit headings, horizontal rules, and images so nested conversations stay compact. Bios on your profile are deliberately minimal — only paragraphs, bold, italic, strikethrough, inline code, and links.