Writing Pages

Diplodocus uses GitHub-flavoured markdown via the Parsedown parser. If it renders on GitHub, it renders in Diplodocus.

This page is a live cheat sheet — everything you see rendered below corresponds to a markdown primitive you can use in your own pages.

Headings

# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

H1 is your page title (only one per page). H2 and H3 are what the right-hand table of contents shows.

Paragraphs and emphasis

This is a regular paragraph. You can use italic, bold, both, inline code, and strikethrough right inside text.

Hard line breaks need two trailing spaces at the end of a line. Otherwise consecutive lines collapse into one paragraph.

Lists

Unordered

  • Apples
  • Oranges
    • Blood oranges
    • Navel oranges
  • Bananas

Ordered

  1. Preheat the oven to 200°C
  2. Mix the dry ingredients
  3. Add the wet ingredients
  4. Bake for 30 minutes

Task lists

  • Write the installation page
  • Write the folder structure page
  • Record a demo video
  • Translate to Spanish

Images

![Alt text](attachments/03a-folder-tree.png)

See Attachments & Images for the full story.

Blockquotes

A quote makes a statement. A blockquote makes it official.

Multiple lines extend the blockquote.

Warning — the first bold word in a blockquote acts as a callout label.

Horizontal rules

Three or more dashes on their own line:

...produces a horizontal rule.

Inline code and code blocks

inline code uses single backticks. Fenced code blocks use triple backticks with an optional language hint:

```php
echo "Hello, Diplodocus";

See [Code Blocks & Highlighting](07-code-blocks-and-highlighting.md) for
the language list.

## Tables

```markdown
| Column A | Column B | Column C |
|:---------|:--------:|---------:|
| left     | centre   | right    |
| aligned  | aligned  | aligned  |

Renders as:

Column A Column B Column C
left centre right
aligned aligned aligned

HTML passthrough

Raw HTML works for the things markdown can't express. Use sparingly:

<details>
  <summary>Click to expand</summary>
  Hidden content.
</details>
Click to expand Hidden content.

Next