Parsedown je výkonná PHP knižnica, ktorá umožňuje previesť text napísaný v Markdown formáte na čisté a validné HTML.

V tomto článku sa dozviete všetky jej možnosti – od základov až po pokročilé funkcie s praktickými ukážkami.

---

🧩 Čo je Parsedown?

Parsedown je open-source knižnica vytvorená pre PHP, ktorá dokáže:

• konvertovať .md (Markdown) súbory na HTML,
• pracovať veľmi rýchlo (parsuje cez 1 milión znakov za sekundu),
• podporuje rozšírený Markdown (od verzie Parsedown Extra),
• a funguje bez závislostí – stačí jeden PHP súbor.

---

✍️ Základná syntax Markdow nu

Markdown je jednoduchý textový formát určený na písanie obsahu, ktorý sa dá čítať aj bez HTML.
Nižšie je prehľad najpoužívanejších prvkov a ich prevod Parsedownom.

---

🧱 Nadpisy

V Markdown formáte sa nadpisy označujú mriežkou (#).

# H1 nadpis
## H2 nadpis
### H3 nadpis
#### H4 nadpis

➡️ Výsledok:

H1 nadpis

H2 nadpis

H3 nadpis

H4 nadpis

---

✏️ Tučný, kurzíva a prečiarknutý text

**Tučný text**  
*Kurzíva*  
~~Prečiarknutý~~

➡️ Výsledok:
Tučný text, Kurzíva, Prečiarknutý

---

🔗 Odkazy

[ANTORE web](https://antore.sk)

➡️ Výsledok:
ANTORE web

---

🖼️ Obrázky

V Markdown sa používajú rovnako ako odkazy, ale s výkričníkom na začiatku:

![Popis obrázka](parsedown-kompletny-navod_clanok-2)

➡️ V tvojom systéme sa tento obrázok automaticky načíta z:

blog/img/parsedown-kompletny-navod/clanok-2.jpg (alebo .webp/.png)

---

📋 Zoznamy

Nečíslovaný:

- Prvá položka
- Druhá položka
    - Podpoložka

➡️ Výsledok:

• Prvá položka
• Druhá položka
  • Podpoložka

Číslovaný:

1. Krok jeden
2. Krok dva
3. Krok tri

➡️ Výsledok:

1. Krok jeden
2. Krok dva
3. Krok tri

---

💬 Citáty

> Toto je citát alebo poznámka.
> Môže mať aj viac riadkov.

➡️ Výsledok:

Toto je citát alebo poznámka. Môže mať aj viac riadkov.

---

🧮 Kód a programátorské bloky

Inline kód:

Použi backtick (znak `) pred a za textom:

Toto je `inline kód`.

➡️ Výsledok:
Toto je inline kód.

Viacriadkový kódový blok:

```php
<?php
echo "Ahoj, Parsedown!";
?>

➡️ Výsledok:
```php
<?php
echo "Ahoj, Parsedown!";
?>

---

🧱 Horizontálna čiara (oddelenie sekcií)

---

➡️ Výsledok:

---

---

🧾 Tabuľky (Parsedown Extra)

Ak máš aktívny Parsedown Extra, podporuje aj tabuľky:

| Funkcia | Popis |
|----------|--------|
| **#** | Nadpis |
| **-** | Zoznam |
| **>** | Citát |
| **`** | Kód |

➡️ Výsledok:

Funkcia	Popis
#	Nadpis
-	Zoznam
>	Citát
`	Kód

---

🖼️ Práca s obrázkami v tvojom blog systéme

Parsedown + tvoj systém spolu dokážu automaticky načítať obrázky podľa slug-u článku.

• Titulný obrázok: titulka
• Obrázky v texte: clanok-1, clanok-2, ...
• Galéria: galeria-1, galeria-2, ...
• Wide obrázok: označ v texte alt textom wide

Príklad:

![Titulný obrázok](titulka)
![wide - Veľký obrázok](full)
![gallery - Foto 1](galeria-1)
![gallery - Foto 2](galeria-2)

---

🧠 Príklad použitia v PHP

Ak by si Parsedown chcel použiť samostatne mimo systému:

require 'Parsedown.php';
$Parsedown = new Parsedown();
$html = $Parsedown->text("# Ahoj svet!");
echo $html;

➡️ Výstup:

<h1>Ahoj svet!</h1>

---

🎯 Zhrnutie

Parsedown ti umožní písať články ako obyčajný text, ktorý sa automaticky zmení na profesionálne formátovaný HTML obsah.
Tvoj blog navyše pridáva vlastné rozšírenia – ako galéria, obrázky a automatické zarovnanie.

---