# View Markdown

HackMD offers a great unified Markdown editor/preview which is familiar and well-suited to our needs. Our meeting records have improved a lot over a short period and as a result we are able to be better accountable to each other as a team. Markdown Viewer is an open source lightweight Python tool to display Markdown files. View statistics for this project via Libraries.io. Web Essentials is a great plug-in if you want to see Markdown files inside of Visual Studio. It has an editor with live preview for Markdown. Also it includes several other features for web development (most of them are integrated directly into Visual Studio with the next release). Markdown files¶ You can write content in regular Markdown files (e.g., files ending in.md). Jupyter Book supports any Markdown syntax that is supported by Jupyter notebooks. Jupyter Notebook Markdown is an extension of a flavour of Markdown called CommonMark Markdown. It has many elements for standard text processing, though it lacks a lot of.

You can write content in regular Markdown files (e.g., files ending in .md).Jupyter Book supports any Markdown syntax that is supported by Jupyter notebooks.Jupyter Notebook Markdown is an extension of a flavour of Markdown calledCommonMark Markdown.It has many elements for standard text processing, though it lacks a lot of features used forpublishing and documentation.

Note

If you’d like a more in-depth overview and guide to CommonMark Markdown, seethe CommonMark Markdown tutorial.

This page describes some basic features of the Jupyter Notebook Markdown, and how toinclude them with your book.

## Embedding media¶

You can reference external media like images from your Markdown file. If you userelative paths, then they will continue to work when the Markdown files are copied over,so long as they point to a file that’s inside of the repository.

Here’s an image relative to the book content root

It was generated with this code:

You can even embed references to movies on the web! For example, here’s a little GIF for you!

This will be included in your book when it is built.

## View Markdown In Vscode

For HTML outputs, Jupyter Book uses the excellent MathJax library,along with the default Jupyter Notebook configuration, for rendering mathematics from LaTeX-style syntax.

For example, here’s a mathematical expression rendered with MathJax:

## View Markdown In Atom

[begin{split}P(A_1 cup A_2 cup A_3)& = P(B cup A_3) & = P(B) + P(A_3) - P(BA_3) &= P(A_1) + P(A_2) - P(A_1A_2) + P(A_3) - P(A_1A_3 cup A_2A_3) &= sum_{i=1}^3 P(A_i) - mathop{sum sum}_{1 le i < j le 3} P(A_iA_j) + P(A_1A_2A_3)end{split}]

### Block-level mathematics¶

You can include block-level mathematics by wrapping your formulas in  characters.For example, the following block:

Results in this output:

[wow = its^{math}]

You can also include math blocks by using LaTeX-style syntax using begin{align*}.For example, the following block:

Results in:

[begin{align*}yep = its_{more}^{math}end{align*}]

Important

## View Markdown In Terminal

This requires the amsmath MyST extension to be enabled.

## View Markdown Online

In addition to CommonMark Markdown, Jupyter Book also supports a more fully-featured version of Markdown called MyST Markdown.This is a superset of CommonMark that includes syntactic pieces that are useful for publishing computational narratives.For more information about MyST Markdown, see MyST Markdown overview.