#!/usr/bin/env python
# coding: utf-8

# # Markdown Cells

# Text can be added to Jupyter Notebooks using Markdown cells.  Markdown is a popular markup language that is a superset of HTML. Its specification can be found here:
# 
# <http://daringfireball.net/projects/markdown/>

# ## Markdown basics

# Press `Enter` or double click to edit a Markdown cell.  Press `Shift-Enter` to render a Markdown cell.

# You can make text *italic* or **bold**.

# You can build nested itemized or enumerated lists:
# 
# * One
#     - Sublist
#         - This
#   - Sublist
#         - That
#         - The other thing
# * Two
#   - Sublist
# * Three
#   - Sublist
# 
# Now another list:
# 
# 1. Here we go
#     1. Sublist
#     1. Sublist
# 1. There we go
# 1. Now this

# ### Exercise

# Create a Markdown cell and try the following constructs:
# 
# * Bold and italic text
# * Itemized and enumerated lists

# ## More elements

# You can add horizontal rules:
# 
# ---

# Here is a blockquote:
# 
# > Beautiful is better than ugly.
# > Explicit is better than implicit.
# > Simple is better than complex.
# > Complex is better than complicated.
# > Flat is better than nested.
# > Sparse is better than dense.
# > Readability counts.
# > Special cases aren't special enough to break the rules.
# > Although practicality beats purity.
# > Errors should never pass silently.
# > Unless explicitly silenced.
# > In the face of ambiguity, refuse the temptation to guess.
# > There should be one-- and preferably only one --obvious way to do it.
# > Although that way may not be obvious at first unless you're Dutch.
# > Now is better than never.
# > Although never is often better than *right* now.
# > If the implementation is hard to explain, it's a bad idea.
# > If the implementation is easy to explain, it may be a good idea.
# > Namespaces are one honking great idea -- let's do more of those!

# And shorthand for links:
# 
# [Jupyter's website](http://jupyter.org)

# ## Headings

# If you want, you can add headings using Markdown's syntax:
# 
# # Heading 1
# # Heading 2
# ## Heading 2.1
# ## Heading 2.2

# ## Embedded code

# You can embed code meant for illustration instead of execution in Python:
# 
#     def f(x):
#         """a docstring"""
#         return x**2
# 
# or other languages:
# 
#     if (i=0; i<n; i++) {
#       printf("hello %d\n", i);
#       x += 4;
#     }
# 
# You can also put code inside lists by indenting 8 spaces:
# 
# * Item one
# * Item two
# 
#         for i in range(10):
#             print(i)
# 
# * Item three

# ## LaTeX equations

# Courtesy of MathJax, you can include mathematical expressions both inline: 
# $e^{i\pi} + 1 = 0$  and displayed:
# 
# $$e^x=\sum_{i=0}^\infty \frac{1}{i!}x^i$$

# ## General HTML

# Because Markdown is a superset of HTML you can even add things like HTML tables:
# 
# <table>
# <tr>
# <th>Header 1</th>
# <th>Header 2</th>
# </tr>
# <tr>
# <td>row 1, cell 1</td>
# <td>row 1, cell 2</td>
# </tr>
# <tr>
# <td>row 2, cell 1</td>
# <td>row 2, cell 2</td>
# </tr>
# </table>

# ## Github Flavored Markdown

# The Notebook webapp support Github flavored markdown meaning that you can use triple backticks for code blocks 
# <pre>
# ```python
# print("Hello World")
# ```
# 
# ```javascript
# console.log("Hello World")
# ```
# </pre>
# 
# Gives 
# ```python
# print("Hello World")
# ```
# 
# ```javascript
# console.log("Hello World")
# ```
# 
# And a table like this : 
# 
# <pre>
# | This | is   |
# |------|------|
# |   a  | table| 
# </pre>
# 
# A nice Html Table
# 
# | This | is   |
# |------|------|
# |   a  | table| 

# ## Local files

# In[2]:


get_ipython().system('ls *svg *m4v')


# If you have local files in your Notebook directory, you can refer to these files in Markdown cells via relative URLs that are prefixed with `files/`:
# 
#     files/[subdirectory/]<filename>
# 
# Note that it is **not** `/files`.
# 
# For example, in the `figs` subdirectory, we have the Python logo:
# 
# ![img](files/python-logo.svg)
# 
# and a video with the HTML5 video tag:
# 
# <video controls src="files/animation.m4v" />
# 
# These do not embed the data into the notebook file, and require that the files exist when you are viewing the notebook.

# ### Exercise

# Download a photo from the web into the local directory, and display it in the notebook by using the files URL pattern explained above

# ### Security of local files

# Note that this means that the Jupyter notebook server also acts as a generic file server
# for files inside the same tree as your notebooks.  Access is not granted outside the
# notebook folder so you have strict control over what files are visible, but for this
# reason it is highly recommended that you do not run the notebook server with a notebook
# directory at a high level in your filesystem (e.g. your home directory).
# 
# When you run the notebook in a password-protected manner, local file access is restricted
# to authenticated users unless read-only views are active.