> For the complete documentation index, see [llms.txt](https://training.callysto.ca/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://training.callysto.ca/coding/markdown.md).

# Markdown Language

A great feature of the Jupyter Notebooks is that they can contain formatted text, mathematical formula, and embedded images, via the use of the Markdown language.

Markdown is a rich language: a quick introduction to it is available here: <https://guides.github.com/features/mastering-markdown/>

Some quick points:

## Editing and typesetting

Within the Jupyter notebook, you simply type your text and Markdown symbols into a cell, and hit “shift-return” to typeset the cell into pretty text (and math). Click on the cell again to undo the typesetting, so you can edit and fix your text. Make sure, of course, that you have marked the cell as “Markdown” and not “Code.”

## Headers

Headers are made by starting the line with one or more hash marks #.

```
## This is a level-2 header, in text form
```

## Emphasis

Add emphasis by surrounding text with asterix or underscores.

`* italics * and ** bold **` yield *italics* and **bold** .

### Lists

Type this:

```
- Apple
- Orange
- Pear
```

to get a list like this:

* Apple
* Orange
* Pear

Use numbers instead, to get an enumerated list

#### Web links

Type this `[GitHub](http://github.com)` to get a clickable weblink like this: [GitHub](http://github.com)

#### Images

Type this `![Image of Yaktocat](https://octodex.github.com/images/yaktocat.png)` to embedd an image into your webpage:, like this: ![Image of Yaktocat](https://octodex.github.com/images/yaktocat.png)

#### Mathematics

Use the dollar sign `$`to indicate the start and end of LaTeX code for your math.

Here is the code for basic integral `$\int \cos(x) dx = \sin(x)$` which results in this display. $\int \cos(x) dx = \sin(x)$

To get the formula on a stand=alone line, use double dollar signs: `$$\int \cos(x) dx = \sin(x)$$` $$\int \cos(x) dx = \sin(x)$$

A cheat sheet with more details is available here: <https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://training.callysto.ca/coding/markdown.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
