images for clarity

tutorials/table_of_contents_ipython.ipynb

@@ -1,7 +1,7 @@
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:19987eb5b732fc336836589fd9ab146141494c84bb74435e60e69fab53bf0781"
+  "signature": "sha256:41219a44026c84eeb3ccb56875545bab3944aeb5cd6d39c51e32ee01fb0cb20d"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
@@ -56,7 +56,18 @@
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "For example, [click this link](#bottom) to jump to the bottom of the page."
+      "![example table](../Images/ipython_links_ex.png)"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "<br>\n",
+      "<br>\n",
+      "For example, [click this link](#bottom) to jump to the bottom of the page.\n",
+      "<br>\n",
+      "<br>"
      ]
     },
     {
@@ -75,6 +86,13 @@
       "2. an internal hyperlink to the destination"
      ]
     },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "![two components](../Images/ipython_links_overview.png)"
+     ]
+    },
     {
      "cell_type": "markdown",
      "metadata": {},
@@ -140,7 +158,7 @@
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "### One more piece of advice"
+      "# One more piece of advice"
      ]
     },
     {
@@ -194,7 +212,14 @@
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "which is certainly not what we want (note that it looks normal in the IPython notebook, but not in the converted HTML version).\n",
+      "which is certainly not what we want (note that it looks normal in the IPython notebook, but not in the converted HTML version). So my favorite remedy would be to put the `id`-anchor tag into a separate cell just above the section, ideally with some line breaks for nicer visuals.\n",
+      "\n",
+      "![img of format problem](../Images/ipython_links_format.png)\n",
+      "\n",
+      "### Remedy: id-anchor tag in a separate cell\n",
+      "\n",
+      "![img of format problem](../Images/ipython_links_remedy.png)\n",
+      "\n",
       "<br>\n",
       "<br>\n",
       "<br>\n",