Ubah HTML dan halaman web tersimpan menjadi Markdown di Windows

Untuk menyimpan halaman web sebagai Markdown, simpan di Chrome atau Edge dengan Ctrl+S sebagai Halaman Web, Lengkap, lalu tambahkan file HTML ke MD Factory. Aplikasi mengonversi halaman di PC Anda dan menyimpan file Markdown beserta gambar halaman di sampingnya.

Panduan ini untuk halaman yang Anda simpan sendiri: artikel, dokumentasi, resep, halaman referensi. Jika Anda perlu mengonversi HTML dalam skrip atau proses build, langsung ke bagian terakhir.

Tiga tata letak halaman web cetak dengan blok dan garis abu-abu di samping laptop tertutup. — Halaman tersimpan menjadi catatan yang bisa diedit sebagai teks biasa.

Simpan halaman di Chrome atau Edge

Di Chrome, tekan Ctrl+S, atau buka menu Lainnya, pilih Transmisikan, simpan, dan bagikan, lalu Simpan halaman sebagai. Langkah-langkahnya ada di Bantuan Chrome.

Di Edge, tekan Ctrl+S. Pintasan ini tercantum di pintasan keyboard Edge.

Di daftar Simpan sebagai jenis, pilih Halaman Web, Lengkap. Kedua browser menawarkan tiga format, dan MD Factory memperlakukannya secara berbeda:

Simpan sebagai jenis	Yang disimpan browser	Yang Anda dapatkan di MD Factory
Halaman Web, Lengkap	File HTML dan folder dengan nama yang sama berakhiran _files, yang berisi gambar	Teks dan gambar
Halaman Web, Hanya HTML	Hanya file HTML; gambar tetap berada di situs web	Teks tanpa gambar, ditandai Perlu diperiksa
Halaman Web, File Tunggal	Satu file MHTML	Tidak ada: MD Factory tidak membuka file MHTML dan mencantumkannya sebagai dilewati

Konversikan halaman yang tersimpan

Buka MD Factory.
Klik Tambahkan file dan pilih file HTML yang tersimpan, atau seret ke jendela aplikasi.
Konversi langsung dimulai. Saat baris file menampilkan hasilnya, klik dua kali jalur hasil untuk membuka file Markdown.

Tambahkan file HTML, bukan folder tempat file itu berada. Jika Anda menambahkan folder, MD Factory juga memeriksa folder _files: skrip, lembar gaya, dan gambar di dalamnya dicantumkan sebagai dilewati, dan file HTML di dalamnya dikonversi sebagai catatan terpisah.

File Markdown memakai nama halaman dan disimpan di sampingnya. Gambar yang dipakainya disimpan di folder di sebelahnya:

Saved pages/
  Sourdough bread.html
  Sourdough bread_files/
  Sourdough bread.md
  Sourdough bread_images/

Halaman yang tersimpan dan folder _files-nya tetap seperti semula. Jika Anda memindahkan file Markdown, pindahkan juga folder _images-nya: Markdown menautkan gambar ke folder tersebut.

Apa yang terbawa ke Markdown

Di halaman	Di Markdown
Judul	Judul dengan tingkat yang sama
Paragraf, daftar, dan kutipan	Dipertahankan, termasuk teks tebal dan miring
Blok kode dan kode sebaris	Dipertahankan sebagai kode
Tabel	Tabel Markdown
Gambar yang disimpan bersama halaman	Disalin ke folder gambar sebagai file PNG
Tautan	Dipertahankan, seperti dijelaskan di bawah
Skrip, gaya, dan frame tersemat, seperti pemutar video dari situs lain	Dihapus
Menu situs, header, footer, bilah samping, dan pemberitahuan cookie	Dipertahankan sebagai teks dan tautan biasa
Judul di tab browser	Tidak disertakan

Jika tabel memiliki sel judul, baris pertamanya menjadi baris judul tabel Markdown. Jika tidak, aplikasi menambahkan judul kolom bernomor. Sel gabungan disebar di seluruh kisi: nilainya tetap di sel pertama, dan sel yang tercakup dibiarkan kosong.

Gambar mana yang dipertahankan

MD Factory tidak pernah mengunduh apa pun dari internet. Gambar masuk ke Markdown hanya jika file-nya ada di PC Anda:

gambar di folder _files yang dibuat oleh Halaman Web, Lengkap;
gambar di folder lain di sekitar halaman, termasuk folder di atasnya;
gambar yang tersemat di kode HTML itu sendiri.

Gambar yang hanya ada di situs web tidak disertakan, dan file ditandai Perlu diperiksa. Gambar SVG tidak didukung dan juga tidak disertakan.

Cara tautan ditangani

Alamat web lengkap, tautan email, dan tautan telepon tetap persis seperti aslinya.
Tautan relatif, seperti tautan ke halaman lain di situs yang sama, menjadi alamat web lengkap jika halaman yang disimpan mencatat alamat aslinya. Jika tidak, tautan tetap seperti tertulis dan hanya berfungsi jika file yang ditautkan berada di tempat yang sama relatif terhadap file Markdown.
Tautan ke bagian pada halaman yang sama tetap berfungsi, karena bagian-bagian itu mempertahankan jangkarnya di Markdown.
Tautan yang menjalankan skrip saat diklik, yang diawali javascript:, menjadi teks biasa.

Rapikan catatan

MD Factory mengonversi seluruh isi halaman. Aplikasi tidak menebak bagian mana yang merupakan artikel, jadi Anda akan menemukan menu situs di bagian atas serta footer, tautan terkait, dan pemberitahuan cookie di bagian bawah. Hapus yang tidak Anda perlukan.

Judul dari tab browser tidak disertakan. Jika judul artikel itu sendiri tidak ada, tambahkan satu di bagian atas.

Tambahkan alamat halaman dan tanggal Anda menyimpannya sebagai baris pertama catatan. Dengan begitu Anda bisa menemukan sumber aslinya nanti dan menyebutkannya saat mengutip.

Jika Anda menyimpan catatan di Obsidian, panduan kami tentang mengimpor dokumen ke Obsidian membahas cara mengonversi file ke vault dan menjaga gambarnya tetap tertaut.

Jika halaman mendapat status Perlu diperiksa

Perlu diperiksa berarti file Markdown tersimpan, tetapi ada bagian halaman yang tidak ikut terbawa. Setelah antrean selesai, klik status di baris file untuk melihat pesannya.

Pesan	Penyebab yang umum
Gambar atau sumber daya eksternal dilewati.	Gambar hanya ada di situs web, misalnya setelah menyimpan sebagai Halaman Web, Hanya HTML.
Sebuah gambar tidak dapat diekspor.	Halaman merujuk ke file gambar yang tidak ada di folder.
Format gambar tidak didukung.	Gambar berformat yang tidak dapat dikonversi aplikasi, seperti SVG.
Beberapa konten dokumen tidak dapat direpresentasikan dalam Markdown.	Halaman memiliki frame tersemat, seperti pemutar video dari situs lain, dan frame itu dihapus.
Target tautan lokal tidak dapat dipertahankan.	Tautan ke halaman lain di situs tidak dapat dicocokkan dengan alamat web atau file yang tersimpan. Teksnya dipertahankan tanpa tautan.
Pengodean teks disimpulkan. Periksa karakter khusus.	Halaman tidak disimpan dalam UTF-8, jadi aplikasi harus menentukan sendiri pengodeannya. Periksa huruf beraksen dan simbol.

Mengonversi HTML dalam kode

Jika Anda memerlukan HTML ke Markdown dalam skrip, langkah build, atau scraper, MD Factory bukan alat yang tepat: aplikasi ini bekerja lewat jendelanya, tanpa baris perintah atau antarmuka pemrograman. Gunakan pustaka. Turndown mengonversi HTML ke Markdown dalam JavaScript, di Node.js atau di browser, dengan lisensi MIT. html2text melakukan hal yang sama di Python, dengan lisensi GPL-3.0. Pandoc adalah konverter baris perintah antara banyak format dokumen, termasuk HTML dan Markdown. Dengan salah satunya, Anda menetapkan aturan konversi dan menangani gambar serta tautan sendiri.

pandoc -f html -t gfm page.html -o page.md