GitHub Pages renders Markdown differently than GitHub does. GitHub uses its own Markdown processor. README.md file will look different on GitHub’s website than on your GitHub Pages website.
Markdown in GitHub
🏴Headings
To create a heading, add number signs (#) in front of a word or phrase.
# Heading level 1
🏴Bold
To bold text, add two asterisks or underscores before and after a word or phrase.
I just love **bold text**
I just love __bold text__
🏴Italic
To italicize text, add one asterisk or underscore before and after a word or phrase.
Italicized text is the *cat's meow*
Italicized text is the _cat's meow_
🏴Lists
You can organize items into ordered and unordered lists.
Ordered Lists
To create an ordered list, add line items with numbers followed by periods. The numbers don’t have to be in numerical order, but the list should start with the number one.
1. First item
2. Second item
3. Third item
1. Indented item
2. Indented item
4. Fourth item
Unordered Lists
To create an unordered list, add dashes (-), asterisks (*), or plus signs (+) in front of line items. Indent one or more items to create a nested list.
- First item
- Second item
- Third item
- Indented item
- Indented item
- Fourth item
🏴Links
To create a link, enclose the link text in brackets (e.g., [Duck Duck Go]) and then follow it immediately with the URL in parentheses (e.g., (duckduckgo.com)).
My favorite search engine is [Duck Duck Go](https://duckduckgo.com)
🏴Images
To add an image, add an exclamation mark (!), followed by alt text in brackets, and the path or URL to the image asset in parentheses. You can optionally add a title in quotation marks after the path or URL.
🏴Linking Images
To add a link to an image, enclose the Markdown for the image in brackets, and then add the link in parentheses.
[](https://www.flickr.com/photos/beaurogers/31833779864/in/photolist-Qv3rFw-34mt9F-a)
Thank you for reading