3  Urejanje besedila z Markdownom

Objavljeno

23. oktober 2026

3.1 Namen poglavja

V beležnicah Jupyter in v datotekah Quarto ne pišemo razlage neposredno kot oblikovano besedilo, temveč kot zapis v jeziku Markdown. To je preprost označevalni jezik, pri katerem z nekaj znaki določimo naslove, sezname, povezave, slike, preglednice in bloke kode.

Markdown je posebej uporaben zato, ker:

  • ista sintaksa deluje v Jupyter, Quarto, GitHub in številnih drugih okoljih,
  • lahko v isti datoteki združimo razlago, kodo in rezultate,
  • je zapis še vedno dovolj preprost, da ostane berljiv tudi kot surovo besedilo.

Praktični cilj tega poglavja je, da bralec zna:

  • preklopiti celico v način Markdown,
  • zapisati osnovne in nekoliko naprednejše Markdown oznake,
  • razumeti razliko med izvorom in prikazanim rezultatom,
  • uporabiti Markdown pri delu v JupyterLab, VS Code in Quarto.

Več o Markdownu je na voljo na primer tukaj:

V nadaljevanju bomo pri vsakem sklopu najprej pokazali primer izvornega zapisa, nato pa še rezultat, ki ga tak zapis ustvari.

3.2 Markdown v JupyterLab, VS Code in Quarto

V JupyterLab ima vsaka celica svoj tip. Za razlago postopka uporabimo celico Markdown, za izvajanje ukazov pa celico Code.

Tipičen potek v JupyterLab je:

  1. ustvarimo novo celico,
  2. njen tip spremenimo iz Code v Markdown,
  3. vpišemo Markdown oznake,
  4. celico izvedemo z Shift+Enter, da se surovi zapis pretvori v oblikovano besedilo.

V VS Code lahko na enak način urejamo:

  • Markdown celice v datotekah .ipynb,
  • navadne datoteke .md,
  • datoteke .qmd, ki jih uporablja Quarto.

Ko želimo besedilo popraviti, se vedno vrnemo v način urejanja in spreminjamo izvorni zapis. Ta logika je povsod enaka, zato se znanje iz tega poglavja neposredno prenese tudi na druga poglavja knjige.

Pri delu v JupyterLab si je dobro zapomniti še nekaj praktičnih pravil:

  • z dvoklikom na Markdown celico se vrnemo v urejanje,
  • z Shift+Enter jo ponovno upodobimo,
  • v Markdown celice ne sodijo le naslovi in odstavki, ampak tudi slike, povezave, tabele in matematični izrazi,
  • pri daljših beležnicah je smiselno pustiti dovolj prostora za razlago med posameznimi kosi kode.

Tako beležnica ne postane le zaporedje ukazov, ampak razumljiv delovni dokument.

3.3 Naslovi

Naslove najpogosteje pišemo z znakom #. Število znakov določa raven naslova.

Izvorni zapis:

# Naslov 1
## Naslov 2
### Naslov 3
#### Naslov 4
##### Naslov 5
###### Naslov 6

Pomen posameznih vrstic:

  • # Naslov 1 ustvari naslov prve ravni,
  • ## Naslov 2 ustvari naslov druge ravni,
  • ### Naslov 3 ustvari naslov tretje ravni,
  • #### Naslov 4 ustvari naslov četrte ravni,
  • ##### Naslov 5 ustvari naslov pete ravni,
  • ###### Naslov 6 ustvari naslov šeste ravni.

Naslov 1 in naslov 2 lahko dosežemo tudi s podčrtavanjem. Tak zapis danes srečamo redkeje, vendar ga je dobro poznati.

Izvorni zapis:

Alt-Naslov 1
============

Alt-Naslov 2
------------

Pomen:

  • vrstica z znaki = ustvari naslov prve ravni,
  • vrstica z znaki - ustvari naslov druge ravni.

Pri delu v daljših beležnicah in poglavjih je priporočljivo uporabljati dosledno hierarhijo naslovov, saj tako dobimo preglednejšo strukturo dokumenta.

3.4 Poudarek

Zelo pogosta uporaba Markdowna je poudarjanje posameznih delov besedila.

Izvorni zapis:

Poudarek oziroma ležeče besedilo dosežemo z *zvezdicami* ali _podčrtaji_.

Močan poudarek ali krepko dobimo z **dvojnimi zvezdicami**
ali __dvojnimi podčrtaji__.

Oboje lahko tudi kombiniramo z **zvezdicami in _podčrtaji_**.

Za prečrtavanje uporabljamo tildo. ~~Takole.~~

Rezultat:

Poudarek oziroma ležeče besedilo dosežemo z zvezdicami ali podčrtaji.

Močan poudarek ali krepko dobimo z dvojnimi zvezdicami ali dvojnimi podčrtaji.

Oboje lahko tudi kombiniramo z zvezdicami in podčrtaji.

Za prečrtavanje uporabljamo tildo. Takole.

V učbeniških besedilih je priporočljivo, da poudarek uporabljamo zmerno. Dobro služi za označevanje pomembnih pojmov, opozoril ali delov ukazov, ne pa za vizualno okrasje.

3.5 Seznami

Markdown zelo dobro podpira oštevilčene in neoštevilčene sezname. Ti so posebej uporabni pri navodilih po korakih, razlagi postopkov in krajših povzetkih.

Izvorni zapis:

1. Oštevilčen seznam
2. Še ena možnost
    * Podmožnost
1. Prave številke so nepomembne. Samo da je številka.
    1. Urejena podskupina
4. Še ena možnost.

Rezultat:

  1. Oštevilčen seznam
  2. Še ena možnost
    • Podmožnost
  3. Prave številke so nepomembne. Samo da je številka.
    1. Urejena podskupina
  4. Še ena možnost.

Pri seznamih so odstavki pravilno poravnani, če uporabljamo prazne vrstice in primerne zamike. To je posebej pomembno, ko v posamezno točko vključimo daljše pojasnilo.

Izvorni zapis:

Za prelom vrstice znotraj odstavka je potrebno uporabiti dva
končna presledka.
Tole je nova vrstica, ki pa je v istem odstavku.
(To je v nasprotju z nekaterimi drugimi prikazovalniki, kjer to ni vedno nujno.)

Praktični rezultat v Markdownu navadno dosežemo takole:

Za prelom vrstice znotraj odstavka je potrebno uporabiti dva končna presledka.
Tole je nova vrstica, ki pa je v istem odstavku.
(To je v nasprotju z nekaterimi prikazovalniki, kjer to ni vedno nujno.)

Neoštevilčene sezname lahko pišemo na več načinov.

Izvorni zapis:

* Neoštevilčeni seznami imajo lahko zvezdico
- ali minus
+ ali plus

Rezultat:

  • Neoštevilčeni seznami imajo lahko zvezdico
  • ali minus
  • ali plus

Za preglednost je najbolje, da znotraj istega dokumenta izberemo en slog in se ga držimo dosledno.

3.6 Povezave

Povezave lahko ustvarimo na več načinov. Najpogosteje uporabljamo neposredne povezave z besedilom in URL naslovom, včasih pa tudi referenčne oblike.

Izvorni zapis:

[To je povezava](https://www.google.com)

[To je povezava z naslovom](https://www.google.com "Google's Homepage")

[To je referenca][referenca kar tako]

[Referenca na datoteko.](../blob/master/LICENSE)

[Reference so lahko označene s številkami][1]

Ali pa samo označimo [link besedilo].

URLji in URLji v oglatih oklepajih se samodejno pretvorijo v povezave.
http://www.example.com ali <http://www.example.com> in včasih tudi
www.example.com.

[referenca kar tako]: https://www.mozilla.org
[1]: http://slashdot.org
[link besedilo]: http://www.reddit.com

Rezultat:

To je povezava

To je povezava z naslovom

To je referenca

Referenca na datoteko.

Reference so lahko označene s številkami

Ali pa samo označimo link besedilo.

URLji in URLji v oglatih oklepajih se samodejno pretvorijo v povezave: http://www.example.com ali http://www.example.com in včasih tudi www.example.com.

V praksi se pri učbenikih in poročilih največkrat najbolje obnese neposredna oblika [besedilo](povezava), referenčne oblike pa so uporabne pri daljših dokumentih z več ponovitvami.

3.7 Slike

Slike vključimo podobno kot povezave, le da pred oglatim oklepajem dodamo klicaj.

Izvorni zapis:

![alt text](images/markdown/jupyter.png)

Rezultat:

Logotip Jupyter

Besedilo v oglatem oklepaju je nadomestni opis slike. Ta je uporaben za dostopnost in za primere, ko se slika ne naloži pravilno.

3.8 Koda in označevanje sintakse

Markdown zelo pogosto uporabljamo prav zato, ker omogoča lep prikaz programske kode skupaj z razlago.

Bloki s programsko kodo so del Markdowna, označevanje sintakse pa je odvisno od prikazovalnika. Okolja, kot so GitHub, Jupyter in Quarto, običajno podpirajo označevanje za številne jezike.

Koda v besedilu je označena z enojnimi ostrivci.

Izvorni zapis:

Koda v besedilu je označena kot `koda` in jo označujeta ostrivca na obeh straneh.

Rezultat:

Koda v besedilu je označena kot koda in jo označujeta ostrivca na obeh straneh.

Za večvrstično kodo uporabljamo ograjene bloke.

Izvorni zapis:

```javascript
var s = "JavaScript označevanje";
alert(s)
```

Rezultat:

var s = "JavaScript označevanje";
alert(s);

Izvorni zapis:


::: {#29e7909c .cell execution_count=1}
``` {.python .cell-code}
s = "Python označevanje"
print(s)
```

::: {.cell-output .cell-output-stdout}
```
Python označevanje
```
:::
:::

Rezultat:

s = "Python označevanje"
print(s)
Python označevanje

Če oznake jezika ne navedemo, se koda sicer še vedno prikaže, vendar navadno brez posebnega barvanja sintakse.

Izvorni zapis:

```
Ni oznake jezika, zato ni označevanja.
Lahko pa napišemo kako <b>oznako</b>.
```

Rezultat:

Ni oznake jezika, zato ni označevanja.
Lahko pa napišemo kako <b>oznako</b>.

V učbeniškem besedilu je priporočljivo, da je pri blokih kode jezik naveden skoraj vedno, saj je koda tako precej preglednejša.

3.9 Preglednice

Preglednice niso del najosnovnejše specifikacije Markdowna, podpirajo pa jih skoraj vsi sodobni prikazovalniki.

Z dvopičji lahko označimo poravnavo stolpcev.

Izvorni zapis:

| Preglednice  |       So       |  Super |
|:-------------|:--------------:|-------:|
| stolpec 3 je | poravnan desno | 1600 € |
| stolpec 2 je |   usredinjen   |   12 € |
| črte         |  so uporabne   |    5 € |

Rezultat:

Preglednice So Super
stolpec 3 je poravnan desno 1600 €
stolpec 2 je usredinjen 12 €
črte so uporabne 5 €

Glavo preglednice označujejo vsaj trije pomišljaji. Navpičnice niso povsem obvezne, a navadno izboljšajo preglednost izvornega zapisa.

Izvorni zapis:

Manj | pregleden | zapis
--- | --- | ---
*prav tako* | `ustvari` | **preglednico**
1 | 2 | 3

Rezultat:

Manj pregleden zapis
prav tako ustvari preglednico
1 2 3

Pri večjih tabelah je včasih smiselno razmisliti tudi o Quarto ali HTML rešitvah, a za krajše preglednice je ta zapis zelo priročen.

3.10 Citati

Citati oziroma navedki se začnejo z znakom >. Primerni so za poudarjene misli, navodila ali kratke povzetke.

Izvorni zapis:

> Citati so primerni za navajanje in jih še najbolj poznamo iz e-pošte.
> To je del istega navedka.

Rezultat:

Citati so primerni za navajanje in jih še najbolj poznamo iz e-pošte. To je del istega navedka.

Besedilo, ki ni označeno z >, se vrne v navaden odstavek.

Tole pa ni navedek.

Izvorni zapis:

> Tole je zelo dolga vrstica, ki pa se bo še vedno pravilno izpisala kot
navedek. Kljub prelomu. Še malo, da bo res dolgo in pravilno izpisano na
vseh širinah zaslonov. In ja, lahko uporabimo *dodatno* **oblikovanje**.

Rezultat:

Tole je zelo dolga vrstica, ki pa se bo še vedno pravilno izpisala kot navedek. Kljub prelomu. Še malo, da bo res dolgo in pravilno izpisano na vseh širinah zaslonov. In ja, lahko uporabimo dodatno oblikovanje.

3.11 Uporaba HTML

Markdown lahko po potrebi dopolnimo tudi z ukazi HTML. To je uporabno takrat, ko želimo nekaj, česar čisti Markdown ne podpira dovolj dobro.

Izvorni zapis:

<dl>
  <dt>Definicija</dt>
  <dd>Včasih se uporablja.</dd>

  <dt>Markdown in HTML</dt>
  <dd>Tole pa *ne* deluje **dobro**. Uporabiti je treba HTML
  <em>oznake</em>.</dd>
</dl>

Rezultat:

Definicija
Včasih se uporablja.
Markdown in HTML
Tole pa ne deluje dobro. Uporabiti je treba HTML oznake.

Pomembno je opaziti, da znotraj nekaterih HTML struktur običajno ne moremo pričakovati, da bo Markdown oblikovanje delovalo povsem enako kot zunaj njih. Zato je v takih primerih praviloma bolje dosledno uporabljati HTML oznake.

3.12 Vodoravne črte

Vodoravne črte ustvarimo s tremi ali več pomišljaji, zvezdicami ali podčrtaji.

Izvorni zapis:

---

***

___

Rezultat:




Tak element je uporaben za ločevanje večjih vsebinskih sklopov, vendar ga ni dobro uporabljati prepogosto.

3.13 Prelomi vrstic in odstavki

Pri Markdownu je dobro razumeti razliko med novo vrstico in novim odstavkom. Najboljši način učenja je pogosto prav preizkušanje različnih zapisov.

Izvorni zapis:

Prva vrstica tako za začetek.

Tale vrstica je od prejšnje ločena z dvema znakoma za novo vrstico in
bo zato prikazana kot poseben odstavek.

Tole je tudi poseben odstavek, ampak ...
Tale vrstica je ločena samo z enim znakom za novo vrstico in je zato
v istem odstavku. Če pa na koncu vrstice vstavimo dva presledka,
kot je tule ...
Potem pa je nadaljevanje nova vrstica v istem odstavku.

Rezultat:

Prva vrstica tako za začetek.

Tale vrstica je od prejšnje ločena z dvema znakoma za novo vrstico in bo zato prikazana kot poseben odstavek.

Tole je tudi poseben odstavek, ampak … Tale vrstica je ločena samo z enim znakom za novo vrstico in je zato v istem odstavku. Če pa na koncu vrstice vstavimo dva presledka, kot je tule …
Potem pa je nadaljevanje nova vrstica v istem odstavku.

V praksi si velja zapomniti:

  • ena prazna vrstica ustvari nov odstavek,
  • en sam prelom vrstice pogosto še ne pomeni novega odstavka,
  • dva končna presledka ustvarita novo vrstico znotraj istega odstavka.

3.14 Matematični izrazi z LaTeX

V Markdown celicah v Jupyter in Quarto lahko pišemo tudi matematične izraze s sintakso, ki temelji na LaTeX.

Za izraz znotraj vrstice uporabimo enojne dolarje:

Pitagorov izrek zapišemo kot $a^2 + b^2 = c^2$.

Rezultat:

Pitagorov izrek zapišemo kot \(a^2 + b^2 = c^2\).

Za samostojen izraz v svoji vrstici uporabimo dvojne dolarje:

$$
\binom{n}{k} = \frac{n!}{k!(n-k)!}
$$

Rezultat:

\[ \binom{n}{k} = \frac{n!}{k!(n-k)!} \]

Nekaj pogostih primerov:

$\frac{\alpha^2}{\beta}$

$$
a_0+\frac{1}{a_1+\frac{1}{a_2+\frac{1}{a_3+\cdots}}}
$$

$$
f(x) = e^{-x}
$$

Rezultat:

\(\frac{\alpha^2}{\beta}\)

\[ a_0+\frac{1}{a_1+\frac{1}{a_2+\frac{1}{a_3+\cdots}}} \]

\[ f(x) = e^{-x} \]

To je posebej uporabno pri statistiki, linearní algebri, optimizaciji in drugih temah, kjer želimo ob kodi zapisati tudi matematično ozadje.

3.15 Youtube video

Videov v osnovnem Markdownu navadno ne vstavljamo neposredno, lahko pa vstavimo sliko s povezavo na video. To je preprost in zelo razširjen pristop.

Izvorni zapis:

[![IMAGE ALT TEXT HERE](http://img.youtube.com/vi/VIDEO_ID/0.jpg)](http://www.youtube.com/watch?v=VIDEO_ID)

Rezultat:

This Will Revolutionize Education

Pri tem je VIDEO_ID oznaka videa. V zgornjem primeru je to GEmuEWjHr5c.

3.16 Praktična priporočila

Ko Markdown uporabljamo v beležnicah, vajah in poglavjih knjige, se dobro obnese nekaj preprostih pravil:

  • vsak večji sklop naj ima jasen naslov,
  • kodo in razlago izmenjujemo v kratkih, preglednih korakih,
  • za nove misli raje začnemo nov odstavek, kot da ročno lomimo vrstice,
  • slike, povezave in preglednice uporabljamo takrat, ko res pomagajo razlagi,
  • pri blokih kode praviloma navedemo jezik,
  • z oblikovanjem ne pretiravamo.

Tak zapis je precej preglednejši kot dolge neprekinjene razlage, hkrati pa omogoča, da beležnica ostane uporabna tudi pozneje, ko jo odpremo znova ali delimo z drugimi.

3.17 Povezava z Quarto

Quarto uporablja Markdown kot osnovni jezik za pisanje poglavij, navodil in poročil. Zato je znanje iz tega poglavja neposredno uporabno tudi pri urejanju te knjige:

  • besedilo poglavij pišemo v .qmd,
  • kodo lahko vključimo kot bloke,
  • razlago, slike in preglednice združimo v enoten dokument,
  • ista osnovna pravila veljajo tako v učbeniškem besedilu kot v spremljevalnih beležnicah.

To je eden od glavnih razlogov, da je Markdown smiseln že zelo zgodaj v knjigi: isti pristop bomo uporabljali skoraj povsod naprej.