Merge pull request #5893 from mgeier/review-notebook-examples

example notebook: don't recommend using $$...$$ for display math

docs/source/examples/Notebook/Working With Markdown Cells.ipynb

@@ -175,7 +175,9 @@
     "Courtesy of MathJax, you can include mathematical expressions both inline: \n",
     "$e^{i\\pi} + 1 = 0$  and displayed:\n",
     "\n",
-    "$$e^x=\\sum_{i=0}^\\infty \\frac{1}{i!}x^i$$\n",
+    "\\begin{equation}\n",
+    "e^x=\\sum_{i=0}^\\infty \\frac{1}{i!}x^i\n",
+    "\\end{equation}\n",
     "\n",
     "Inline expressions can be added by surrounding the latex code with `$`:\n",
     "\n",
@@ -183,10 +185,12 @@
     "$e^{i\\pi} + 1 = 0$\n",
     "```\n",
     "\n",
-    "Expressions on their own line are surrounded by `$$`:\n",
+    "Expressions on their own line are surrounded by `\\begin{equation}` and `\\end{equation}`:\n",
     "\n",
     "```latex\n",
-    "$$e^x=\\sum_{i=0}^\\infty \\frac{1}{i!}x^i$$\n",
+    "\\begin{equation}\n",
+    "e^x=\\sum_{i=0}^\\infty \\frac{1}{i!}x^i\n",
+    "\\end{equation}\n",
     "```"
    ]
   },