UltKit

HTML-i Markdown-a çevirmək

HTML məzmunun çatdırıldığı formatdır; Markdown isə getdikcə daha çox insanın mətn yazmaq və saxlamaq üçün seçdiyi formatdır. Bu çevirici .html fayllarını oxunaqlı .md mətninə çevirir və beləliklə bloq arxivini, yardım mərkəzini və ya saxlanmış məqaləni statik sayta, qeydlər bazasına və ya Git repozitoriyasına köçürmək mümkün olur.

Sənəd çevirici

və ya PDF, DOC, DOCX … faylları bura sürüşdürün ·

Hər fayl üçün maks. 95 MB· 20 fayla qədər· 30 dəqiqədən sonra silinir

Nəticə

Fayllar serverlərimizdə emal olunur və 30 dəqiqədən sonra silinir.

Bu alətdən necə istifadə etməli

  1. 1

    HTML fayllarını yükləyin

    20-yə qədər .html və ya .htm faylı əlavə edin (hər biri 95 MB-dək). Brauzerdən saxlanmış səhifə, CMS ixracı və ya əllə yazılmış fayl uyğundur.

  2. 2

    Mətn parametrlərini yoxlayın

    Çevriləcək format Markdown, Formatlama Sadə, Mətn kodlaşdırması UTF-8, Sətir sonları isə LF olur. Bu, Git, statik sayt generatorları və macOS ya da Linux redaktorları üçün uyğundur.

  3. 3

    Markdown-a çevirin

    Markdown formatına Çevir düyməsini basın, sonra qalmış menyu və ya altlıqları silmək üçün .md faylını istənilən mətn redaktorunda açın. Yüklənmiş fayllar 30 dəqiqədən sonra silinir.

HTML-i Markdown-a çevirmək üçün .html faylını yükləyin və Markdown formatına Çevir düyməsini basın: başlıqlar # sətirlərinə, linklər mətn formasına çevrilir, siyahılar işarələrini və nömrələrini saxlayır, sadə cədvəllər isə şaquli xətli cədvəllərə çevrilir.

HTML-dən Markdown-a: kimə və nə üçün lazımdır

John Gruber Markdown-u 2004-cü ildə Aaron Swartz-ın əməkdaşlığı ilə, çevrilməzdən əvvəl də təbii oxunan sadə mətnlə vebə yazmaq üsulu kimi təqdim etdi. İyirmi il sonra o, GitHub README-lərinin, Jekyll və Hugo kimi statik sayt generatorlarının, sənəd alətlərinin, Obsidian kimi qeyd tətbiqlərinin və bir çox müasir saytın məzmun qovluqlarının doğma formatıdır.

Bu, adi istiqamətin əksinə sabit bir axın yaradır. Verilənlər bazalı CMS-dən çıxan komandalara illərlə yazıları .md faylları kimi lazımdır. Yazıçılar məqalələri qeyd arxivinə kəsib saxlayır. Developerlər köhnə HTML kömək bölməsini dəyişikliklərin pull request-lərdə yoxlandığı docs-as-code repozitoriyasına köçürür. Hər halda yeganə nüsxə HTML-dir və onu əllə yenidən yazmaq real deyil. Word sənədləri üçün eyni iş DOCX-dən Markdown-a alətidir.

Hansı HTML elementlərinin Markdown qarşılığı var

from ↓ · to →CommonMarkGitHub Flavored Markdown
h1–h6 başlıqlarıh1–h6 başlıqları to CommonMark: yesh1–h6 başlıqları to GitHub Flavored Markdown: yes
Linklər və şəkillərLinklər və şəkillər to CommonMark: yesLinklər və şəkillər to GitHub Flavored Markdown: yes
Siyahılar və sitat bloklarıSiyahılar və sitat blokları to CommonMark: yesSiyahılar və sitat blokları to GitHub Flavored Markdown: yes
Kod və pre bloklarıKod və pre blokları to CommonMark: yesKod və pre blokları to GitHub Flavored Markdown: yes
Sadə cədvəllər– Sadə cədvəllər to CommonMark: noSadə cədvəllər to GitHub Flavored Markdown: yes
Üstüxətli mətn– Üstüxətli mətn to CommonMark: noÜstüxətli mətn to GitHub Flavored Markdown: yes
Birləşdirilmiş cədvəl xanaları– Birləşdirilmiş cədvəl xanaları to CommonMark: no– Birləşdirilmiş cədvəl xanaları to GitHub Flavored Markdown: no
Formalar, video, iframe-lər– Formalar, video, iframe-lər to CommonMark: no– Formalar, video, iframe-lər to GitHub Flavored Markdown: no
supported not offered2014-dən spesifikasiyası olan CommonMark sərt əsasdır; 2017-də spesifikasiyası verilən GitHub Flavored Markdown cədvəllər, üstüxətli mətn və tapşırıq siyahıları əlavə edir. Markdown qarşılığı olmayan hər şey xam HTML kimi qala bilər, hər ikisi buna icazə verir.

HTML-dən Markdown-a çevirmə nəticəsi: nə gözləmək olar

Sinif adları, sətir daxili üslublar, skriptlər və düzülüş div-ləri atılır, çünki Markdown görünüşü yox, mənanı təsvir edir. Qalın və maili mətn ikiqat və tək ulduzcuğa çevrilir, abzas daxilindəki sətir keçidləri birləşdirilir,   kimi simvol varlıqları isə UTF-8-də adi simvollara çevrilir. .md faylının HTML-in ölçüsünün cüzi hissəsi qədər olmasını gözləyin: sözlər qalır, işarələmə gedir.

MifMarkdown istənilən HTML düzülüşünü təkrarlaya bilər.

FaktO, yalnız mətn strukturunu əhatə edir; sütunların, rənglərin və yerləşdirilmiş qutuların Markdown sintaksisi yoxdur, ona görə itirilir və ya xam HTML kimi qalır.

MifÇevrilmiş səhifə olduğu kimi dərc üçün hazırdır.

FaktMenyular, cookie bannerləri və altlıqlar da gəlir; onları qısaldın, sayt generatorunuz tələb edirsə, front matter əlavə edin.

MifMarkdown nəticəsi hər yerdə eyni işləyir.

FaktCədvəllər və üstüxətli mətn GitHub Flavored Markdown renderləyicisi tələb edir; sərt CommonMark alətləri onları adi mətn kimi göstərir.

HTML və Markdown formatları haqqında faktlar

HTML

HyperText Markup Language

HTML vebin işarələmə dilidir, 1990-cı illərin əvvəlində Tim Berners-Lee tərəfindən təsvir edilib və indi WHATWG tərəfindən yaşayan standart kimi idarə olunur. HTML faylı başlıq, abzas, keçid, cədvəl, şəkil və formaları təsvir edir, üslub isə adətən CSS-dən gəlir. Hər brauzer onu göstərir, həmçinin e-poçt şablonlarında və saxlanmış veb səhifələrdə işlənir. Tək HTML faylı çox vaxt xarici şəkil və üslub cədvəllərindən asılıdır, ona görə tək köçürüldükdə pozulmuş görünə bilər.

Sıxılma
–
Şəffaflıq
–
Animasiya
–
İlk dəfə təqdim edilib
1993 · Tim Berners-Lee; maintained by WHATWG
HTML konvertoru

MD

Markdown

Markdown 2004-cü ildə John Gruber tərəfindən yaradılmış yüngül işarələmə sintaksisidir. O, başlıqlar üçün #, vurğu üçün * və siyahılar üçün - kimi sadə mətn simvollarından istifadə edir, bunlar xam mətn kimi oxunaqlı qalır və HTML-ə təmiz çevrilir. README faylları, sənədləşdirmə, vikilər, qeyd tətbiqləri və bir çox statik sayt generatorları üçün standartdır. CommonMark və GitHub Flavored Markdown kimi bir neçə dialekti var, cədvəllər kimi təfərrüatlarda fərqlənirlər. İstənilən mətn redaktoru .md fayllarını aça bilir.

Sıxılma
–
Şəffaflıq
–
Animasiya
–
İlk dəfə təqdim edilib
2004 · John Gruber
MD konvertoru

HTML məzmun onu göstərən yerdən çıxanda Markdown-a çevrilir: statik sayt generatoruna keçən blog, Git əsaslı sənəd repozitoriyasına köçən kömək mərkəzi və ya işarələmədən çox sadə, oxunaqlı mətnin vacib olduğu Obsidian vault-una saxlanan məqalələr.

HTML-dən MD-yə çevirmə haqqında suallar

Saxlanmış veb səhifəni şəkilləri ilə birlikdə çevirmək olarmı?

Çevirici yüklədiyiniz .html faylını oxuyur. Şəkil teqləri səhifənin istifadə etdiyi eyni yollara və ya URL-lərə yönələn Markdown şəkil linklərinə çevrilir, ona görə onlayn yerləşdirilmiş şəkillər işləməyə davam edir. Brauzerin "Səhifəni belə saxla" ilə yaratdığı yerli şəkil qovluğu fayl ilə birlikdə yüklənmir; onu .md faylının yanına kopyalasanız, nisbi yollar yenə uyğun gələcək.

Menyular, yan panellər və altbilgilərlə nə baş verir?

Faylda olan hər şey çevrilir, çünki alət səhifənin hansı hissəsinin məqalə olduğunu bilmir. Təmiz nəticə üçün CMS imkan verirsə, yazını mövzu olmadan saxlayın və ya sonradan Markdown-un yuxarı və aşağısındakı naviqasiya sətirlərini silin.

WordPress yazılarını Hugo və ya Jekyll-ə necə köçürmək olar?

WordPress-in daxili ixracı HTML deyil, XML faylıdır, ona görə hər yazının HTML-ni kod redaktorundan kopyalayıb və ya brauzerdən saxlayıb çevirin. Sonra hər .md faylının əvvəlinə front matter əlavə edin: başlığı, tarixi və teqləri saxlayan, üç tire olan iki sətir arasındakı blok. Hugo da, Jekyll də onu buradan oxuyur.

Niyə bəzi cədvəllər Markdown-da qəribə görünür?

GitHub Flavored Markdown-un əlavə etdiyi Markdown cədvəllərində bir başlıq sətri var və birləşdirilmiş xanalar yoxdur. Sadə HTML cədvəli təmiz çevrilir; colspan, rowspan və ya daxili siyahıları olan cədvəlin Markdown qarşılığı yoxdur, ona görə düzləşdirilir. Markdown xam HTML-ə icazə verir, buna görə düzülüş vacibdirsə, orijinal cədvəli geri yapışdıra bilərsiniz.

Səhifələri süni intellektə və ya axtarış alətlərinə ötürmək üçün Markdown yaxşı formatdırmı?

Çox vaxt bəli. Markdown başlıqlar, siyahılar, linklər və vurğu kimi vacib strukturu saxlayır, atributları, skriptləri və üslubu atır, beləliklə eyni məqalə xeyli qısa və emalı üçün daha təmiz olur. Heç bir işarələmə istəmirsinizsə, HTML-dən TXT-ə alətindən istifadə edin.