Markdown og kostir þess við skjalagerð
Markdown er einfalt textasnið sem gerir höfundum kleift að skrifa texta með auðlesanlegri uppbyggingu sem auðvelt er að breyta í sniðinn texta. Kosturinn við Markdown er að rithöfundar, forritarar og útgefendur geta einbeitt sér að innihaldinu án þess að truflast af flóknum valmyndum ritvinnsluforrita. Sniðið notar einföld tákn, eins og stjörnur fyrir áherslur og skástrik eða gráður fyrir aðra þætti, sem gerir það læsilegt í hvaða ritli sem er.
Þegar flytja þarf texta á milli ólíkra kerfa kemur fram þörf á áreiðanlegri skjalabreytingu. Mörg kerfi krefjast Microsoft Word-skjala (.docx) eða vefvænna HTML-skráa. Með því að breyta Markdown yfir í þessi snið brúar þú bilið á milli einfalds texta og flókinna skjala sem samstarfsfólk, viðskiptavinir eða vefkerfi krefjast.
Uppbygging Word-skjala og vörpun úr Markdown
Microsoft Word-skjöl (.docx) byggja á flóknu XML-skipulagi sem skilgreinir útlit, leturgerðir og skipulag textans. Þegar Markdown er varpað yfir í Word-skjal þarf að þýða einföldu Markdown-táknin yfir í samsvarandi XML-einingar.
Tólið styður vörpun á algengri Markdown-uppbyggingu yfir í Word:
- Fyrirsagnir: Fyrirsagnir frá H1 til H6 færast yfir sem viðeigandi fyrirsagnastílar. Skráarnafnið á útflutta Word-skjalinu er sjálfkrafa dregið af fyrstu H1-fyrirsögninni í Markdown-textanum þínum. Ef engin slík fyrirsögn finnst er skjalið nefnt eftir sjálfgefnu gildi.
- Listar og verkefnalistar: Bæði númeraðir listar, punktalistar og verkefnalistar varðveitast í útflutta skjalinu.
- Töflur: Markdown-töflur eru dregnar upp sem skipulagðar töflur í Word með línum og dálkum.
- Tenglar og áherslutexti: Feitletraður texti, skáletraður texti og tenglar halda virkni sinni og útliti.
- Kóðablokkir: Kóðabútar eru settir upp í sérstökum blokkum til að aðskilja þá frá venjulegum texta.
Hreint HTML og kostir þess í vefþróun
HTML-kóðinn sem þetta tól framleiðir er skilgreindur sem „hreint HTML“. Það þýðir að kóðinn inniheldur eingöngu nauðsynleg merki (e. tags) sem þarf til að sýna uppbyggingu textans, án óþarfa stílsniða, innbyggðra skrifta eða séreignarkóða sem oft fylgja þegar skjölum er vistað úr stórum ritvinnsluforritum.
Hreint HTML tryggir að auðvelt er að samþætta textann beint inn í vefumsjónarkerfi (CMS) eða vefsíður án þess að eiga á hættu að skemma núverandi hönnun eða stílsnið síðunnar. Þegar HTML-útflutningurinn er sóttur sem sjálfstæð skrá, færðu einfalt og gilt HTML-skjal sem hægt er að opna í hvaða vafra sem er eða hlaða beint upp á vefþjón. Til að tryggja öryggi og rétta meðhöndlun á tenglum, innihalda allir tenglar í forskoðuninni og HTML-útflutningnum eiginleikana noopener noreferrer.
Staðbundin vinnsla og persónuvernd
Öll vinnsla á textanum þínum fer fram staðbundið í vafranum þínum. Þegar þú skrifar, forskoðar eða breytir Markdown-texta yfir í Word eða HTML, eru engin gögn send til ytri netþjóna.
Þessi aðferð hefur nokkra mikilvæga eiginleika:
- Enginn gagnaflutningur: Unnið er úr Markdown-textanum í vafranum þínum. Engu er hlaðið upp til BroBroGo.
- Öryggi gagna: Þar sem gögnin yfirgefa aldrei tækið þitt, hentar tólið vel fyrir vinnu með texta sem þú vilt halda á þínu eigin tæki án þess að eiga á hættu að gögn vistist á óþekktum netþjónum.
- Takmarkanir á stærð: Þar sem umbreytingin yfir í Word-skjal (.docx) fer fram með staðbundnum reikniritum í vafranum, eru takmörk fyrir því hversu stór skjöl er hægt að vinna í einu. Ef textinn fer yfir ákveðinn stafafjölda mun tæknin ekki geta lokið útflutningnum staðbundið.
Leiðbeiningar um notkun og villuboð
Tólið sýnir rauntímatölfræði yfir textann þinn, þar á meðal fjölda orða og stafa. Þegar ritillinn er tæmdur með því að smella á „Hreinsa“, breytist staðan í „Ritillinn var hreinsaður.“ og stafateljarinn fer niður í 0.
Ef upp koma villur eða sérstakar aðstæður við notkun, birtir kerfið eftirfarandi skilaboð:
- Ef ritillinn er tómur sýnir forskoðunarsvæðið textann: „Sniðin forskoðun og HTML munu birtast hér.“
- Ef reynt er að flytja út skjal án þess að hafa skrifað texta, birtast skilaboðin: „Ekkert til að flytja út ennþá — skrifaðu Markdown fyrst.“
- Ef Markdown-textinn er of stór fyrir staðbundna Word-vinnslu, birtast skilaboðin: „Þetta Markdown er of stórt fyrir staðbundinn Word-útflutning. Hafðu það undir
{max}stöfum.“ - Ef eitthvað fer úrskeiðis við sjálfa umbreytinguna birtast skilaboðin: „Umbreyting mistókst. Prófaðu minna Markdown-skjal.“
Að auki er hráu HTML-kóðun innan Markdown-textans sleppt áður en hún er birt í HTML-útflutningnum til að koma í veg fyrir óæskilega keyrslu á kóða.
Algengar spurningar
Er Markdown-textanum mínum hlaðið upp?
Nei. Forskoðun, HTML-útflutningur og gerð Word-skjala fer allt fram staðbundið í vafranum þínum.
Hvað varðveitist í Word-útflutningnum?
DOCX-skráin varðveitir algenga Markdown-uppbyggingu eins og fyrirsagnir, lista, töflur, tengla, kóðablokkir, áherslutexta og verkefnalista.
Inniheldur HTML-útflutningurinn óörugg skriftur?
Nei. Hráu HTML-kóðun innan Markdown-textans er sleppt áður en hún er birt, og HTML-skráin sem þú sækir er einfalt, sjálfstætt skjal.
Hvaðan kemur skráarnafnið á Word-skjalinu?
Tólið dregur nafn skjalsins sjálfkrafa af fyrstu H1-fyrirsögninni (# Fyrirsögn) sem finnst í Markdown-textanum þínum. Ef engin slík fyrirsögn er til staðar fær skjalið sjálfgefið nafn.