Markdown is a plain-text writing system that uses simple symbols to format web content. This cheat sheet helps students remember the most common syntax for headings, bold text, links, images, lists, code, quotes, and tables. It is useful for class notes, README files, blogs, documentation, and online assignments.
Learning Markdown helps students write clearly without needing a complex editor.
The core idea is that readable text plus a few symbols becomes formatted content when rendered. Symbols like #, *, -, >, `, and []() tell the computer how to display the text. Spacing matters, especially for lists, code blocks, and tables.
A strong Markdown reference shows the syntax beside the rendered result so students can connect what they type to what readers see.
Key Facts
- A heading uses one to six # symbols before text, such as # Title for a level 1 heading and ### Section for a level 3 heading.
- Bold text uses two asterisks or underscores on each side, such as **important** or __important__.
- Italic text uses one asterisk or underscore on each side, such as *word* or _word_.
- A link uses the pattern [link text](https://example.com), where the visible words go in brackets and the URL goes in parentheses.
- An image uses the pattern , where the exclamation mark tells Markdown to display an image instead of a link.
- An unordered list uses -, *, or + before each item, such as - apples, and an ordered list uses numbers, such as 1. First step.
- Inline code uses single backticks, such as `print("Hello")`, and a code block uses three backticks before and after the code.
- A simple table uses pipes and a separator row, such as Name | Score followed by --- | --- and then Ana | 95.
Vocabulary
- Markdown
- Markdown is a lightweight markup language that turns plain text with simple symbols into formatted content.
- Syntax
- Syntax is the required pattern of characters that tells Markdown how to format text.
- Rendered Result
- The rendered result is the formatted version that readers see after Markdown is processed.
- Heading
- A heading is a title or section label created with one or more # symbols before the text.
- Inline Code
- Inline code is short code or command text placed inside a sentence using single backticks.
- Alt Text
- Alt text is a short description of an image that helps screen readers and appears if the image cannot load.
Common Mistakes to Avoid
- Forgetting the space after # in a heading is wrong because #Title may not render as a heading in some Markdown tools, while # Title is the standard form.
- Putting link parts in the wrong order is wrong because (https://example.com)[Example] will not create a normal link, while [Example](https://example.com) will.
- Using one backtick for a multi-line code block is wrong because single backticks are for inline code, while three backticks are used before and after longer code.
- Breaking table alignment with missing pipes is wrong because each row needs matching columns, such as Item | Price followed by --- | ---.
- Adding random indentation before normal text is wrong because Markdown may treat indented lines as code blocks instead of regular paragraphs.
Practice Questions
- 1 Write the Markdown syntax for a level 2 heading that says Science Notes.
- 2 Write Markdown that makes the word velocity bold and the word acceleration italic.
- 3 Write Markdown for a link with the visible text LivePhysics that goes to https://livephysics.com.
- 4 A classmate writes notes using plain paragraphs only. Explain why headings, lists, and code formatting make Markdown notes easier to read and maintain.