Lesson 3. Markdown in Jupyter Notebook

In this lesson, you will learn how to add Markdown documentation to Jupyter Notebook files (.ipynb).

Markdown Styling

In previous lessons, you learned that Markdown is simple plain text that is styled using special characters, including:

#: to create a header element

**: to bold text

*: to italicize text

: to indicate code blocks

You also learned how to add new Markdown cells to your Jupyter Notebook using Menu tools and Keyboard Shortcuts to create new cells. You also learned how to change the default type of the cell by clicking in the cell and selecting a new cell type (e.g. Markdown) in the cell type menu in the toolbar.

Titles

You also learned that can use Markdown to create titles and subtitles using the following syntax:

# This is the biggest title
## This is a subtitle
### This is a smaller subtitle
#### This is an even smaller subtitle

These titles are already present on this page as Markdown (e.g. Markdown Styling above is a subtitle).

In a Jupyter Notebook file, you can double-click in any Markdown cell to see the syntax, and then run the cell again to see the Markdown formatting.

Lists

You can also use Markdown to create lists using the following syntax:

* This is a bullet list
* This is a bullet list
* This is a bullet list


1. And you can also create ordered lists
2. by using numbers
3. and listing new items in the lists 
4. on their own lines

It will render as follows:

• This is a bullet list
• This is a bullet list
• This is a bullet list

1. And you can also create ordered lists
2. by using numbers
3. and listing new items in the lists
4. on their own lines

Notice that you have space between the * or 1. and the text. The space triggers the action to create the list using Markdown.

Bold and Italicize

You can also use ** to bold or * to italicize words. To bold and italicize words, the symbols have to be touching the word and have to be repeated before and after the word using the following syntax:

*This is an italicized word, not a bullet list*
**This is a bold word, not a bullet list**

* **This is a bullet item with bold words**
* *This is a bullet item with italicized words*

It will render as follows:

This is an italicized word, not a bullet list This is a bold word, not a bullet list

• This is a bullet item with bold words
• This is a bullet item with italicized words

Hyperlinks

You can also use Markdown to create hyperlinks to websites using the following syntax:

The course website can be found at <a href="http://earthdatascience.org/courses/earth-analytics-bootcamp/" target="_blank">this link</a>. 

It will render as follows:

The course website can be found at this link.

Images

You can also use Markdown to link to images on the web using the following syntax:

<figure>
   <a href="https://www.fullstackpython.com/img/logos/markdown.png">
   <img src="https://www.fullstackpython.com/img/logos/markdown.png" alt="You can use Markdown to add images to Jupyter Notebook files, such as this image of the Markdown logo. Source: Full Stack Python."></a>
   <figcaption> You can use Markdown to add images to Jupyter Notebook files, such as this image of the Markdown logo. Source: Full Stack Python.
   </figcaption>
</figure>

It will render as follows: