Markdown and embeds for an EdgePress article

Markdown Syntax Guide

This guide shows the Markdown features supported by EdgePress posts. The source stays readable, and the renderer sanitizes the resulting HTML before it reaches a page.

Headings and paragraphs

Start a heading with one or more hash marks. A blank line starts a new paragraph.

Heading level three

Heading level four

Heading level five

Heading level six

Setext heading level two

A backslash at the end of a line creates a hard line break.
This line stays in the same paragraph.

Thematic breaks

Three common rules create a horizontal divider:

---

---

---

Emphasis and code

Use emphasis, strong emphasis, and strikethrough. Inline code looks like npm run build.

const greeting = "Hello, Markdown.";

Tilde fences also mark code blocks:

This block uses a tilde fence.

Four leading spaces create an indented block:

const indented = "four spaces";

Use ` to include a literal backtick in a code span.

Write \* in a code span to show an escaped asterisk. Character references such as < and & display punctuation as text.

Links and images

An inline link points to the projects page. A reference link points to the about page.

GFM turns a bare address into a link: https://www.markdownguide.org/ . Angle-bracket, www, and email forms work too: https://commonmark.org www.example.com team@example.com.

Diagram showing a Markdown document becoming a static page

An image-shaped link to an MP4 file becomes a video player:

![A field recording](https://media.example.org/field-recording.mp4 "Wind test")

Lists and quotations

• Keep formatting inside list items.

  1. Nest an ordered list under an unordered item.
  2. Add another nested item.

• ✓ Completed tasks receive an accessible status label.

• □ Incomplete tasks receive a different status label.

A block quote can contain a list:

• First quoted item.
• Second quoted item.

A second quote can be nested inside the first.

This is the nested quote.

Tables and safe HTML

Syntax	Rendered form
# Heading	A heading
**text**	Strong emphasis

Use semantic inline HTML such as Ctrl when it adds useful meaning. Active markup such as is removed by the sanitizer.