Writing content in MyST¶

The MyST forms of the specimens on Writing content, each rendered live by this page’s own Markdown parser. Their needs carry ids of their own, because an id defined twice in one project is reported.

Inline markup¶

Inline markup

Text can be *emphasised*, **strong**, or `code`.

Text can be emphasised, strong, or code.

Lists¶

Lists

- A bullet item.
- Another.

1. A numbered item.
1. The next.

A bullet item.
Another.

A numbered item.
The next.

Links¶

Links

Read [the Sphinx site](https://www.sphinx-doc.org/),
or this page's {ref}`authoring_index_rst_and_myst`.

Read the Sphinx site, or this page’s reStructuredText and MyST.

Code blocks¶

Code block

```python
print("Hello, ubCode!")
```

print("Hello, ubCode!")

Note¶

Note

```{note}
This box is rendered from the source shown above.
```

Note

This box is rendered from the source shown above.

Figures¶

Figure

```{figure} /_static/ubCode_icon_light.svg
:alt: The ubCode mark
:width: 96px

The ubCode mark.
```

Tables¶

List table

```{list-table}
:header-rows: 1

* - Builder
  - Writes
* - `ubc build html`
  - A static site.
* - `ubc build pdf`
  - One PDF file.
```

Builder	Writes
`ubc build html`	A static site.
`ubc build pdf`	One PDF file.

Needs¶

Two linked needs

```{req} Sign in with a company account
:id: EX_HUB_MYST_REQ
:status: open

A user signs in with the account the company directory holds.
```

```{spec} Sign in through the directory
:id: EX_HUB_MYST_SPEC
:status: open
:links: EX_HUB_MYST_REQ

The sign-in page hands the user to the directory.
```

Requirement: Sign in with a company account EX_HUB_MYST_REQ

status: open

links incoming: EX_HUB_MYST_SPEC

A user signs in with the account the company directory holds.

Specification: Sign in through the directory EX_HUB_MYST_SPEC

status: open

links outgoing: EX_HUB_MYST_REQ

The sign-in page hands the user to the directory.

Need references¶

Need references

{need}`EX_HUB_MYST_SPEC` refines {need}`EX_HUB_MYST_REQ`.

Sign in through the directory (EX_HUB_MYST_SPEC) refines Sign in with a company account (EX_HUB_MYST_REQ).

Need tables¶

Needs table

```{needtable}
:filter: id.startswith("EX_HUB_MYST_")
:columns: id, title, status, links
:style: table
```

ID	Title	Status	Links
EX_HUB_MYST_REQ	Sign in with a company account	open
EX_HUB_MYST_SPEC	Sign in through the directory	open	EX_HUB_MYST_REQ