Jupyter Based Content

This an idential copy of the Markdown Based Notebook chapter, but the source file was a Jupyter Notebook (.ipynb) instead of a Markdown (.md) file

1Standard Markdown¶

These features are supported by all renderers as they are part of the basic set of features of Markdown. Some examples were extracted from the official docs.

1.1Text Formating¶

In a Markdown text one can use bold, italics or both. It is also posible to combine it with monospace.

1.2Quotes¶

It is also possible to quote

1.3Lists¶

To keep everything organize, one usually use lists either ordered

1. Step 1

2. Step 2

3. Step 3

Or without any order

• Requirement 1

• Requirement 2

• Requirement 3

1.4Horizontal Rule¶

Useful to separate sections

From other non-related topic

1.5Links¶

You know that there many search engines online?

There are some which focus on privacy, others just work arround Google and there is also one that uses ecryption!

1.6Images¶

One image is worth a thousand words some say

But it is even better if you can click them

2Limited Support¶

These features are part of some flavours of Markdown but not all renderers can process them. It is recommended to visualize this document in the target platform to check exactly which features are supported

2.1Tables¶

Tables are really complicated in Markdown and should only be generated by a specialized tool. Don’t modify markdown tables manually

2.2Block of Code¶

For code blocks, Jupyter Book will add a Copy button in the top left corner to easily copy all the text in the block.

Some times one wants to share data

{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}

Or simply say hello

print("Hello World!")

2.3Footnotes¶

Here’s a sentence with a footnote. ^[1]

2.4Math¶

Some renderers can process inline math, $x=2$ and other can also process whole line math

If supported, alignment can be done with array

2.5Not supported in Jupyter Book¶

These are features that some renderers support but are not supported by Jupyter Book

2.5.1Strikethrough¶

Some times you ~~make a mistake~~ have a great idea

However, a HTML approach can produce the desired result

Some times you make a mistake have a great idea

2.5.2Check List¶

• Write the press release

• Update the website

• Contact the media

However, a HTML approach can produce the desired result

[ ] Write the press release

[ ] Update the website

[ ] Contact the media

3MyST Specific¶

These are some features that are the moment are only compatible with Jupyter Book. That means that rendering the notebook in other services (Github, NBviewer, Nteract, Data Lore, etc.) might not work as shown below. If your only target platform is Jupyter Book, you can use any of the following.

3.1Colored Admonitions¶

3.2Hidden Toggles¶

3.3Dropdowns¶

3.4Dropdowns with Admonitions¶

3.5Panels¶

3.6Tabs¶

3.7Sidebars¶

Sidebars are shown in parallel to the main text, but they span inwards from the margins.

3.8Margin Note¶

Margin notes are more discrete, useful for pointing minor details or add extra information.

They span from the margin outwards

3.9Labels¶

Would you like to write homework for your students? Check the dropdowns!

It is always important to provide enough data to support claims!

3.10Equations¶

3.10.1Without Label¶

3.10.2With Label¶

If the equation has a label, it can be then referenced (4)

3.11Citation¶

This project uses numbered citations (IEEE style), enabled by setting numbered_references: true under site.options in myst.yml. Citations can be customized — see the MyST citations guide for details.

MyST supports Pandoc-style citation syntax. With numbered_references enabled, parenthetical citations render as numbers while narrative citations keep the author name in the text.

3.11.1Parenthetical (numbered)¶

Use square brackets around the citation key: [@perez2011python].

This project uses the Python Language 1 to build Jupyter Book 2.

3.11.2Narrative¶

Use the citation key with an at-sign, without brackets: @perez2011python.

Perez et al. (2011) introduced Python as an ecosystem for scientific computing. Jupyter Book is documented in Community (2020).

MyST automatically adds a references section at the bottom of pages that contain citations. When using numbered references together with footnotes, keep in mind that both appear at the bottom of the page and may be numbered in the same sequence.