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

Standard 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.

Text Formating¶

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

Quotes¶

It is also possible to quote

Lists¶

To keep everything organize, one usually use lists either ordered

Step 1
Step 2
Step 3

Or without any order

Requirement 1
Requirement 2
Requirement 3

Horizontal Rule¶

Useful to separate sections

From other non-related topic

Links¶

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!

Images¶

One image is worth a thousand words some say

But it is even better if you can click them

Limited 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

Tables¶

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

Syntax	Description
Header	Title
Paragraph	Text

Block 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!")

Footnotes¶

Here’s a sentence with a footnote. 1

Math¶

Some renderers can process inline math, \(x=2\) and other can also process whole line math

\[ \int_0^\infty \frac{x^3}{e^x-1}\,dx = \frac{\pi^4}{15} \]

If supported, alignment can be done with array

\[\begin{split} \begin{array}{llll} a_{11}& =b_{11}& a_{12}& =b_{12}\\ a_{21}& =b_{21}& a_{22}& =b_{22}+c_{22} \end{array} \end{split}\]

Not supported in Jupyter Book¶

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

Strikethrough¶

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

Check List¶

[x] 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

MyST 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.

Colored Admonitions¶

Note

Here is a Note

Important

Here is an important

Caution

text Here is a caution

Attention

text Here is an attention

Warning

Here is a Warning

Error

Here is an error

Tip

Here is a Tip

admonition

Here is a custom admonition

Hidden Toggles¶

Some hidden toggle content!

Dropdowns¶

Dropdowns with Admonitions¶

Note

The note body will be hidden!

Panels¶

Panel header 1

Panel body 1

Panel footer 1

Panel header 2

Panel body 2

Panel footer 2

Tabs¶

Tab 1 title

My first tab

Tab 2 title

My second tab with some code!

Sidebars¶

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

Margin Note¶

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

They span from the margin outwards

Labels¶

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

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

Equations¶

Without Label¶

\[x^2 + y^2 = 1\]

With Label¶

(2)¶\[x^2 + y^2 = 1\]

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

Citation¶

There are two types of citations, by name (similar to APA style) and by number (similar to IEEE style).

Citations can be customized, for more detailed explanations please refer to one of the Jupyter Book docs (here, here or here) and the associated extension docs.

By Name¶

This project uses the Python Language [Perez et al., 2011].to build Jupyter Book [Community, 2020]

This will not work unless there is a section called `bibliography``

Bibliography for Names¶

There are different styles for the bibliography in this case

Alphanumeric - Sorted by Author, year¶

Com20: Executable Books Community. Jupyter book. February 2020. URL: https://doi.org/10.5281/zenodo.4539666, doi:10.5281/zenodo.4539666.
PGH11: Fernando Perez, Brian E Granger, and John D Hunter. Python: an ecosystem for scientific computing. Computing in Science \\& Engineering, 13(2):13–21, 2011.

Alphanumeric - Sorted by order of appearance¶

PGH11: Fernando Perez, Brian E Granger, and John D Hunter. Python: an ecosystem for scientific computing. Computing in Science \\& Engineering, 13(2):13–21, 2011.
Com20: Executable Books Community. Jupyter book. February 2020. URL: https://doi.org/10.5281/zenodo.4539666, doi:10.5281/zenodo.4539666.

Numeric - Sorted by Author, year¶

1: Executable Books Community. Jupyter book. February 2020. URL: https://doi.org/10.5281/zenodo.4539666, doi:10.5281/zenodo.4539666.
2: Fernando Perez, Brian E Granger, and John D Hunter. Python: an ecosystem for scientific computing. Computing in Science \\& Engineering, 13(2):13–21, 2011.

Numeric - Sorted by order of appearance¶

1: Fernando Perez, Brian E Granger, and John D Hunter. Python: an ecosystem for scientific computing. Computing in Science \\& Engineering, 13(2):13–21, 2011.
2: Executable Books Community. Jupyter book. February 2020. URL: https://doi.org/10.5281/zenodo.4539666, doi:10.5281/zenodo.4539666.

By Number¶

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

This will not work unless there is a section called footbibliography

For different citation styles, check the official docs

When using footcite and footbibliography, the numbers will be arranged in combination with the footnotes. This could lead to confusion for the reader if this type of references are used in combination with footnotes. To mitigate this issue, a similar result can be achieve using cite and bibliography with the unsrt style.

Bibliography for Numbers¶

In this case, there is a single style

2: Fernando Perez, Brian E Granger, and John D Hunter. Python: an ecosystem for scientific computing. Computing in Science \& Engineering, 13(2):13–21, 2011.
3: Executable Books Community. Jupyter book. February 2020. URL: https://doi.org/10.5281/zenodo.4539666, doi:10.5281/zenodo.4539666.

1: This is the footnote.