Konwerter HTML na Markdown

Witamy w naszym konwerterze HTML na Markdown, darmowym narzędziu online, które przekształca znaczki HTML na czystą, czytelną składnię Markdown. Niezależnie od tego, czy migrujesz treści z systemu CMS na stronę statyczną, piszesz dokumentację, przygotowujesz pliki README czy konwertujesz posty na blogu dla platform takich jak GitHub czy Jekyll, ten konwerter precyzyjnie obsługuje nagłówki, linki, obrazy, tabele, bloki kodu, listy i wiele więcej.

Co to jest Markdown?

Markdown to lekki język znaczników stworzony przez Johna Grubera w 2004 roku. Używa prostych konwencji formatowania zwykłego tekstu, takich jak # Nagłówek, **pogrubienie**, - element listy i [link](url), aby tworzyć uporządkowane dokumenty, które są łatwe do odczytania w ich surowej formie i mogą być konwertowane na HTML do wyświetlania w Internecie. Markdown jest standardowym formatem plików README, dokumentacji programistycznej, blogów, forów i aplikacji do robienia notatek.

Dlaczego warto konwertować HTML na Markdown?

1. Migracja treści

Przenoszenie treści z WordPressa, Dupala lub innych platform CMS opartych na HTML do generatorów stron statycznych, takich jak Jekyll, Hugo czy Gatsby, wymaga konwersji HTML na Markdown. To narzędzie automatyzuje ten proces.

2. Dokumentacja

Dokumentacja programistyczna na GitHub, GitLab i Bitbucket używa Markdown. Konwersja istniejących dokumentów HTML na Markdown ułatwia ich utrzymanie, kontrolę wersji i współpracę.

3. Czytelność

Markdown jest znacznie bardziej czytelny niż HTML w swojej surowej formie. Konwersja HTML na Markdown ułatwia ludziom skanowanie, edycję i przeglądanie treści bez konieczności zajmowania się nawiasami ostrokątnymi i tagami zamykającymi.

4. Przenośność

Pliki Markdown działają na setkach platform i narzędzi. Konwertując HTML na Markdown, Twoja treść staje się przenośna i odporna na przyszłość.

Obsługiwane elementy HTML

Jak korzystać z tego narzędzia

1. Wklej swój HTML: Skopiuj i wklej treść HTML, którą chcesz przekonwertować, do edytora po lewej stronie. Możesz także kliknąć szybki przykład, aby zobaczyć, jak to działa.
2. Skonfiguruj opcje: Wybierz preferowany styl nagłówka (ATX lub Setext), znacznik listy (- lub *) oraz styl bloku kodu (backticki lub tyldy).
3. Wyświetl wynik Markdown: Przekonwertowany Markdown pojawia się natychmiast w prawym panelu podczas pisania.
4. Skopiuj lub pobierz: Kliknij Kopiuj, aby skopiować Markdown do schowka, lub Pobierz, aby zapisać go jako plik .md. Możesz także przełączyć podgląd na żywo, aby zobaczyć, jak renderuje się Markdown.

Opcje stylu linku

W linii (domyślny)

Styl w linii umieszcza adres linku bezpośrednio obok tekstu linku, jak w [tekst](url). Tytuł linku, jeśli jest obecny w HTML, zostaje zapisany w cudzysłowie za adresem.

Referencyjne

Styl referencyjny zapisuje tekst linku jako [tekst][1] i zbiera każdy adres na numerowanej liście na końcu wyniku Markdown, jak w [1]: url. Dzięki temu długie adresy URL nie zaśmiecają treści artykułu, co jest przydatne przy długich tekstach.

Opcje stylu nagłówka

Styl ATX (domyślny)

Styl ATX używa symboli hash (#) przed tekstem nagłówka. Obsługuje wszystkie sześć poziomów nagłówków i jest najczęściej używanym stylem w nowoczesnym Markdown:

# Nagłówek 1 | ## Nagłówek 2 | ### Nagłówek 3

Jak obliczana jest kompresja

Wskaźnik Kompresja porównuje długość wyniku Markdown z długością wejściowego HTML, obie liczone w znakach. Jest obliczany jako 100% minus (znaki Markdown podzielone przez znaki HTML), zaokrąglony do najbliższego pełnego procenta. Na przykład, jeśli Twój HTML ma 1000 znaków, a Markdown 600 znaków, kompresja pokazuje 40%. Wyższa liczba oznacza, że Markdown jest krótszy niż HTML; liczba ujemna oznacza, że Markdown jest dłuższy.

Styl Setext

Styl Setext używa podkreśleń pod tekstem nagłówka. Obsługuje tylko h1 i h2 (h3-h6 wracają do ATX). Niektórzy autorzy wolą go dla nagłówków najwyższego poziomu ze względu na wizualne podkreślenie w surowym Markdown.

Typowe przypadki użycia

Migracja CMS

Migracja treści bloga z WordPressa, Ghosta lub Squarespace na platformy oparte na Markdown, takie jak Hugo, Jekyll, Gatsby czy Next.js. Wklej źródło HTML i uzyskaj czysty Markdown gotowy dla swojej nowej strony.

Pliki README na GitHub

Konwersja dokumentacji HTML lub makiet projektowych na Markdown dla repozytoriów GitHub. Konwerter obsługuje tabele, bloki kodu i listy zagnieżdżone, które obsługuje GitHub Flavored Markdown.

E-mail do dokumentacji

Konwersja treści wiadomości e-mail HTML lub treści stron internetowych na format Markdown dla wewnętrznych wiki dokumentacyjnych lub baz wiedzy.

Robienie notatek

Konwersja treści internetowych na Markdown dla aplikacji takich jak Obsidian, Notion, Bear czy Typora. Notatki w Markdown są przenośne i odporne na przyszłość.

Wskazówki dla uzyskania najlepszych wyników

Najpierw wyczyść HTML

Aby uzyskać najlepsze wyniki, używaj czystego kodu HTML bez nadmiernych stylów w linii. Konwerter skupia się na semantycznej strukturze HTML, więc usunięcie niepotrzebnych atrybutów style i class daje czystszy wynik.

Sprawdź wyrównanie tabeli

Złożone tabele HTML z połączonymi komórkami (colspan/rowspan) mogą nie konwertować się idealnie, ponieważ tabele Markdown nie obsługują łączenia komórek. Proste tabele konwertują się dokładnie.

Listy zagnieżdżone

Konwerter poprawnie obsługuje listy zagnieżdżone z odpowiednim wcięciem. Jeśli Twój HTML ma głęboko zagnieżdżone listy, sprawdź wynik, aby upewnić się, że zagnieżdżenie odpowiada Twoim oczekiwaniom.

Najczęściej zadawane pytania

Co to jest konwerter HTML na Markdown?

Konwerter HTML na Markdown to narzędzie online, które przekształca znaczki HTML na równoważną składnię Markdown. Konwertuje tagi HTML, takie jak nagłówki, pogrubienie, kursywa, linki, obrazy, listy, tabele i bloki kodu, na ich odpowiedniki w formacie Markdown, tworząc czystą i czytelną treść w formacie czystego tekstu.

Czy moja zawartość HTML jest bezpieczna podczas korzystania z tego konwertera?

Tak, całkowicie bezpieczna. Cała konwersja HTML na Markdown odbywa się całkowicie w Twojej przeglądarce przy użyciu JavaScript po stronie klienta. Twoja treść nigdy nie jest wysyłana na żaden serwer, przechowywana ani przesyłana. Twój kod HTML pozostaje całkowicie prywatny.

Jakie elementy HTML obsługuje ten konwerter?

Ten konwerter obsługuje wszystkie typowe elementy HTML, w tym nagłówki (h1-h6), akapity, pogrubienie, kursywę, przekreślenie, linki, obrazy, listy uporządkowane i nieuporządkowane, listy zagnieżdżone, tabele, bloki kodu, kod w linii, cytaty blokowe, linie poziome, podziały linii i tekst preformatowany.

Jaka jest różnica między stylami nagłówków ATX i Setext?

Styl ATX używa symboli hash przed tekstem nagłówka (np. ## Nagłówek 2), podczas gdy styl Setext używa podkreśleń pod tekstem nagłówka (np. linia myślników dla h2). ATX obsługuje wszystkie sześć poziomów nagłówków (h1-h6), podczas gdy Setext obsługuje tylko h1 i h2. ATX jest częściej używany w nowoczesnym Markdown.

Czy mogę konwertować tabele HTML na Markdown?

Tak. Ten konwerter obsługuje tabele HTML i konwertuje je na składnię tabel GitHub Flavored Markdown (GFM) z odpowiednim wyrównaniem kolumn za pomocą pionowych kresek i myślników. Poprawnie obsługuje elementy thead, tbody, th i td.

Dodatkowe zasoby

• Przewodnik po GitHub Flavored Markdown