Chirun Markdown Extensions¶

The flavour of Markdown used in Chirun is Python Markdown with PyMdown Extensions and some further Chirun Extensions.

Chirun-specific extensions are described below.

Including Images¶

Include images by using the filename path relative to the source document. Chirun will detect images included in this way and will copy them to the output directory automatically. Attribute Lists can be used to customise image style.

![A plot of y=sin(x)](images/lecture_sine2.png){width="70%"}

Markdown Slides¶

Slides can be written in Markdown and converted to a continuous HTML page, HTML slides and printable PDF by creating a Slides item type.

An example of Markdown slides for Chirun can be found in the sample course.

The source document for the above Markdown slides can be found on GitHub at https://raw.githubusercontent.com/chirun-ncl/sample_course/master/markdown/lecture.md

Slide Separator¶

Separate slides in Chirun Markdown by inserting a line containing nothing but (at least) 3 dashes, surrounded by a blank line above and below:

---

The slide separator renders as a horizontal rule in the HTML web page version of the content.

Embedding Other Content¶

Numbas¶

A Numbas exam can be embedded into a document with the <embed-numbas> tag:

<embed-numbas data-url="https://numbas.mathcentre.ac.uk/exam/1973/numbas-website-demo/embed/"></embed-numbas>

YouTube¶

A YouTube video be embedded into a document with,

<youtube-embed data-id="EdyociU35u8"></youtube-embed>

Attribute	Description
`data-id`	The YouTube video ID

Vimeo¶

A Vimeo video be embedded into a document with,

<vimeo-embed data-id="8169375"></vimeo-embed>

Attribute	Description
`data-id`	The Vimeo video ID

oEmbed¶

Chirun supports embedding content with providers that support oEmbed.

<oembed data-url="[...]"></oembed>

Attribute	Description
`data-url`	The URL of the oEmbed compatible content to be embedded

Code Blocks¶

Code blocks with syntax highlighting can be included using SuperFences.

This example shows two different ways to include code blocks. The first is a code block set to use Python syntax highlighting. The second code block also displays Python code, but also includes a button that can be clicked to show the output from running the code.

### Print statements

```python
print("Hello", "World")
```

### If statements

```runnable lang="python"
x = 2
if x > 0:
    print('it is true')
```