ნაბიჯი 1: ატვირთეთ თქვენი DOC ფაილები ზემოთ მოცემული ღილაკის გამოყენებით ან გადათრევით და ჩაშვებით.
ნაბიჯი 2: კონვერტაციის დასაწყებად დააჭირეთ ღილაკს "კონვერტაცია".
ნაბიჯი 3: ჩამოტვირთეთ თქვენი კონვერტირებული Markdown ფაილები
DOC რომ Markdown კითხვები და პასუხები
როგორ გადავამუშავო DOC და გავასუფთაო Markdown?
+
ჩატვირთეთ DOC და კონვერტორი დაეყრდნობა მის სტრუქტურას Markdown სინტაქსით: სათაურები გახდება `#` დონეები, მრგვალი/კენტირებული გახდება `**`/`*`, სიები გახდება `-`/`1.` და ბმულები გახდება `[text](url)`. შედეგი არის გადასატანი ჩვეულებრივი ტექსტი Markdown, რომელსაც შეგიძლიათ ჩააყენოთ README- ში, სტატიკური საიტის პოსტში, ვიკიში ან ნებისმიერ Markdown რედაქტორში.
თავსართები და სიები ჩემი DOC - დან Markdown - ს სინტაქსით დაემატება?
+
დიახ - სათაურების დონეები DOC - ში გადაეცემა `#` სიმბოლოების შესაბამის რაოდენობას, ხოლო ნიშნიანი/ ნომრული/ ჩასმული სიები გადაეცემა `-` და `1.` მარკერებს სწორი დაშორებით. Markdown ინარჩუნებს დოკუმენტის კონტურს, ასე რომ სტრუქტურა სწრაფად წასაკითხია როგორც ჩვეულებრივი ტექსტი.
როგორ წარმოდგენილია ცხრილები ჩემს DOC- დან Markdown- ში?
+
ცხრილები გადაეცემა GitHub-ის გემოს Markdown-ის მილსადენების ცხრილებად ('| col | col |' '---' განმყოფი რიგის გამოყენებით), რომლებიც სწორად იბეჭდება GitHub-ზე, GitLab-ზე და სტატიკური საიტების უმეტესობაზე. ძალიან ფართო ან შერწყმული უჯრედების ცხრილები, რომლებიც Markdown-ის მარტივ ქსელს აღემატება, გამარტივებულია, რადგან Markdown-ს არ აქვს შერწყმული უჯრედების სინტაქსი.
რა ხდება გამოსახულებებთან, როდესაც DOC იცვლება Markdown- ში?
+
DOC - დან ჩაშენებული სურათები ამოიჭრება დაკავშირებულ საქაღალდეში და Markdown - ში `![ alt] (path) ` სინტაქსით არის მითითებული, ასე რომ Markdown მითითებულია სურათის ფაილებზე. შეგიძლიათ ასევე აირჩიოთ აბსოლუტური URL- ების შენახვა, თუ სურათები უკვე ონლაინშია.
DOC-დან Markdown-მდე YAML-ის წინასწარ ელემენტის დამატება?
+
ოპციურად - კონვერტორის შეუძლია გამოსცეს YAML წინასწარ- მასალის ბლოკი (`---` სახელი / ავტორი / თარიღი `---`) Markdown - ს ზედა ნაწილში DOC - ს მეტა მონაცემებიდან, რაც ზუსტად ისაა, რასაც Jekyll, Hugo და სხვა სტატიკური საიტის გენერატორები ელოდება. გამორთეთ ეს მხოლოდ Markdown - ს სუფთა სხეულისთვის.
Markdown-მა ATX ('#') ან Setext სათაურები უნდა გამოიყენოს?
+
Markdown ნაგულისხმევად ATX- ს სტილის `#` სათაურებს იყენებს - თანამედროვე, ფართო მხარდაჭერით აღჭურვილი კონვენცია, რომელიც მუშაობს ყველა Markdown- ის ვარიანტში და იზრდება ყველა 6 სათაურის დონეზე. Setext (დატანილი) სათაურები მხოლოდ ორი დონის მხარდაჭერას იღებს, ამიტომ ATX უსაფრთხო და მოსახერხებელი არჩევანია.
DOC - დან Markdown - მდე ბმულები და ქვესართები დაცულია?
+
ჰიპერბმულები ხდება `[text] (url)` ბმულები და სადაც DOC ნიშნავს რეალურ ქვესართს, ისინი გარდაიქმნება `[^1]` რეფერენტის სტილის ქვესართებად, რომლებიც სწორად ინახება პლატფორმებზე, რომლებიც მხარს უჭერენ გაფართოებას. ჩვეულებრივი ზედა წერტილის შენიშვნები რჩება როგორც შიგნით ტექსტი.
შემიძლია DOC-ის გადაქცევა Markdown-ში ჩემი GitHub README ან wiki-სთვის?
+
დიახ - გამონატანი არის GitHub-ის გემოს მარკდოუნი, ასე რომ ის სწორად გამოიყურება როგორც README, ვიკი გვერდი, გამოშვების ან PR აღწერა GitHub-სა და GitLab-ზე. მილის ცხრილები, დავალების სიები, დახურული კოდის ბლოკები და `#` თავსართები ყველა გამოჩნდება როგორც უნდა, როდესაც თქვენ ჩასვით ან გადააგზავნით Markdown.
დაცულია თუ არა ჩემი DOC გადამუშავებისას?
+
დიახ - ატვირთული DOC ფაილები იმუშავებენ იზოლირებული სამუშაოების ფარგლებში და რამდენიმე წუთში იკარგება. ჩვენ არასდროს ვკითხულობთ, ვინახავთ ან ვზიარებთ შენახვას. იხილეთ /privacy/.
რატომ არის ჩემი Markdown-ის HTML ჭდეები შერეული?
+
Markdown- ში არ არის შესაძლებელი მდიდარი დოკუმენტის ყველა ფუნქციის გამოსახვა (ფეროვანი ტექსტი, კომპლექსური ცხრილები, ტექსტის ველი), ამიტომ კონვერტორი უკან ბრუნდება HTML- ის შიგთავსის HTML- ში ამ ფრაგმენტებისთვის მათი გაშვების ნაცვლად - Markdown- ში ჩაშენებული HTML- ის გამოყენება შესაძლებელია. თუ გსურთ Markdown, პირველად DOC- ში ფორმატირება გაადვილეთ, ან ჩართეთ "strip HTML fallback" პარამეტრის ჩართვა.
DOC და Markdown მართავენ კოდის ბლოკებს?
+
დიახ - ერთდროულად დაშორებული/ წინასწარ ფორმატირებული ტექსტი DOC - ში რჩება დაცული `` კოდის ბლოკი '' Markdown - ში, დაცულია სივრცეები და, სადაც შესაძლებელია, ენის რჩევა სინტაქსის შეფერადებისთვის. ეს აუცილებელია ტექნიკური დოკუმენტების და კურსების Markdown- ში გადატანისას.
შემიძლია DOC-ის გადაქცევა Markdown-ში სტატიკური საიტის გენერატორისთვის, როგორიცაა Hugo ან Jekyll?
+
დიახ - YAML- ის წინასწარ შეტყობინების ჩართვა და Markdown გამოვა, რომელიც მზად იქნება `content/` ან `_posts/` საქაღალდეებში ჩასასვლელად: სახელწოდება და თარიღი წინასწარ შეტყობინებაში, ტექსტი როგორც Markdown- ის სუფთა ნაწილი, სურათები საქაღალდეებში. გადამცვლელი ზუსტად ისეთ ფორმას იღებს, როგორსაც ჰიუგო, ჯეკილი, ელვენტი და გატსბი ელოდნენ.
