Функционалност и примена алата Markdown у Word / HTML
Овај алат омогућава корисницима да пишу или налепе Markdown текст и одмах виде приказ у реалном времену. Након уноса, Markdown се може конвертовати у Microsoft Word документ (.docx) или у чист HTML формат. Алат такође пружа увид у број речи и знакова унетих у поље за унос.
Конверзија докумената је значајна за различите платформе, а овај алат је намењен ауторима који имају потребу да испоруче README датотеке, упутства, белешке или чланке у DOCX или HTML формату.
Унос текста и подржани формати
Унос текста се врши унутар поља са ознаком „Напишите свој Markdown“. Алат прихвата уобичајене Markdown структуре, што укључује:
- Наслове
- Листе и листе задатака
- Табеле
- Линкове
- Блокове кода
- Истакнути текст (emphasis)
Постоје одређена ограничења у погледу величине уноса за локални извоз у Word. Уколико унети Markdown пређе дозвољени лимит знакова, на екрану ће се појавити порука: „Овај Markdown је превелик за локални извоз у Word. Ограничите га на мање од {max} знакова.“. Када се унос потпуно испразни притиском на дугме „Обриши“, статус се мења у „Едитор је испражњен.“, а број знакова се ресетује на 0.
Излазни формати и преузимање датотека
Након обраде уноса, кориснику су на располагању следећи излазни елементи и опције:
- Преглед: Форматирани приказ унетог Markdown текста.
- HTML: Сирови HTML код генерисан на основу уноса.
- Преузми Word: Преузимање.docx датотеке на локални уређај.
- Преузми HTML: Преузимање самосталне.html датотеке.
- Копирај HTML: Копирање генерисаног HTML кода у привремени меморијски простор (clipboard).
- Речи: Приказ укупног броја речи у унетом тексту.
- Знакови: Приказ укупног броја знакова у унетом тексту.
Алат користи први H1 наслов из унетог Markdown текста како би одредио назив датотеке за извезени Word документ. Уколико унос не садржи наслов, користи се подразумевани назив. Сви линкови који се генеришу у прегледу и HTML излазу садрже атрибуте noopener noreferrer ради безбедности.
Локална обрада података и приватност
Процес конверзије се у потпуности одвија локално. Ваш Markdown се обрађује у вашем прегледачу. Ништа се не отпрема на BroBroGo. Генерисање Word документа, приказ прегледа и извоз у HTML раде искључиво унутар веб прегледача корисника, без слања података екстерним серверима.
Правила конверзије и решавање грешака
Током рада са алатом могу се појавити специфични сценарији и грешке у зависности од унетог садржаја:
- Ако је поље за унос празно, у простору за приказ појавиће се порука „Овде ће се појавити форматирани приказ и HTML.“.
- Ако покушате да извршите извоз без унетог текста, систем ће приказати обавештење „Нема ничега за извоз — прво напишите нешто у Markdown-у.“.
- Сав необрађени HTML код који корисник ручно унесе унутар Markdown текста биће ескејпован пре приказивања у HTML извозу.
- У случају техничких потешкоћа током процеса конверзије, алат исписује поруку „Конверзија није успела. Покушајте са мањим Markdown документом.“.
Структура Word документа и чист HTML
Приликом превођења Markdown-а у Word, елементи се мапирају директно у структуриране делове DOCX датотеке, задржавајући пасусе, табеле, листе и стилове наслова.
Са друге стране, извезени HTML представља једноставан, самосталан документ. Предност оваквог „чистог HTML-а“ огледа се у одсуству сувишних стилова и скрипти, што олакшава даљу интеграцију у веб пројекте, уређиваче садржаја или дељење датотека путем мреже.
Често постављана питања (FAQ)
Да ли се мој Markdown отпрема на сервер?
Не. Преглед, извоз у HTML и генерисање Word документа се обављају локално у вашем прегледачу.
Шта се све задржава при извозу у Word?
DOCX задржава уобичајену Markdown структуру као што су наслови, листе, табеле, линкови, блокови кода, истакнути текст и листе задатака.
Да ли извезени HTML садржи небезбедне скрипте?
Не. Необрађени HTML унутар вашег Markdown-а се ескејпује пре приказивања, а преузети HTML је једноставан самосталан документ.
Како алат одређује назив преузете Word датотеке?
Назив извезене Word датотеке се аутоматски креира на основу првог H1 наслова који је дефинисан у вашем Markdown тексту.