Basic Syntax in Markdown
Heading
There are 6 level hierarchy of heading in Markdown. To create header, add hashtag symbols # before you write the headers. The amount of # you add will respond the 1-6 typeface size of your heading level hierarchy.
| Heading level hierarchy | Markdown syntax | Example |
|---|---|---|
| Level 1 | Title page | # Heading level 1 |
| Level 2 | Main topic | ## Heading level 2 |
| Level 3 | Sub topic | ### Heading level 3 |
Rendered output example:
Heading level 1
Heading level 2
Heading level 3
Heading level 6
Styling Text in Markdown
Bold
To emphasize your text with bold you need to wrap your text with double aterisk * or double underscore _.
| Markdown Syntax | Example | Rendered Output |
|---|---|---|
** ** | **this is bold text** | this is bold text |
__ __ | __this is bold text__ | this is bold text |
Italic
To create italic text, you have to add single arterisk symbol * or underscore _ before and after your text, both work in markdown. Choose one symbol you preferred and don’t mix them up.
| Markdown Syntax | Example | Rendered Output |
|---|---|---|
* * | *this is italic* | this is italic |
_ _ | _this is italic too_ | this is italic too |
Bold and Italic
To create bold and italic text at the same time wrap your text with triple arterisk *** or underscore ___.
| Markdown Syntax | Example | Rendered Output |
|---|---|---|
*** *** | ***your text*** | your text |
Or if you want to mix it up:
| Markdown Syntax | Example | Rendered Output |
|---|---|---|
* ** ** * | *italic **bold and italic** italic* | italic bold and italic italic |
Strikethrough
To strike through your text add double tildes ~~ ~~ before and after your text.
Example:
Rendered Output: strikethrough
Blockquotes
To call your audience attention by quoting your text, use the symbol of greater-than > before your text.
Example:
Rendered Output:
This is quote text
Inline Code
To denote a text as code, wrap your text with single backticks (`).
Example: `code`
Rendered Output: code
Code Blocks
To blocks your text with code use triple backticks (```) before and after your text.
Example:
Rendered output:
Lists
Ordered Lists
To make ordered list you can add any number then followed by your item lists. The number not strict as numerical order, as long as it’s number then your item list, the rendered output will be still as ordered lists.
Example:
Rendered output:
- item 1
- item 2
- item 3
or
- item 1
- item 2
- item 3
Unordered Lists
There are 3 ways to create unordered lists, you can use the single symbol of arterisk *, plus +, or minus - then followed by space and your item lists. Choose one symbol and don’t combine them in one list category.
Example:
Rendered output:
- item
- item
- item
or
- item
- item
- item
or
- item
- item
- item
don’t
- item
- item
- item
Link
There are two common style of links you can make in markdown. Inline links and reference style links. The inline links is used when you only have few links and you want to create hyperlinks directly within the text. The reference style links is when you have to put a lot of link on your page and want to make your content format cleaner by separating the reference link and actual URL link.
Inline links
To create inline links, simply wrap your link text in a set of square brackets [] followed by the URL in a set of parentheses ().
Format:
Example:
Rendered output:
Go visit Google
Reference Style Links
To create reference style links the format consists of two parts:
Format:
- The link within your text content:
- The actual link address on your reference list at the end of your page or elsewhere in the same page:
Example:
- In you content:
- In your reference list:
Rendered output: Go visit google
Image
To display image on your page add exclamation mark ! followed by your image text in a set of square brackets [] then the image URL in a set of parentheses (). Type this format with no space.
Markdown format:
Example:
Continue to advance markdown syntax
