Code and includes in MyST

The MyST forms of the specimens on Code and includes, each rendered live by this page’s own Markdown parser.

Code blocks

A code block

```{code-block} python
:caption: A greeting
:linenos:
:emphasize-lines: 2

def greet(name: str) -> str:
    return f"Hello, {name}!"
```

A greeting

def greet(name: str) -> str:
    return f"Hello, {name}!"

Literal includes

A literal include

```{literalinclude} /../specimens/directives/greeting.py
:language: python
:caption: greeting.py
:lines: 4-7
:lineno-match:
```

greeting.py

def greet(name: str) -> str:
    """Return a greeting for ``name``."""
    message = f"Hello, {name}!"
    return message

Parsed literal blocks

A parsed literal block

```{parsed-literal}
ubc build html *source-dir* -o *output-dir*
ubc build pdf  *source-dir* -o *output-file*
```

ubc build html source-dir -o output-dir
ubc build pdf  source-dir -o output-file

Including files

An included file

```{include} /../specimens/directives/fragment.txt
```

This paragraph lives in a file of its own, and its markup is parsed where it lands.