DOCX-i Markdown-a çevirmək
Sənədləri Word-dən Git repozitoriyasına köçürmək hər .docx faylını Markdown-a çevirməklə başlayır. Bu çevirici # başlıqları, boru (|) cədvəlləri və şəkil linkləri olan, CommonMark üslubunda, commit üçün hazır mətn yaradır.
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
Fayllar serverlərimizdə emal olunur və 30 dəqiqədən sonra silinir.
150 DPI A4 səhifəsini təxminən 1240 × 1754 px edir. Çap üçün 300 istifadə edin.
Bütün faylı və ya yalnız bəzi səhifələri, yaxud slaydları çevirin (PDF və təqdimat girişi).
Çevriləcək səhifələr və ya slaydlar, məsələn 1-3, 5, 8-10.
UTF-8 bütün dillər üçün işləyir. Windows-da Excel və ya Notepad pozulmuş simvollar göstərirsə, BOM ilə UTF-8 seçin; köhnə kodlaşdırmalar yalnız köhnə proqramlar üçündür.
LF macOS, Linux və kod redaktorları üçündür; CRLF klassik Notepad kimi köhnə Windows proqramları üçündür.
Standart vergüldür. Onluq hissəni vergüllə yazan ölkələrdə (Almaniya, Fransa, Braziliya) Excel üçün nöqtəli vergül istifadə edin.
Bir neçə vərəqli Excel girişi: hamısını (hər vərəq üçün bir bölmə və ya fayl) və ya yalnız birincini çevirin.
Bu alətdən necə istifadə etməli
- 1
Word fayllarını yükləyin
Hər biri 95 MB-a qədər olan 20-yə qədər .docx və ya .doc faylı əlavə edin. Markdown izlənilən dəyişiklikləri göstərə bilmədiyi üçün əvvəlcə Word-də onları qəbul edin və ya rədd edin.
- 2
Mətn parametrlərini yoxlayın
Formatlama Sadə, Mətn kodlaşdırması UTF-8, Sətir sonları isə LF üzərindədir; Git və statik sayt generatorlarının gözlədiyi birləşmə məhz budur. Şəkillərin qovluqda saxlanması üçün Şəkilləri daxil et seçimini aktiv saxlayın.
- 3
Çevirin və arxivi açın
MD formatına Çevir düyməsini basın. Hər sənəd .md faylı və şəkilləri ilə birlikdə ZIP kimi gəlir; arxivi docs qovluğuna açın və commit edin.
Word sənədini Markdown-a necə çevirmək olar?
.docx faylını yükləyin və MD formatına Çevir düyməsini basın. # başlıqları, siyahılar, linklər və cədvəlləri olan .md faylı, yanında qovluqda şəkillər alacaqsınız; hamısı bir ZIP daxilindədir.
Docs-as-code üçün DOCX-dən Markdown-a
Komandalar docs-as-code yanaşmasını bir səbəbdən seçir: sənədlər kodun yanında yaşayır, eyni pull request-lərdən keçir və eyni buraxılışla çıxır. .docx bunu pozur, çünki o, XML hissələrindən ibarət ZIP-dir və Git onu oxunmayan binar kimi saxlayır. Bir sözlük dəyişiklik oxuna bilən fərqi olmayan dəyişmiş fayl kimi görünür, eyni anda redaktə edən iki nəfər isə işini birləşdirə bilmir.
Markdown sadə mətndir, ona görə hər redaktə görünən sətir dəyişikliyidir. 2014-cü ildə John MacFarlane və başqaları Gruber-in on il əvvəl sərbəst təsvir etdiyi sintaksisin dəqiq spesifikasiyası olan CommonMark-ı dərc edəndən sonra o, daha proqnozlaşdırıla bilən oldu. GitHub 2017-ci ildə öz GitHub Flavored Markdown spesifikasiyasını CommonMark əsasında qurdu və bu gün əksər README-lərdə işlənən cədvəlləri, tapşırıq siyahılarını və üstüxətli mətni əlavə etdi.
Məzmununuz əks istiqamətdə, Word-də işləyən rəyçiyə getməlidirsə, Markdown-dan DOCX-ə alətindən istifadə edin. Repozitoriya yox, veb səhifə üçün DOCX-dən HTML-ə üslubun daha çoxunu saxlayır.
Markdown nəticəsi necə görünür
## Buraxılış yoxlama siyahısı Buraxılışı teqləməzdən əvvəl aşağıdakıları təsdiqləyin: - Testlər **main** budağında keçir - Dəyişikliklər jurnalında hər birləşdirilmiş PR var | Addım | Məsul | | --- | --- | | Yığım | CI | | Dərc | Baxıcı | 
Çevrilmiş Markdown harada göstəriləcək
| Təşkilat | Tələb | Mənbə |
|---|---|---|
| GitHub | Repozitoriyadakı README.md və hər hansı .md faylını GitHub Flavored Markdown ilə göstərir | github.com |
| Hugo | Səhifələri .md məzmun fayllarından CommonMark-a uyğun parserlə qurur | gohugo.io |
| Jekyll | Front matter olan .md fayllarını səhifələrə çevirir; GitHub Pages-in mühərrikidir | jekyllrb.com |
| Docusaurus | docs qovluğundakı .md və .mdx fayllarını sənədləşmə səhifələri kimi oxuyur | docusaurus.io |
DOCX
Microsoft Word sənədi
DOCX Office 2007-dən bəri Microsoft Word-ün standart sənəd formatıdır və Office Open XML standartına (ECMA-376, ISO/IEC 29500) əsaslanır. Mətn, üslub, şəkil, cədvəl, şərh və izlənən dəyişiklikləri saxlayan XML fayllarının ZIP paketidir. Ofislərdə, məktəblərdə və iş müraciətlərində redaktə olunan sənədlər üçün ən geniş yayılmış formatdır. Mürəkkəb formatlaşdırmada Word, Google Docs, LibreOffice və Pages arasında düzülüş bir qədər dəyişə bilər. Əksər mətn redaktorları DOCX açır.
- Sıxılma
- –
- Şəffaflıq
- –
- Animasiya
- –
- İlk dəfə təqdim edilib
- 2007 · Microsoft
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
DOCX sənəd kod iş axınına keçəndə Markdown-a çevrilir: README, docs saytı və ya Git-də saxlanan bilik bazası üçün. Burada sadə mətni müqayisə etmək, pull request-lərdə yoxlamaq və bir çox alətlə göstərmək mümkündür.
Markdown-da qarşılığı olmayan Word imkanları
Çevirməzdən əvvəl bunları nəzərə alın
- Şriftlər, rənglər və səhifə düzəni atılır; Markdown strukturu təsvir edir, görünüşü isə saytın mövzusu müəyyən edir
- İzlənilən dəyişikliklər və şərhlər köçürülmür, ona görə onları əvvəlcə Word-də həll edin
- Yuxarı və aşağı kolontitullar və səhifə nömrələri .md faylında yer almır
- Mətn qutuları və mətnlə əhatə olunmuş şəkillər adi abzaslara və şəkil linklərinə çevrilir
- Əllə formatladığınız başlıqlar, yəni Heading 2 əvəzinə qalın 16 pt, qalın mətn kimi çıxır, ona görə əvvəlcə real başlıq üslublarını tətbiq edin
- Altından xətt üçün Markdown sintaksisi yoxdur, silinir və ya HTML kimi saxlanır
DOCX-dən Markdown-a çevirmə ilə bağlı suallar
DOCX-dən MD-yə çevrilən fayl hansı Markdown növünə uyğundur?
Başlıqlar, vurğu, siyahılar, linklər və kod CommonMark qaydalarına uyğundur, cədvəllər isə GitHub Flavored Markdown-dakı şaquli xətt sintaksisindən istifadə edir. GitHub, GitLab, Hugo, Jekyll və Docusaurus bu birləşməni düzgün göstərir.
Birləşdirilmiş cədvəl xanaları ilə nə baş verir?
Markdown cədvəllərində birləşdirilmiş xanalar yoxdur, ona görə hər birləşdirilmiş sahə yenidən ayrı xanalara bölünür və mətn birinci xanada qalır. Mürəkkəb cədvəlləri .md daxilində HTML kimi yenidən qurun və ya çevirməzdən əvvəl Word-də sadələşdirin.
Word sənədimdəki şəkillər hara düşür?
Şəkilləri daxil et aktiv olduqda hər şəkil ZIP-də ayrıca fayl kimi saxlanır, Markdown isə ona images/figure-1.png kimi nisbi yolla istinad edir. .md faylını köçürərkən qovluğu onun yanında saxlayın.
Word-dəki haşiyə qeydləri Markdown-da qalırmı?
CommonMark-da qeyd sintaksisi yoxdur, lakin GitHub 2021-ci ildə [^1] qeydlərini əlavə edib və əksər sayt generatorları onları dəstəkləyir. Renderiniz dəstəkləmirsə, qeyd mətni sonda adi abzaslar kimi görünür.
Google Docs sənədlərini də bu yolla Markdown-a çevirmək olarmı?
Bəli. Google Docs-da File > Download > Microsoft Word (.docx) seçin, sonra həmin faylı bura yükləyin. Google Docs-un öz Markdown yükləmə seçimi də var və sadə sənədlər üçün yaxşı işləyir.
