DOCX í Markdown
Þegar skjölun er flutt úr Word yfir í Git-geymslu er fyrsta skrefið að breyta hverri .docx-skrá í Markdown. Þessi breytir skrifar texta í anda CommonMark með # fyrirsögnum, pípu-töflum og myndatenglum, tilbúinn til að fara í commit.
Skjalaumbreyting
eða slepptu PDF, DOC, DOCX … skrár hér ·
Að hámarki 95 MB á skrá· Allt að 20 skrár· Eytt eftir 30 mínútur
Skrár eru unnar á þjónum okkar og eytt eftir 30 mínútur.
150 DPI gerir A4-síðu að um 1240 × 1754 px. Notaðu 300 til prentunar.
Umbreyta allri skránni eða aðeins sumum síðum eða glærum (PDF og kynningarskrár).
Síður eða glærur til að umbreyta, t.d. 1-3, 5, 8-10.
UTF-8 virkar fyrir öll tungumál. Veldu UTF-8 með BOM ef Excel eða Notepad á Windows sýnir bjagaða stafi; eldri stafakóðun aðeins fyrir gamlan hugbúnað.
LF fyrir macOS, Linux og kóðaritla; CRLF fyrir eldri Windows-forrit eins og gamla Notepad.
Komma er staðallinn. Notaðu semíkommu fyrir Excel í löndum sem skrifa tugabrot með kommu (Þýskaland, Frakkland, Brasilía).
Excel-inntak með mörgum blöðum: umbreyta öllum (einn kafli eða ein skrá á blað) eða aðeins því fyrsta.
Hvernig á að nota tólið
- 1
Hladdu upp Word-skránum
Bættu við allt að 20 .docx- eða .doc-skrám, hver að hámarki 95 MB. Samþykktu eða hafnaðu fyrst breytingum í rakningarham í Word, því Markdown getur ekki sýnt þær.
- 2
Yfirfarðu textastillingarnar
Snið er stillt á Einfalt, Textakóðun á UTF-8 og Línuendingar á LF, en það er samsetningin sem Git og kyrrstæð vefsíðukerfi gera ráð fyrir. Hafðu Taka myndir með kveikt til að fá myndirnar í möppu.
- 3
Umbreyttu og afþjappaðu
Ýttu á Umbreyta í MD. Hvert skjal kemur sem ZIP-skrá með .md-skránni og myndunum hennar; afþjappaðu hana í skjalamöppuna þína og vistaðu í Git.
Hvernig umbreyti ég Word-skjali í Markdown?
Hladdu upp .docx-skránni og ýttu á Umbreyta í MD. Þú færð .md-skrá með #-fyrirsögnum, listum, tenglum og töflum, ásamt myndunum í möppu við hliðina, allt í einni ZIP-skrá.
DOCX í Markdown fyrir docs-as-code
Teymi taka upp skjöl sem kóða (docs-as-code) af einni ástæðu: skjölin eru þá við hlið kóðans, fara í gegnum sömu pull request og koma út með sömu útgáfu. .docx brýtur þetta, því hún er ZIP-skrá með XML-hlutum sem Git geymir sem ólæsilega tvíundarskrá. Eins orðs breyting birtist sem breytt skrá án læsilegs mismunar og tveir sem breyta samtímis geta ekki sameinað vinnu sína.
Markdown er hreinn texti, svo sérhver breyting er sýnileg línubreyting. Það varð líka mun fyrirsjáanlegra árið 2014, þegar John MacFarlane og fleiri gáfu út CommonMark, nákvæma forskrift að setningafræðinni sem Gruber hafði lýst lauslega tíu árum áður. GitHub byggði eigin GitHub Flavored Markdown forskrift á CommonMark árið 2017 og bætti við töflum með lóðréttum strikum, verkefnalistum og yfirstrikun sem flestar README-skrár nota í dag.
Ef efnið fer hina leiðina, Markdown til yfirlesara sem vinnur í Word, notaðu þá Markdown í DOCX. Fyrir vefsíðu frekar en hugbúnaðarsafn heldur DOCX í HTML meira af útlitinu.
Hvernig Markdown-úttakið lítur út
## Gátlisti fyrir útgáfu Áður en útgáfa er merkt skal staðfesta eftirfarandi: - Prófanir standast á **main** - Breytingaskráin telur upp allar sameinaðar PR-beiðnir | Skref | Ábyrgð | | --- | --- | | Smíði | CI | | Útgáfa | Umsjónarmaður | 
Hvar umbreytta Markdown-skráin birtist
| Stofnun | Krafa | Heimild |
|---|---|---|
| GitHub | Birtir README.md og allar .md-skrár í hugbúnaðarsafni með GitHub Flavored Markdown | github.com |
| Hugo | Býr til síður úr .md-efnisskrám með þáttara sem uppfyllir CommonMark | gohugo.io |
| Jekyll | Breytir .md-skrám með front matter í síður; vélin á bak við GitHub Pages | jekyllrb.com |
| Docusaurus | Les .md- og .mdx-skrár í skjalamöppu sinni sem skjalasíður | docusaurus.io |
DOCX
Microsoft Word skjal
DOCX er sjálfgefið skjalasnið Microsoft Word frá og með Office 2007 og byggir á Office Open XML staðlinum (ECMA-376, ISO/IEC 29500). Það er ZIP-pakki með XML skrám sem geyma texta, stíla, myndir, töflur, athugasemdir og rakta breytingar. Það er algengasta sniðið fyrir skjöl sem hægt er að breyta á skrifstofum, í skólum og í atvinnuumsóknum. Útlit getur breyst lítillega milli Word, Google Docs, LibreOffice og Pages, einkum með flóknu sniði. Flest ritvinnsluforrit opna DOCX skrár.
- Þjöppun
- –
- Gegnsæi
- –
- Hreyfimynd
- –
- Kom fram
- 2007 · Microsoft
MD
Markdown
Markdown er létt merkingarmál sem John Gruber bjó til árið 2004. Það notar tákn í hreinum texta, eins og # fyrir fyrirsagnir, * fyrir áherslu og - fyrir lista, sem eru læsileg sem hrár texti og umbreytast hreint í HTML. Það er staðallinn fyrir README-skrár, handbækur, wiki-síður, glósuforrit og marga stöðuga vefsmíðara. Til eru nokkur afbrigði, svo sem CommonMark og GitHub Flavored Markdown, sem eru ólík í smáatriðum eins og töflum. Allir textaritlar geta opnað .md-skrár.
- Þjöppun
- –
- Gegnsæi
- –
- Hreyfimynd
- –
- Kom fram
- 2004 · John Gruber
DOCX er umbreytt í Markdown þegar skjal fer inn í vinnuferli með kóða: README-skrá, skjalavef eða þekkingargrunn í Git, þar sem hægt er að bera saman hreinan texta, yfirfara hann í pull request og birta með mörgum tólum.
Eiginleikar Word sem eiga sér enga hliðstæðu í Markdown
Gerðu ráð fyrir þessu áður en þú umbreytir
- Letur, litir og síðuuppsetning falla niður; Markdown lýsir uppbyggingu og þema vefsins ræður útlitinu
- Breytingar í rakningarham og athugasemdir fylgja ekki með, svo leystu úr þeim í Word fyrst
- Hausar, fótar og blaðsíðutöl eiga ekki heima í .md-skrá
- Textareitir og myndir með textaflæði verða venjulegar málsgreinar og myndatenglar
- Fyrirsagnir sem þú sniðaðir í höndunum, feitt 16 pt í stað Heading 2, verða feitletraður texti, svo notaðu raunverulega fyrirsagnastíla fyrst
- Undirstrikun á sér enga Markdown-setningafræði og er fjarlægð eða geymd sem HTML
Spurningar um DOCX í Markdown
Hvaða Markdown-afbrigði fylgir DOCX í MD úttakið?
Fyrirsagnir, áherslur, listar, tenglar og kóði fylgja CommonMark og töflur nota lóðréttu strikasetninguna úr GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll og Docusaurus birta öll þessa samsetningu.
Hvað verður um sameinaða töflureiti?
Markdown-töflur með lóðréttum strikum styðja ekki sameinaða reiti, þannig að hverju sameinuðu svæði er skipt aftur í staka reiti og textinn settur í þann fyrsta. Byggðu flóknar töflur upp sem HTML inni í .md-skránni eða einfaldaðu þær í Word áður en þú umbreytir.
Hvert fara myndirnar úr Word-skjalinu mínu?
Þegar Taka myndir með er kveikt er hver mynd vistuð sem sérskrá í ZIP-skránni og Markdown tengir í hana með afstæðri slóð eins og images/figure-1.png. Hafðu möppuna við hliðina á .md-skránni þegar þú flytur hana.
Haldast neðanmálsgreinar úr Word í Markdown?
CommonMark hefur enga setningafræði fyrir neðanmálsgreinar, en GitHub bætti við [^1] neðanmálsgreinum árið 2021 og flest vefsíðukerfi styðja þær. Ef birtingarforritið þitt gerir það ekki birtist texti athugasemdarinnar sem venjulegar málsgreinar aftast.
Get ég umbreytt Google Docs í Markdown á þennan hátt?
Já. Í Google Docs velurðu File > Download > Microsoft Word (.docx) og hleður síðan þeirri skrá upp hér. Google Docs býður einnig sjálft upp á niðurhal í Markdown, sem virkar vel fyrir einföld skjöl.
