reading-notes

Reading Notes

Basic Writing & Formatting Syntax in Markdown

GitHub Docs: Basic Syntax

Markdown Guide: Extended Syntax

What is Markdown?

Markdown is a lightweight markup language that can be used to add formatting elements to plaintext documents. Unlike a text editor that instantly displays the styling added to text, in Markdown you will only see the syntax of the style while editing. You can utilize the “Preview” feature to view the stylistic changes made to text elements to see how their formatting has changed.

Why use Markdown?

Headings

Headings are generated using 1-6 # symbols at the beginning of the line. The number of # use determines the size: 1 = Largest; 6 = Smallest

# Largest Heading ## Second Largest ###### Smallest Heading

Largest Heading

Second Largest

Smallest Heading

If you generate two or more headings, GitHub autogenerates a Table of Contents, accessible by clicking the 3-bulleted list icon.

Styling Text

You can emphasis words using bold, italics, strikethrough, subscripts, superscripts, & bold __and__ italtics.

Style Syntax Keyboard Shortcut Example Output
Bold ** ** or __ __ Ctrl + B **Bold Text** Bold Text
Italic * * or _ _ Ctrl + I *Italics* Italics
Strikethrough ~~ ~~   ~~Mistake~~ Mistake
Bold & Nested Italic ** ** & _ _   **This is _extrememly_ important** This is extremely important
All Bold & Italic *** ***   ***All of this is important*** All of this is important
Subscript <sub> </sub>   <sub>Subscript</sub> Subscript
Superscript <sup> </sup>   <sup>Superscript</sup> Superscript
Code ` `   `git status` git status
Ignore Content <!-- Ignore This -->   N/A Content will not display
Links ` Display `   [GitHub Pages](https://pages.github.com/) GitHub Pages
Images ![Image](URL)   ![This is an image](https://myoctocat.com/assets/images/base-octocat.svg) This is an image
Footnotes Text[^#]   Reference[^1] Reference1
  1. My Reference