Skip to main content
Longping WU
All posts

A Markdown cheat sheet for writing posts

Bold, lists, links, images, quotes, code — everything you need to write a post, on one page.

Posts are written in Markdown: symbols instead of formatting buttons. There are only a handful worth knowing.

Keep this as a reference, or delete it.

Headings

## Second-level heading
### Third-level heading

Don’t use a single # in the body — the page title at the top is already the first-level heading.

Emphasis

**bold**, *italic*, ~~strikethrough~~

bold, italic, strikethrough

Lists

- First item
- Second item
  - Indent two spaces for a sub-item

1. Numbered list
2. Second item
  • First item
  • Second item
    • Indent two spaces for a sub-item
[the text you see](https://example.com)

![description of the image](../../../assets/your-image.jpg)

Put images in src/assets/ first, then reference them as above. The text in square brackets matters: it is what readers who can’t see the image get, and what search engines read.

Quotes

> Quoted text goes after the angle bracket.

Quoted text goes after the angle bracket.

Code

Inline code goes between single backticks: like this.

A block of code goes between three backticks, with the language name on the first line:

def hello(name):
    print(f"Hello, {name}")

Rules and tables

---

| Column A | Column B |
| --- | --- |
| cell | cell |
Column A Column B
cell cell

Two things that trip people up

Blank lines matter. Leave an empty line between paragraphs, or they get squashed into one.

Dates have a fixed format. pubDate must look like 2026-11-20. Anything else throws an error.