Igo EPUB eta bihurgailuak MD sintaxira mapatuko du bere egitura: izenburuak `#` maila bihurtuko dira, lodia/itxia `**`/`*` bihurtuko da, zerrendak `-`/`1.` bihurtuko dira, eta estekak `[text](url)` bihurtuko dira. Emaitza MD testu arrunta eramangarria da, README batean, gune estatiko baten mezu batean, wiki batean edo Markdown-eko edozein editoretan jar dezakezuna.
Nire EPUB izenburuak eta zerrendak MD sintaxiarekin mapatuko dira?
+
Bai — EPUB-eko goiburu-mailak '#' karaktere-kopuru berdinera bihurtzen dira, eta zerrendak, bularrekin/zenbakiekin/habiak eginez, '-' eta '1.' markatzaileetara bihurtzen dira, koska egokiarekin. MD-k dokumentuaren eskema mantentzen du, egitura testu arrunt gisa berehala irakur daitekeelako.
Nola irudikatzen dira nire EPUB taula MD-n?
+
Taulak GitHub-en gustuko Markdown hodi-tauletara bihurtzen dira ('| zutabe | zutabe |' '---' bereizle-errenkada batekin), eta zuzen errendatzen dira GitHub-en, GitLab-en eta gune estatikoen sortzaile gehienetan. Markdown-en sareta sinplea gainditzen duten taula oso zabalak edo bateratutako gelaxkadun taulak sinplifikatzen dira, Markdown-ek ez baitu bateratutako gelaxka-sintaxirik.
Zer gertatzen da irudiekin EPUB MD bihurtzean?
+
EPUB(e)tik kapsulatutako irudiak anai-arreba karpeta batera erauzten dira eta MD(e)n `` sintaxiarekin erreferentziatzen dira, Markdown-ek irudi-fitxategi errealetara zuzentzen delako. URL absolutuak mantentzea ere aukera dezakezu irudiak jadanik lineaz kanpo egonda.
Aukerazkoa — bihurgailuak YAML aurre-materia bloke bat igor dezake MD-ren metadatuetatik EPUB-ren MD-ren goialdean (`---` titulua / egilea / data `---`), hau da, Jekyll, Hugo eta beste gune estatiko sortzaileek espero dutena. Desgaitu MD gorputz garbia soilik izateko.
MD(e)k ATX (`#`) edo Setext goiburuak erabiliko ditu?
+
MD-ek ATX-estiloko `#` goiburuak erabiltzen ditu lehenespenez — Markdown-en edozein zaporetan funtzionatzen duen eta sei goiburu-maila guztietara eskalatzen duen konbentzio modernoa eta zabalki onartutakoa. Setext (azpimarratua) goiburuek bi maila bakarrik onartzen dituzte, beraz, ATX aukera seguruagoa eta eramangarriagoa da.
EPUB eta MD estekak eta oin-oharrak gordetzen ditu?
+
Hiperestekak lerro barruko `[text](url)` esteka bihurtzen dira, eta EPUB karaktereak benetako oihartzunak adierazten dituenean, `[^1]` erreferentzia-estiloko oihartzunetara bihurtzen dira, eta egoki errendatzen dira hedapena onartzen duten plataformetan. Goi-indizeko oharrak lerro barruko testu gisa mantentzen dira.
Bihur al dezaket EPUB MD-era nire GitHub README edo wiki-rako?
+
Bai — irteera GitHub-Flavored Markdown da, beraz, zuzen errendatzen da README, wiki-orri, arazo edo PR deskribapen gisa GitHub eta GitLab-en. Pipe-taulak, zereginen zerrendak, hesitutako kode-blokeak eta `#` goiburuak denak nahi bezala bistaratzen dira MD itsatsi edo bidali ondoren.
Nire EPUB pribatua da bihurtzean?
+
Bai — igotako EPUB fitxategiak langile isolatuetan prozesatu eta minutu batzuetan ezabatu egiten dira. Ez dugu inoiz edukia irakurtzen, gordetzen edo partekatzen. Ikusi /privacy/.
Zergatik ditu nire MD(e)k HTML etiketa nahasturik?
+
Markdown-ek ezin ditu dokumentu aberats batek dituen ezaugarri guztiak adierazi (testu koloreduna, taula konplexuak, testu-koadroak), beraz bihurgailuak lerro-barneko HTMLra itzuliko da zati horiek kentzeko — Markdown-ek HTML kapsulatua onartzen du. MD hutsa nahi baduzu, lehenik EPUB-en formateatzea sinplifikatu, edo gaitu "strip HTML fallback" aukera.
EPUB - MD-ek kode-blokeak kudeatzen ditu?
+
Bai — EPUB(e)ko testu tarte bakarrekoa / aurreformateatua MD(e)ko ```kode-bloke``` itxi batean bihurtzen da, tarte zuriak eta, detekta daitekeen lekuan, sintaxia nabarmentzeko hizkuntza-iradokizuna mantenduz. Funtsezkoa da dokumentu teknikoak eta tutorialak Markdown-era bihurtzean.
EPUB MD bihur dezaket Hugo edo Jekyll bezalako gune estatikoen sortzaile baterako?
+
Bai — gaitu YAML aurpegia eta MD `content/` edo `_posts/` karpetara jartzeko prest agertuko da: titulua eta data aurpegian, gorputza Markdown garbi gisa, irudiak anai-arreben karpeta batean. Bihurgailuak Hugo, Jekyll, Eleventy eta Gatsby-k espero duten forma zehazten du.
