Chronicles formatting guide
Copy sections from this file into the write desk to see how each option renders. Blank lines start new paragraphs.
Headings
Use # at the start of a line for a section heading (renders as a green headline).
This is a section heading
You can type # through ###### in the editor; all render as the same heading style on the article page.
Bold and italic
This sentence is bold. Wrap text in double asterisks: like this
This sentence is italic. Wrap text in single asterisks: like this
You can combine them in one line: bold phrase and italic phrase in the same paragraph.
Links
Links use markdown bracket syntax. Only http:// and https:// URLs work.
Unsafe links are left as plain text: [not a link](javascript:alert(1))
Inline code
Use backticks for short code or literal text: npm run dev
Paragraphs
Leave a blank line between blocks to start a new paragraph.
This is paragraph one. It can run across several sentences in the editor and still become one block on the page.
This is paragraph two. The blank line above is what splits them.
Bullet lists
Start each line with - or * and a space.
- First item
- Second item with bold inside
- Third item with a link
Block quotes
Start each line with > and a space.
This is a quoted line. Use it for pull quotes, citations, or emphasis.
Highlighted snippet
Wrap content in ::: fences for a highlighted callout box. You can use one line or multiple lines.
Single-line snippet: the important line readers should not miss.
Multi-line snippet
You can put bold, italic, and lists inside a snippet fence.
- Point one
- Point two
Inline close also works on one line: ::: One-line fenced snippet :::
Checklists
Three checkbox states are supported. Use the checklist button in the toolbar or type these markers by hand.
- Empty — not done yet
- ✅Checked — done
- ❌Crossed — rejected or no longer applies
Section divider
Three hyphens on their own line draw a horizontal rule.
Tables
Pipe tables need a header row, a separator row, and at least one body row. Alignment follows the colons in the separator row.
| Left | Center | Right |
|---|---|---|
| A | B | C |
| Bold cell | Italic cell | Link |
Mixing blocks
Real articles usually combine several block types.
Why this matters
Project: Public petition site for student voices.
Education is not a commodity. Accountability is not optional.
Deadline: ship the first public draft before the next news cycle.
- Draft the headline
- ✅Write the opening paragraph
- ❌Drop the old accountability-engine pages
| Role | Owner |
|---|---|
| Copy | Guest writer |
| Review | Editor |
Quick reference
| You type | You get |
|---|---|
# Heading | Section heading |
text | Bold |
text | Italic |
` code ` | Inline code |
label | Link |
- item | Bullet list |
> quote | Block quote |
::: … ::: | Highlighted snippet |
- [ ] / - [-] / - [x] | Checklist items |
--- | Horizontal divider |
| `\ | col \ |
Not supported (yet)
These common markdown features are not rendered in Chronicles articles:
- Images (
) - Numbered lists (
1. item) - Nested lists
- H1 vs H2 vs H3 styling differences (all
#levels look the same) - Strikethrough, underline, or highlight syntax
Stick to the blocks above for predictable results on the feed and article pages.
Comments
No comments yet.
Leave a comment