====== Pandoc: univerzální nástroj pro převod dokumentů ======


Pandoc používám jako univerzální převodník mezi různými formáty dokumentů. Umožňuje mi převádět Markdown do PDF, Wordu, HTML nebo wiki formátů, ale také převádět mezi nimi navzájem. Při práci s technickou dokumentací mi nahrazuje celé řetězce jiných nástrojů, protože zvládá desítky formátů z jednoho rozhraní.

===== Moje praktické použití =====

==== Převod Markdown na PDF pomocí WeasyPrint ====

WeasyPrint jsem zvolil, protože ve výsledném PDF zachovává Unicode znaky včetně ikon.

<code bash>
sudo apt install weasyprint
pandoc analyza-rok-2024.md -o analyza-rok-2024.pdf --pdf-engine=weasyprint
</code>

==== Převod Markdown na PDF pomocí XeLaTeX ====

Při použití XeLaTeXu jsem narazil na odstranění UTF znaků. Uvádím příkaz pro kompletnost.

<code bash>
sudo apt install texlive-xetex
pandoc analyza-rok-2024.md -o analyza-rok-2024.pdf --pdf-engine=xelatex
</code>

==== Převod Markdown na Word ====

Převod do Wordu používám pro předávání dokumentů lidem, kteří nepracují s Markdownem.

<code bash>
pandoc vstup.md -o vystup.docx
</code>

==== Převod Markdown do DokuWiki ====

Pro export dokumentace do DokuWiki formátu používám jednoduchý příkaz:

<code bash>
pandoc vstup.md -t dokuwiki -o vystup.txt
</code>

===== Převod mezi dalšími formáty =====

Pandoc jsem využil i mimo Markdown. Nástroj umí pracovat s formáty jako HTML, EPUB, LaTeX, RST nebo ODT. Můžu tak například převádět:

  * HTML → Markdown
  * ODT → Markdown
  * Markdown → EPUB
  * LaTeX → HTML

Pandoc tak používám jako univerzální převodník, který dokáže formátovat výstup, měnit šablony, vkládat metadata a generovat různé typy dokumentů podle potřeby.

===== Shrnutí =====

Pandoc mi poskytuje jednotný způsob práce s dokumenty bez ohledu na zdrojový nebo výsledný formát. Umožňuje mi rychle generovat PDF, Word, wiki formáty nebo e‑knihy a spolehnout se na konzistentní výstup.