Bir web sayfasını Markdown olarak kaydetmek için sayfayı Chrome veya Edge’de Ctrl+S ile Web Sayfası, Tamamı olarak kaydedin, ardından HTML dosyasını MD Factory’ye ekleyin. Uygulama sayfayı bilgisayarınızda dönüştürür ve yanına, sayfanın görselleriyle birlikte bir Markdown dosyası kaydeder.
Bu rehber kendiniz için sakladığınız sayfalara yöneliktir: makaleler, belgeler, tarifler, başvuru sayfaları. HTML’yi bir betikte veya derlemede dönüştürmeniz gerekiyorsa son bölüme geçin.
Sayfayı Chrome veya Edge’de kaydedin
Chrome’da Ctrl+S tuşlarına basın ya da Daha fazla menüsünü açıp Yayınla, kaydet ve paylaş’ı, ardından Sayfayı farklı kaydet’i seçin. Adımlar şu sayfada anlatılıyor: Chrome Yardım.
Edge’de Ctrl+S tuşlarına basın. Kısayol şu sayfada listelenir: Edge klavye kısayolları.
Kayıt türü listesinde Web Sayfası, Tamamı’nı seçin. İki tarayıcı da üç biçim sunar ve MD Factory bunlara farklı davranır:
| Kayıt türü | Tarayıcı neyi kaydeder | MD Factory’de ne elde edersiniz |
|---|---|---|
| Web Sayfası, Tamamı | Bir HTML dosyası ve görselleri içeren, aynı ada sahip ve _files ile biten bir klasör | Metin ve görseller |
| Web Sayfası, Yalnızca HTML | Yalnızca HTML dosyası; görseller web sitesinde kalır | Görselsiz metin, İnceleme gerekiyor olarak işaretlenir |
| Web Sayfası, Tek Dosya | Tek bir MHTML dosyası | Hiçbir şey: MD Factory MHTML dosyalarını açmaz ve atlanmış olarak listeler |
Kaydedilen sayfayı dönüştürün
- MD Factory’yi açın.
- Dosya ekle’ye tıklayıp kaydedilmiş HTML dosyasını seçin ya da pencereye sürükleyin.
- Dönüştürme hemen başlar. Satırda sonuç göründüğünde Markdown dosyasını açmak için sonuç yoluna çift tıklayın.
Dosyanın bulunduğu klasörü değil HTML dosyasını ekleyin. Klasörü eklerseniz MD Factory _files klasörünü de tarar: içindeki betikler, stil sayfaları ve görseller atlanmış olarak listelenir, içindeki HTML dosyaları ise ayrı notlar olarak dönüştürülür.
Markdown dosyası sayfanın adını alır ve onun yanına kaydedilir. Kullandığı görseller yanındaki bir klasöre konur:
Saved pages/
Sourdough bread.html
Sourdough bread_files/
Sourdough bread.md
Sourdough bread_images/Kaydedilmiş sayfa ve _files klasörü olduğu gibi kalır. Markdown dosyasını taşırsanız _images klasörünü de onunla birlikte taşıyın: Markdown, resimlere bu klasörden bağlanır.
Markdown’a neler aktarılır
| Sayfada | Markdown’da |
|---|---|
| Başlıklar | Aynı düzeydeki başlıklar |
| Paragraflar, listeler ve alıntılar | Kalın ve italik metinle birlikte korunur |
| Kod blokları ve satır içi kod | Kod olarak korunur |
| Tablolar | Markdown tabloları |
| Sayfayla birlikte kaydedilen görseller | PNG dosyaları olarak görsel klasörüne kopyalanır |
| Bağlantılar | Korunur, aşağıda anlatıldığı gibi |
| Betikler, stiller ve başka sitelerden video oynatıcıları gibi gömülü çerçeveler | Kaldırılır |
| Site menüleri, üst bilgiler, alt bilgiler, kenar çubukları ve çerez bildirimleri | Sıradan metin ve bağlantılar olarak korunur |
| Tarayıcı sekmesindeki başlık | Dâhil edilmez |
Bir tablonun başlık hücreleri varsa ilk satırı Markdown tablosunun başlığı olur. Yoksa uygulama numaralı sütun başlıkları ekler. Birleştirilmiş hücreler ızgaraya yayılır: değer ilk hücrede kalır, kapsadığı hücreler boş bırakılır.
Hangi görseller korunur
MD Factory internetten hiçbir şey indirmez. Bir görsel Markdown’a yalnızca dosyası bilgisayarınızdaysa girer:
- Web Sayfası, Tamamı seçeneğinin oluşturduğu _files klasöründeki görseller;
- sayfanın çevresindeki diğer klasörlerdeki, üstündeki klasörler dâhil, görseller;
- HTML kodunun kendisine gömülü görseller.
Yalnızca web sitesinde bulunan bir görsel dışarıda bırakılır ve dosya İnceleme gerekiyor olarak işaretlenir. SVG görseller desteklenmez ve onlar da dışarıda bırakılır.
Bağlantılar nasıl ele alınır
- Tam web adresleri, e-posta bağlantıları ve telefon bağlantıları olduğu gibi kalır.
- Aynı sitenin başka bir sayfasına verilen bağlantı gibi göreli bağlantılar, kaydedilen sayfa özgün adresini kaydetmişse tam web adreslerine dönüşür. Aksi halde yazıldıkları gibi kalır ve yalnızca bağlantı verilen dosya Markdown dosyasına göre aynı yerdeyse çalışır.
- Aynı sayfanın bir bölümüne verilen bağlantılar çalışmaya devam eder, çünkü bölümler Markdown’da çapalarını korur.
- Tıklandığında betik çalıştıran, javascript: ile başlayan bağlantılar düz metne dönüşür.
Notu temizleyin
MD Factory sayfanın gövdesinin tamamını dönüştürür. Hangi bölümün makale olduğunu tahmin etmez; bu yüzden üstte site menüsünü, altta ise alt bilgiyi, ilgili bağlantıları ve çerez bildirimini bekleyin. İhtiyacınız olmayanları silin.
Tarayıcı sekmesindeki başlık dâhil edilmez. Makalenin kendi başlığı yoksa en üste bir başlık ekleyin.
Sayfanın adresini ve kaydettiğiniz tarihi notun ilk satırı olarak ekleyin. Böylece orijinali daha sonra bulabilir ve alıntı yaparken kaynak gösterebilirsiniz.
Notlarınızı Obsidian’da tutuyorsanız belgeleri Obsidian’a aktarma rehberimiz dosyaların bir kasaya dönüştürülmesini ve görsellerinin bağlantılı tutulmasını anlatır.
Sayfa İnceleme gerekiyor alırsa
İnceleme gerekiyor, Markdown dosyasının kaydedildiği ama sayfadaki bir şeyin aktarılmadığı anlamına gelir. Kuyruk bittiğinde iletiyi görmek için dosyanın satırındaki duruma tıklayın.
| İleti | Olağan neden |
|---|---|
| Harici bir resim veya kaynak atlandı. | Bir görsel yalnızca web sitesinde bulunuyor, örneğin sayfa Web Sayfası, Yalnızca HTML olarak kaydedildiğinde. |
| Bir resim dışa aktarılamadı. | Sayfa, klasörde bulunmayan bir görsel dosyasına işaret ediyor. |
| Bir resim formatı desteklenmiyor. | Görsel, SVG gibi uygulamanın dönüştüremediği bir biçimde. |
| Bazı belge içerikleri Markdown’da temsil edilemedi. | Sayfada başka bir siteden video oynatıcı gibi gömülü bir çerçeve vardı ve kaldırıldı. |
| Yerel bağlantı hedefi korunamadı. | Sitenin başka bir sayfasına verilen bir bağlantı, bir web adresiyle veya kaydedilmiş bir dosyayla eşleştirilemedi. Bağlantının metni, bağlantı olmadan korunur. |
| Metin kodlaması anlaşıldı. Özel karakterleri kontrol edin. | Sayfa UTF-8 olarak kaydedilmemiş, bu yüzden uygulama kodlamasını kendisi çıkarmak zorunda kaldı. Aksanlı harfleri ve simgeleri kontrol edin. |
HTML’yi kodla dönüştürme
HTML’den Markdown’a dönüştürmeye bir betikte, bir derleme adımında veya bir veri kazıyıcıda ihtiyacınız varsa MD Factory doğru araç değildir: pencere üzerinden çalışır, komut satırı veya programlama arayüzü yoktur. Bunun yerine bir kütüphane kullanın. Turndown HTML’yi JavaScript’te, Node.js’te veya tarayıcıda, MIT lisansı altında Markdown’a dönüştürür. html2text aynı işi Python’da, GPL-3.0 altında yapar. Pandoc HTML ve Markdown dâhil pek çok belge biçimi arasında dönüştürme yapan bir komut satırı dönüştürücüsüdür. Bunlardan herhangi biriyle dönüştürme kurallarını belirler, görselleri ve bağlantıları kendiniz ele alırsınız.
pandoc -f html -t gfm page.html -o page.md