Konwerter Markdown

Obsługuje dwukierunkową konwersję między Markdown i HTML z renderowaniem podglądu w czasie rzeczywistym. Obsługuje rozszerzoną składnię GFM, podświetlanie kodu, formuły matematyczne KaTeX i diagramy Mermaid, odpowiednie do pisania dokumentów, publikowania blogów i generowania tekstu sformatowanego dla e-maili.

Instrukcja użycia

🚀 Szybki start

Wklej treść do lewego pola wejściowego.
Wybierz tryb konwersji (→ HTML lub → Markdown).
Konwersja odbywa się automatycznie; po prawej zobaczysz wynik.
Podgląd/HTML: przy konwersji Markdown → HTML domyślnie renderowane są wzory i diagramy (KaTeX/Mermaid).

📌 Typowe scenariusze

Podgląd bloga/dokumentacji: szybka weryfikacja wyglądu Markdown i kolorystyki.
E‑maile HTML: wyeksportuj HTML i wklej do treści wiadomości (dla lepszej kompatybilności używaj stylów inline).
Rich text → Markdown: wyczyść treść z edytora RTF/strony WWW i zamień ją na wersjonowalny Markdown.
Teksty techniczne: dokumenty z wzorami/diagramami – szybkie renderowanie i eksport.
Migracja edytorów: porównuj różne dialekty Markdown i dostosowuj składnię.
Wiki/bazy wiedzy: konwertuj strony HTML na Markdown przed importem do platformy.
Rejestry zmian API: z HTML/opisu do Markdown, aby ułatwić code‑review i PR‑y.

🎛️ Parametry konwersji i renderowania

Przy trybie Markdown → HTML KaTeX/Mermaid są renderowane automatycznie.
Przy trybie HTML → Markdown narzędzie zachowuje/odtwarza kod, nie renderuje ponownie.
Domyślnie wspierany jest GFM (tabele/listy zadań); dla kompatybilności z innymi silnikami używaj możliwie standardowej składni.
Narzędzie domyślnie traktuje pojedyncze nowe linie jako podziały w akapicie; dla zachowania pełnej kontroli używaj pustych linii między akapitami lub dwóch spacji na końcu linii (miękki enter).
Bardzo duże dokumenty mogą spowodować włączenie trybu uproszczonego (ograniczone renderowanie/podświetlanie).

🧭 Wskazówki użycia

E‑maile: preferuj style inline, aby zwiększyć szanse poprawnego wyświetlania w klientach pocztowych.
Długie dokumenty mogą obciążać przeglądarkę; rozważ dzielenie treści na mniejsze części.

⚠️ Ograniczenia i kompatybilność

Dialekty: różne platformy renderują Markdown inaczej; staraj się trzymać konwencji najbliższej docelowemu silnikowi.
HTML → Markdown stara się jak najlepiej zachować strukturę, ale część informacji o stylach i layoutach może zostać utracona.
Przy HTML → Markdown część tagów/atrybutów (script/style/meta, formularze, zdarzenia on*, style/class itd.) może zostać usunięta.
Złożone tabele/zagnieżdżone struktury mogą zostać uproszczone – przejrzyj wynik ręcznie.
Obrazy/wideo pozostają jako linki zewnętrzne; pliki nie są pobierane.
Diagramy Mermaid wygenerowane przez inne narzędzia (bez oryginalnego źródła) nie zawsze da się odtworzyć.

🔒 Prywatność i bezpieczeństwo

Całe przetwarzanie odbywa się w Twojej przeglądarce; dane nie opuszczają Twojego urządzenia.
Wklejone skrypty <script> nie są wykonywane.
Wzory i diagramy renderowane są z użyciem bezpiecznych konfiguracji (KaTeX/Mermaid).
Narzędzie nie usuwa automatycznie wszystkich tagów/atrybutów HTML – przed publikacją samodzielnie zweryfikuj wynik.

❓ Najczęstsze pytania

Podgląd w narzędziu różni się od docelowej platformy – jak to zdiagnozować?

Ustal, jakiego dialektu używa cel (CommonMark/GFM/własne rozszerzenia); unikaj zależności od specyficznych rozszerzeń i surowego HTML; stosuj standardowe reguły dla łamań linii (puste linie lub dwa odstępy na końcu). Przygotuj minimalny przykład i przetestuj go bezpośrednio na docelowej platformie.

Jak zadbać o bezpieczeństwo HTML w produkcji?

Narzędzie nie wykonuje skryptów <script>, ale też nie czyści automatycznie wszystkich tagów/atrybutów. Po stronie serwera lub w pipeline publikacji stosuj bibliotekę typu DOMPurify z białą listą, a także odpowiednią politykę CSP, aby blokować niebezpieczne protokoły, zdarzenia on* i zasoby zewnętrzne.

Struktura HTML → Markdown jest zbyt uproszczona – co robić?

Zalecamy: 1) upraszczanie głęboko zagnieżdżonych tabel/list do prostszych form (tabele z |, płaskie listy); 2) przed konwersją wykonać „wklej jako tekst” i usunąć resztki znaczników span/style/class; 3) zbudować minimalny przykład problematycznej sekcji i stopniowo go upraszczać.

Jakie są ograniczenia KaTeX/Mermaid i jak diagnozować problemy?

Składnia: KaTeX używa $$…$$ / $…$ (inline), Mermaid bloków ```mermaid. Zbyt wiele elementów może włączyć tryb uproszczony (brak podświetlania/ograniczone renderowanie). Dla diagnostyki używaj małych przykładów; dla odzyskiwania wyników pamiętaj, że KaTeX przy odpowiedniej konfiguracji można odtworzyć z HTML, natomiast Mermaid tylko wtedy, gdy zachowano źródłowy kod.