Aby zapisać stronę internetową jako Markdown, zapisz ją w Chrome lub Edge skrótem Ctrl+S jako Strona internetowa, kompletna, a potem dodaj plik HTML do MD Factory. Aplikacja konwertuje stronę na Twoim komputerze i zapisuje plik Markdown z obrazami strony obok niego.
Ten poradnik dotyczy stron, które zachowujesz dla siebie: artykułów, dokumentacji, przepisów, stron z materiałami źródłowymi. Jeśli musisz konwertować HTML w skrypcie lub procesie budowania, przejdź do ostatniej sekcji.
Zapisz stronę w Chrome lub Edge
W Chrome naciśnij Ctrl+S albo otwórz menu Więcej, wybierz Przesyłanie, zapisywanie i udostępnianie, a potem Zapisz stronę jako. Kroki opisuje Pomoc Chrome.
W Edge naciśnij Ctrl+S. Skrót jest wymieniony w artykule Skróty klawiaturowe w Edge.
Na liście Zapisz jako typ wybierz Strona internetowa, kompletna. Obie przeglądarki oferują trzy formaty, a MD Factory traktuje je różnie:
| Zapisz jako typ | Co zapisuje przeglądarka | Co otrzymujesz w MD Factory |
|---|---|---|
| Strona internetowa, kompletna | Plik HTML i folder o tej samej nazwie z końcówką _files, w którym są obrazy | Tekst i obrazy |
| Strona internetowa, tylko HTML | Tylko plik HTML; obrazy zostają w witrynie | Tekst bez obrazów, ze statusem Wymaga sprawdzenia |
| Strona internetowa, pojedynczy plik | Jeden plik MHTML | Nic: MD Factory nie otwiera plików MHTML i oznacza je jako pominięte |
Konwersja zapisanej strony
- Otwórz MD Factory.
- Kliknij Dodaj pliki i wybierz zapisany plik HTML albo przeciągnij go do okna.
- Konwersja zaczyna się od razu. Gdy wiersz pokaże wynik, kliknij dwukrotnie ścieżkę wyniku, aby otworzyć plik Markdown.
Dodaj plik HTML, a nie folder, w którym się znajduje. Jeśli dodasz folder, MD Factory przejdzie też przez folder _files: jego skrypty, arkusze stylów i obrazy zostaną oznaczone jako pominięte, a znajdujące się w nim pliki HTML zostaną przekonwertowane jako osobne notatki.
Plik Markdown dostaje nazwę strony i jest zapisywany obok niej. Używane przez niego obrazy trafiają do folderu obok:
Saved pages/
Sourdough bread.html
Sourdough bread_files/
Sourdough bread.md
Sourdough bread_images/Zapisana strona i jej folder _files pozostają bez zmian. Jeśli przenosisz plik Markdown, przenieś razem z nim folder _images: Markdown odwołuje się do obrazów w tym folderze.
Co przechodzi do Markdown
| Na stronie | W pliku Markdown |
|---|---|
| Nagłówki | Nagłówki tego samego poziomu |
| Akapity, listy i cytaty | Zachowane, razem z pogrubieniem i kursywą |
| Bloki kodu i kod w tekście | Zachowane jako kod |
| Tabele | Tabele Markdown |
| Obrazy zapisane ze stroną | Skopiowane do folderu obrazów jako pliki PNG |
| Linki | Zachowane, jak opisano niżej |
| Skrypty, style i osadzone ramki, na przykład odtwarzacze wideo z innych witryn | Usunięte |
| Menu witryny, nagłówki, stopki, panele boczne i komunikaty o plikach cookie | Zachowane jako zwykły tekst i linki |
| Tytuł na karcie przeglądarki | Nieuwzględniony |
Jeśli tabela ma komórki nagłówka, jej pierwszy wiersz staje się nagłówkiem tabeli Markdown. W przeciwnym razie aplikacja dodaje ponumerowane nagłówki kolumn. Scalone komórki są rozłożone na siatce: wartość zostaje w pierwszej komórce, a komórki, które obejmowała, pozostają puste.
Które obrazy są zachowywane
MD Factory niczego nie pobiera z internetu. Obraz trafia do Markdown tylko wtedy, gdy jego plik jest na Twoim komputerze:
- obrazy w folderze _files, który tworzy opcja Strona internetowa, kompletna;
- obrazy w innych folderach wokół strony, także w folderach nad nią;
- obrazy osadzone w samym kodzie HTML.
Obraz, który istnieje tylko w witrynie, jest pomijany, a plik otrzymuje status Wymaga sprawdzenia. Obrazy SVG nie są obsługiwane i też są pomijane.
Jak są obsługiwane linki
- Pełne adresy internetowe, linki e-mail i linki telefoniczne pozostają dokładnie takie, jakie były.
- Linki względne, na przykład link do innej strony tej samej witryny, stają się pełnymi adresami internetowymi, jeśli zapisana strona zawiera swój pierwotny adres. W przeciwnym razie pozostają w zapisanej postaci i działają tylko wtedy, gdy plik, do którego prowadzą, leży w tym samym miejscu względem pliku Markdown.
- Linki do sekcji tej samej strony nadal działają, bo sekcje zachowują w Markdown swoje kotwice.
- Linki, które po kliknięciu uruchamiają skrypt, czyli zaczynające się od javascript:, stają się zwykłym tekstem.
Porządkowanie notatki
MD Factory konwertuje całą treść strony. Nie zgaduje, która część jest artykułem, więc spodziewaj się menu witryny na górze oraz stopki, powiązanych linków i komunikatu o plikach cookie na dole. Usuń to, czego nie potrzebujesz.
Tytuł z karty przeglądarki nie jest uwzględniany. Jeśli brakuje własnego nagłówka artykułu, dodaj go na górze.
Dodaj adres strony i datę jej zapisania jako pierwszy wiersz notatki. Dzięki temu później znajdziesz oryginał i podasz go jako źródło przy cytowaniu.
Jeśli prowadzisz notatki w Obsidian, nasz poradnik importowania dokumentów do Obsidian opisuje konwertowanie plików do sejfu i zachowywanie linków do ich obrazów.
Gdy strona dostaje status Wymaga sprawdzenia
Wymaga sprawdzenia oznacza, że plik Markdown został zapisany, ale coś ze strony nie przeszło do wyniku. Gdy kolejka się skończy, kliknij status w wierszu pliku, aby zobaczyć komunikat.
| Komunikat | Zwykła przyczyna |
|---|---|
| Pominięto obraz zewnętrzny lub zasób. | Obraz jest tylko w witrynie, na przykład po zapisaniu jako Strona internetowa, tylko HTML. |
| Nie można wyeksportować obrazu. | Strona wskazuje plik obrazu, którego brakuje w folderze. |
| Format obrazu nie jest obsługiwany. | Obraz ma format, którego aplikacja nie potrafi przekonwertować, na przykład SVG. |
| Niektóre treści dokumentów nie mogły być reprezentowane w Markdown. | Strona miała osadzoną ramkę, na przykład odtwarzacz wideo z innej witryny, i została ona usunięta. |
| Nie można zachować celu łącza lokalnego. | Linku do innej strony witryny nie udało się dopasować do adresu internetowego ani zapisanego pliku. Jego tekst zostaje bez linku. |
| Wywnioskowano kodowanie tekstu. Sprawdź znaki specjalne. | Strona nie jest zapisana w UTF-8, więc aplikacja musiała ustalić jej kodowanie. Sprawdź litery z akcentami i symbole. |
Konwersja HTML w kodzie
Jeśli potrzebujesz konwersji HTML na Markdown w skrypcie, kroku budowania lub scraperze, MD Factory nie jest właściwym narzędziem: działa przez swoje okno, bez wiersza poleceń i interfejsu programistycznego. Użyj biblioteki. Turndown konwertuje HTML na Markdown w JavaScript, w Node.js lub w przeglądarce, na licencji MIT. html2text robi to samo w Pythonie, na licencji GPL-3.0. Pandoc to konwerter wiersza poleceń między wieloma formatami dokumentów, w tym HTML i Markdown. W każdym z tych narzędzi samodzielnie ustawiasz reguły konwersji i obsługujesz obrazy oraz linki.
pandoc -f html -t gfm page.html -o page.md