Directrius#

Les directrius són a nivell de paràgraf amb 4 blocs de contingut/arguments:

```{directivename} main-argument
:kwarg1: value
:kwarg2: value

Main content of the directive, generally prose but not necessarly.
```

:::{directivename} main-argument
:kwarg1: value
:kwarg2: value

Main content of the directive, generally prose but not necessarly.
:::

.. directivename:: main-argument
    :kwarg1: value
    :kwaarg2: value

    Main content of the directive, generally prose but not necessarly.

No obstant, d’aquests 4 camps l’únic que és sempre necessari és el nom de la directriu, la majoria de les directrius requereixen el nom de la directriu i almenys un dels camps argument principal, main argument, o contingut principal, main content.

Com podeu veure, MyST permet usar dues sintaxis per definir directrius. No obstant, totes dos funcionen exactament igual, utilitzar l’opció de la tanca de dos punts té l’avantatge de renderitzar el contingut principal de la directriu en Markdown que, encara que només parcialment correcte, pot ajudar a fer-nos una idea de possibles problemes de formatació. Al cap i a la fi, el llenguatge de marques MyST sense rols ni directrius és molt similar al Markdown pur.

Tingueu en compte també que en MyST les directrius es defineixen amb 3 o més accents greus/dos punts, per tal d’imbricar directrius, cal començar amb més accents greus/dos punts per evitar errors de sintaxi per culpa de l’ambigüitat sobre quina directiva s’ha de tancar.

Recursos