Some ideas#

admonition blocks

Note

nota

adm

ammonizione

Tip

consiglio

See also

vedi anche

Error

errore

Important

importante

Caution

cauzione

Warning

attenzione

   blocco di codice

inserto nel testo

This is the title

This is the content

Link a una parte Signal Transformers.

(sec:signal_transformer)=

Link a una parte [](sec:signal_transformer).

LINK to PDF file and open it in a new tab

<a href = "relative_path" target="_blank"> link_name </a>

(label_to_sth)=

to recall the label … not sure … Some ideas

(26)#\[ e = mc^2 \]

This is the best equation (26)

look at this source material for substitution

Notebooks with MyST Markdown#

Jupyter Book also lets you write text-based notebooks using MyST Markdown. See the Notebooks with MyST Markdown documentation for more detailed instructions. This page shows off a notebook written in MyST Markdown.

An example cell#

With MyST Markdown, you can define code cells with a directive like so:

print(2 + 2)

4

When your book is built, the contents of any {code-cell} blocks will be executed with your default Jupyter kernel, and their outputs will be displayed in-line with the rest of your content.

See also

Jupyter Book uses Jupytext to convert text-based files to notebooks, and can support many other text-based notebook files.

Create a notebook with MyST Markdown#

MyST Markdown notebooks are defined by two things:

  1. YAML metadata that is needed to understand if / how it should convert text files to notebooks (including information about the kernel needed). See the YAML at the top of this page for example.

  2. The presence of {code-cell} directives, which will be executed with your book.

That’s all that is needed to get started!

Quickly add YAML metadata for MyST Notebooks#

If you have a markdown file and you’d like to quickly add YAML metadata to it, so that Jupyter Book will treat it as a MyST Markdown Notebook, run the following command:

jupyter-book myst init path/to/markdownfile.md