Toto je nová verzia môjho blogu. Tá predchádzajúca bola na blog.nepto.sk a postupne budem články odtiaľ presúvať sem.

Posledných 20 rokov bola databáza svätým grálom pre ukladanie dynamického obsahu. Všetky blogy, ktoré som videl, mali svoje články uložené v databáze. Toto nie je zlý spôsob, ale v praxi je trochu nepraktický.

Obsah blogu nie je veľmi dynamický. Mení sa na začiatku, potom už obvykle len leží bez zmeny. Taktiež písanie cez webové rozhranie nie je pre mňa pohodlné. S WYSIWYG editormi sa mi vyslovene zle pracuje.

Preto som sa namiesto tradičného prístupu založeného na databáze rozhodol vybudovať blog pomocou Markdown súborov.

Prečo Markdown súbory?

Tu je zopár praktických dôvodov:

• Rýchle a jednoduché - Editácia s využitím všetkých možností, ktoré ponúka editor ViM
• Priateľské k verziovaniu - Príspevky sú obyčajné textové súbory, dajú sa jednoducho verziovať
• Ľahké písanie - Jasná štruktúra dokumentu, žiadne dizajnové problémy
• Zrozumiteľné pre AI - Veľké jazykové modely (LLM) rozumejú Markdown formátu výnimočne dobre

---

Sprievodca Markdown

Keďže je Markdown pre mňa pomerne nový, pripravil som si v tomto príspevku prehľad s príkladmi všetkých bežných možností formátovania.

Nadpisy

Tvorba nadpisov pomocou symbolov #:

# Nadpis H1
## Nadpis H2
### Nadpis H3

Formátovanie textu

• Tučný text pomocou **tučný** alebo __tučný__
• Kurzíva pomocou *kurzíva* alebo _kurzíva_
• Tučná kurzíva pomocou ***text***
• Prečiarknutý pomocou ~~text~~

Zoznamy

Nečíslované zoznamy

• Položka 1
• Položka 2
  • Podpoložka 2.1
  • Podpoložka 2.2
• Položka 3

Číslované zoznamy

1. Prvá položka
2. Druhá položka
3. Tretia položka

Úlohové zoznamy

• [ ] Nezaškrtnutá úloha
• [x] Zaškrtnutá úloha
• [ ] Ďalšia úloha

Odkazy a obrázky

Odkazy

Vytvorenie odkazov je jednoduché:

Navštívte moju tréningovú sekciu

Obrázok s popisom

Tu je príklad vloženia obrázka s popisom:

Obrázok: Logo z mojej starej webstránky Nepto.sk

Alternatívny text je taktiež podporovaný.

Kód

Inline kód: const blog = new Blog();

Bloky kódu:

<?php
function getBlogPosts($lang) {
    return Blog::getAllPosts($lang);
}

// JavaScript príklad
const posts = await fetch('/blog/api/posts');
const data = await posts.json();

Citácie

Toto je citácia. Môže sa rozkladať cez viacero riadkov.

— Meno autora

Tabuľky

Funkcia	Podporované
Markdown	Áno
Obrázky	Áno
Dvojjazyčnosť	Áno

Horizontálna čiara

---

Záver

Dúfam, že tohto sprievodcu nebudem nikdy potrebovať. Predsa len, Markdown je pomerne jednoduchý. Ale ak by som ho predsa len potreboval, je hneď tu:)