Markdown Guide
Markdown Guide
This guide is inspired by GitHub's "Mastering Markdown" Guide, found here.
Background
Markdown is a simple way to format text for display on a website.
Markdown Syntax
Headers
This is an \ tag
This is an \ tag
This is an \ tag
Emphasis (Bold, Italic)
This text is italic This is also italic
This text is bold This is also bold
You can also combine them
Lists
Unordered
Item 1
Item 2
Item 2a
Item 2b
Ordered
You do not need to manually number your ordered list. Subsequent items in the list will be automatically numbered if you use -
instead of numbers.
Item 1
Item 2
Item 3
Item 3a
Item 3b
Combined
Item 1
Item 2
Sub-item
Sub-item
Task Lists
Tables
You can create tables by assembling a list of words and dividing them with hyphens - (for the first row), and then separating each column with a pipe |
:
First Header | Second Header |
Content from cell 1 | Content from cell 2 |
Content in the first column | Content in the second column |
Strikethrough
strikethrough text like this
Images
Image syntax allows for alternative text. The format is ![alt text](URL)
. The URL can be a relative project path or an external website URL.
Links
Links are created automatically in most cases (and always on Github). Or, you can specify a link with alternative text.
http://github.com - automatic!
GitHub link
Block Quotes
"Not enough blinky lights." ~ Henry Neeman, SiPE 2018
Code
I think you should use an
<addr>
element here instead.
Markdown supports language-specific syntax highlighting.
You can also simply indent your code by four spaces:
Horizontal Rule
Emoji
GitHub supports emoji! :sparkles: :camel: :boom:
To see a list of every image we support, check out the Emoji Cheat Sheet.
Last updated