Dəyişdir DOC üçün Markdown

Dəyişdir DOC üçün Markdown sənədləri asanlıqla oxuya bilər

Fayllarınızı seçin

*Fayllar 24 saatdan sonra silinir

1 GB-a qədər faylı pulsuz çevirin, Pro istifadəçiləri 100 GB-a qədər faylı çevirə bilərlər; İndi qeydiyyatdan keçin

Yüklənir

Necə çevirmək olar DOC üçün Markdown

Addım 1: Yükləyin DOC yuxarıdakı düymədən istifadə edərək və ya sürükləyib buraxaraq fayllara köçürə bilərsiniz.

Addım 2: Dönüşümə başlamaq üçün 'Çevir' düyməsini basın.

Addım 3: Çevirilmiş faylınızı yükləyin Markdown fayllar

DOC üçün Markdown Dəyişdir

DOC-i Markdown-ə necə çevirə bilərəm?

DOC yükləyin və konvertor onun quruluşunu Markdown sintaksına uyğunlaşdırır: başlıqlar `#` səviyyələrinə, qalın/itişlilər `**`/`*`-a, siyahılar `-`/`1.`-a, və körpülər `[text](url)`-a çevrilir. Nəticədə README, statik sayt yazısı, wiki, ya da Markdown redaktoruna atıla bilən portativ sadə mətn Markdown əldə olunur.

DOC-dən başlıqlar və siyahılar Markdown sintaksına uyğunlaşdırılacaqmı?

Bəli - DOC-də başlıq səviyyələri uyğun `#` xarakter sayına çevirilir, və qurğulanmış / nömrəli / cücərmiş siyahılar düzgün enlikli `-` və `1.` işarələrinə çevirilir. Markdown sənədin strukturunu qoruyur, buna görə də strukturu sadə mətn kimi oxuna bilər.

DOC-dən cədvəllər Markdown-də necə təmsil olunur?

Cədvəllər GitHub, GitLab və bir çox statik sayt generatorlarında düzgün göstərilən GitHub-Flavored Markdown boru cədvəllərinə ('| col | col |' və '---' ayırıcı sətir) çevrilir. Markdown'un sadə şəbəkəsini aşan çox geniş və ya birləşdirilmiş hüceyrəli cədvəllər Markdown'un birləşdirilmiş hüceyrəli sintaksisi olmadığından sadələşdirilir.

DOC-i Markdown-ə çevirdikdə rəsmlərə nə baş verir?

DOC-dən daxil edilmiş rəsmlər qovluğa çıxarılır və Markdown-də '![alt](path)' sintaksisi ilə istinad edilir, Markdown real rəsm fayllarına işarə edir. Əgər rəsmlər artıq onlayn olaraq saxlanılırsa, mütləq URL-ləri saxlamağı seçə bilərsiniz.

DOC-dən Markdown-ə YAML ön-maddəsi əlavə edilməlidirmi?

İmkanlı olaraq — konvertor DOC-in metaməlumatından Markdown-nin üstünə YAML ön-maddələr bloku ('---' başlıq / müəllif / tarix '---') çıxara bilər, bu Jekyll, Hugo və digər statik sayt generatorlarının gözlədiyidir. Təmiz bədənli Markdown üçün bunu söndürün.

Markdown ATX ('#') ya da Setext başlıqlarını istifadə edəcəkmi?

Markdown ön qurğulu olaraq ATX-style `#` başlıqlarını istifadə edir - hər Markdown tərzi ilə işləyən və bütün altı başlıq səviyyələrinə ölçülən müasir, geniş dəstəklənən konvensiya. Setext (alt çizgili) başlıqlar yalnız iki səviyyəni dəstəkləyir, buna görə ATX daha təhlükəsiz, daha portativ seçimdir.

DOC və Markdown arasında körpülər və alt notlar qorunur?

Hyperlinklər sətir içi `[text](url)` bağlantıları olur və DOC-in həqiqəti göstərdiyi yerlərdə, onlar genişləndirməni dəstəkləyən platformalarda düzgün göstərilən `[^1]' istinad-stil bağlantılara çevrilir. Sərt superscript bağlantıları sətir içi mətn kimi saxlanılır.

GitHub README və ya wiki üçün DOC-i Markdown-ə çevirə bilərəmmi?

Bəli — çıxarış GitHub-Flavored Markdown-dur, buna görə də README, wiki səhifəsi, problem, ya da GitHub və GitLab-da PR təsviri kimi düzgün göstərilir. Markdown-i yapışdırdığınızda və ya göndərdiyinizdə boru cədvəlləri, iş siyahıları, çərçivəli kod blokları və `#` başlıqlar bütün istənilən kimi göstərilir.

Dəyişdirmə zamanı DOC-im şəxsidir?

Bəli — yüklənmiş DOC fayllar izolyasiya olunmuş işçilərdə işlənir və dəqiqələr içində silinir. Biz heç vaxt məzmunu oxumuruq, saxlamırıq və ya paylaşmırıq. /privacy/-ə baxın.

Niyə Markdown-də HTML təqvimləri qarışıqdır?

Markdown zəngin sənədin hər xüsusiyyətini (rəngli mətn, mürəkkəb cədvəllər, mətn qutuları) ifadə edə bilməz, buna görə də çevirici bu hissələri atmaq əvəzinə içəridə HTML-ə geri dönür - Markdown daxili HTML-i qəbul edir. Əgər Markdown-ni təmizləmək istəyirsinizsə, DOC-də əvvəlcə formatlamanı sadələşdirin, ya da "strip HTML fallback" seçimini fəallaşdırın.

DOC və Markdown kod bloklarını idarə edir?

Bəli - DOC-də monospaced / əvvəlcədən formatlaşdırılmış mətn Markdown-də bir qapalı ``'code block``'' olur, boşluqları qoruyaraq və sintaksis işıqlandırması üçün dil məsləhətini aşkar edə bilər. Bu texniki sənədləri və dərslikləri Markdown-a çevirərkən vacibdir.

Hugo və ya Jekyll kimi statik sayt generatoru üçün DOC-i Markdown-ə çevirə bilərəmmi?

Bəli — YAML ön-maddəsi fəallaşdırın və Markdown `content/` ya da `_posts/` qovluğuna atmağa hazır çıxacaq: başlıq və tarix ön-maddədə, bədən Markdown olaraq təmiz, şəkillər qovluqda. Konvertator Hugo, Jekyll, Eleventy və Gatsby'nin gözlədiyi şəkli hədəfləyir.