Exemples de Markdown

$\KaTeX$

$\KaTeX$ és una llibreria ràpida i fàcil d’usar que permet representar notació matemàtica mitjançant la sintaxi LaTeX.

Pots utilitzar $\KaTeX$ en línia embolcallant l’expressió entre $ o entre \\( i \\).

Per exemple, $ \sin(x) = \sum_{n=0}^{\infty} \frac{(-1)^n}{(2n + 1)!} x^{2n + 1} $ es renderitzarà com: $ \sin(x) = \sum_{n=0}^{\infty} \frac{(-1)^n}{(2n + 1)!} x^{2n + 1} $

Per mostrar l’expressió en una línia pròpia i centrada, embolcalla-la amb $$ o entre \\[ i \\].

Per exemple, \\[ r = \frac{\sum_{i=1}^{n}(x_i - \bar{x})(y_i - \bar{y})}{\sqrt{\sum_{i=1}^{n}(x_i - \bar{x})^2}\sqrt{\sum_{i=1}^{n}(y_i - \bar{y})^2}} \\] es renderitzarà com: \[ r = \frac{\sum_{i=1}^{n}(x_i - \bar{x})(y_i - \bar{y})}{\sqrt{\sum_{i=1}^{n}(x_i - \bar{x})^2}\sqrt{\sum_{i=1}^{n}(y_i - \bar{y})^2}} \]

Activa $\KaTeX$ afegint katex = true a [extra]:

title = "Provant KaTeX"
date = 2002-11-30

[extra]
katex = true

Funciona a: metadades de pàgina, _index.md de secció, o globalment a config.toml.

Per obtenir un millor rendiment i seguretat, els fitxers JavaScript, CSS i les tipografies de $\KaTeX$ s’allotgen localment.

Nota: Després d’activar $\KaTeX$, si vols utilitzar el caràcter $ sense renderitzar-lo com a expressió matemàtica, escapa’l amb una barra inversa: \$.

Fórmules químiques

Les fórmules químiques estan suportades mitjançant l’extensió mhchem, que es carrega automàticament en utilitzar \ce{} o \pu{}.

\ce{} per química: $\ce{H2O}$, $\ce{CO2 + H2O -> H2CO3}$

\pu{} per unitats: $\pu{25 °C}$, $\pu{1.2 mol/L}$

Taula

Aquí tens un exemple de taula¹. Els seus colors canvien en funció del tema actual.

Bloc de codi

fn main() {
    println!("Hola, món!") -> ();
}

Amb numeració de línies

1use std::collections::HashMap;
2
3#[derive(Debug)]
4struct TwinPeaksCharacter {
5    name: String,
6    coffee_rating: f32,
7    pie_preference: String,
8}
9
10fn main() {
11    let mut black_lodge = HashMap::new();
12
13    black_lodge.insert("agent", TwinPeaksCharacter {
14        name: String::from("Dale Cooper"),
15        coffee_rating: 9999.99,
16        pie_preference: String::from("Damn Fine Cherry"),
17    });
18
19    black_lodge.insert("giant", TwinPeaksCharacter {
20        name: String::from("The Fireman"),
21        coffee_rating: 42.424242,
22        pie_preference: String::from("Garmonbozia"),
23    });
24
25    // Calculate total appreciation of damn fine coffee
26    let total_coffee: f32 = black_lodge.values()
27        .map(|character| character.coffee_rating)
28        .sum();
29
30    println!("☕ Total coffee appreciation: {:.2} cups", total_coffee);
31}

Etiquetes de codi

A Rust, declares una variable mutable amb let mut x = 5;, mentre que a Python, simplement fas x = 5. De manera similar, per imprimir un valor a Rust, utilitzaries println!("Valor: {}", x);, però a Python, és tan senzill com print(f"Valor: {x}").

Quote

«La vida, perquè sigui vida, s’ha de viure a poc a poc…»

— Mercè Rodoreda, La plaça del Diamant

Alertes estil GitHub

Configurar github_alerts = true a la secció [markdown] del teu config.toml (requereix Zola 0.21+) activa les alertes estil GitHub:

> [!NOTE]
> Això és una nota!
>
> Pot ocupar diversos paràgrafs.

> [!CAUTION]
> Ves amb compte abans de continuar!

El resultat és:

Això és una nota!

Pot ocupar diversos paràgrafs.

Ves amb compte abans de continuar!

Els tipus d’alerta disponibles són NOTE, TIP, IMPORTANT, WARNING i CAUTION.

Les etiquetes es tradueixen automàticament segons l’idioma de la pàgina. Per canviar-les (o afegir un idioma que falti), sobreescriu les variables CSS --alert-{tipus}-label amb CSS personalitzat:

html:lang(eo) {
    --alert-note-label: "Noto";
    --alert-caution-label: "Atentu";
}

Per tenir control total sobre el títol, la icona i els colors, consulta el shortcode d’advertències.