Markdown Explained: Headings, Lists and Links in Plain Text

The six points in the video

This is a silent video. The headings, explanations and labels below reproduce the information on screen.

1. 1

   Step 1: Start with readable text

   0:18

   Write the content in a plain text file or Markdown editor.

   On-screen labels: Plain text; Readable source; Editable content.

2. 2

   Step 2: Give headings a structure

   0:30

   Use the supported heading notation to organise the document.

   On-screen labels: Main heading; Section headings; Clear order.

3. 3

   Step 3: Keep lists consistent

   0:42

   Use syntax supported by the renderer for related items and steps.

   On-screen labels: Related points; Numbered steps; Consistent spacing.

4. 4

   Step 4: Check the link destination

   0:54

   Review both the visible label and the address it opens.

   On-screen labels: Useful label; Correct address; Working destination.

5. 5

   Step 5: Know the supported flavour

   1:06

   Renderers can support different extensions such as tables.

   On-screen labels: Actual renderer; Supported features; Extension differences.

6. 6

   Step 6: Preview before publishing

   1:18

   Review the displayed headings, lists, links and spacing.

   On-screen labels: Rendered content; Clear structure; Working links.

Common questions

Go further