{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Markdown Cells\n", "\n", "Text can be added to IPython Notebooks using Markdown cells. Markdown is a popular markup language that is a superset of HTML. Its specification can be found here:\n", "\n", "\n", "\n", "You can view the source of a cell by double clicking on it, or while the cell is selected in command mode, press `Enter` to edit it. One A cell has been editted, use `Shift-Enter` to re-render it. " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Markdown basics\n", "\n", "You can make text *italic* or **bold**." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "You can build nested itemized or enumerated lists:\n", "\n", "* One\n", " - Sublist\n", " - This\n", " - Sublist\n", " - That\n", " - The other thing\n", "* Two\n", " - Sublist\n", "* Three\n", " - Sublist\n", "\n", "Now another list:\n", "\n", "1. Here we go\n", " 1. Sublist\n", " 2. Sublist\n", "2. There we go\n", "3. Now this" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "You can add horizontal rules:\n", "\n", "---" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Here is a blockquote:\n", "\n", "> Beautiful is better than ugly.\n", "> Explicit is better than implicit.\n", "> Simple is better than complex.\n", "> Complex is better than complicated.\n", "> Flat is better than nested.\n", "> Sparse is better than dense.\n", "> Readability counts.\n", "> Special cases aren't special enough to break the rules.\n", "> Although practicality beats purity.\n", "> Errors should never pass silently.\n", "> Unless explicitly silenced.\n", "> In the face of ambiguity, refuse the temptation to guess.\n", "> There should be one-- and preferably only one --obvious way to do it.\n", "> Although that way may not be obvious at first unless you're Dutch.\n", "> Now is better than never.\n", "> Although never is often better than *right* now.\n", "> If the implementation is hard to explain, it's a bad idea.\n", "> If the implementation is easy to explain, it may be a good idea.\n", "> Namespaces are one honking great idea -- let's do more of those!" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "And shorthand for links:\n", "\n", "[IPython's website](http://ipython.org)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "You can add headings using Markdown's syntax:\n", "\n", "# Heading 1\n", "\n", "# Heading 2\n", "\n", "## Heading 2.1\n", "\n", "## Heading 2.2" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Embedded code\n", "\n", "You can embed code meant for illustration instead of execution in Python:\n", "\n", " def f(x):\n", " \"\"\"a docstring\"\"\"\n", " return x**2\n", "\n", "or other languages:\n", "\n", " if (i=0; i\n", "```python\n", "print \"Hello World\"\n", "```\n", "\n", "```javascript\n", "console.log(\"Hello World\")\n", "```\n", "\n", "\n", "Gives \n", "```python\n", "print \"Hello World\"\n", "```\n", "\n", "```javascript\n", "console.log(\"Hello World\")\n", "```\n", "\n", "And a table like this : \n", "\n", "
\n",
    "| This | is   |\n",
    "|------|------|\n",
    "|   a  | table| \n",
    "
\n", "\n", "A nice HTML Table\n", "\n", "| This | is |\n", "|------|------|\n", "| a | table| " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## General HTML\n", "\n", "Because Markdown is a superset of HTML you can even add things like HTML tables:\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "
Header 1Header 2
row 1, cell 1row 1, cell 2
row 2, cell 1row 2, cell 2
" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Local files\n", "\n", "If you have local files in your Notebook directory, you can refer to these files in Markdown cells directly:\n", "\n", " [subdirectory/]\n", "\n", "For example, in the images folder, we have the Python logo:\n", "\n", " \n", "\n", "\n", "\n", "and a video with the HTML5 video tag:\n", "\n", "