Kutoka Markdown hadi PDF na Kurudi: Ubinafsishaji Huhifadhi Nini
Markdown↔PDF huhifadhi vichwa, orodha na jedwali rahisi bora kuliko pikseli. Fonti kamili, ukurasa na mpangilio haviendelei kama mzunguko usio na upotevu.
Markdown na PDF huboresha mikata tofauti. Markdown ni muundo unaofaa udhibiti wa matoleo. PDF ni maelezo ya kurasa yaliyowekwa. Kubadilisha njia moja na kurudi ni muhimu; si mzunguko wa kumbukumbu usio na upotevu.
Markdown hadi PDF: muundo huwa kurasa
Markdown hadi PDF (POST /api/v1/convert/markdown/pdf) hupokea faili ya .md au ZIP iliyo na Markdown. Upakiaji usio wa Markdown na usio wa ZIP hukataliwa. UTF-8 inahitajika kwa ingizo tambarare la .md. Mtiririko huchora Markdown kuwa HTML na jedwali, kufuta kwa mstari na orodha za kazi zikiwa zimwashwa, hufunika HTML hiyo kwa CSS inayoelekea uchapishaji (ikiwemo mrundikano wa fonti za skiripti nyingi na RTL pale Kiarabu kinapogunduliwa), kisha huchapisha kuwa PDF kwa WeasyPrint.
Kinachokawia kupita mzunguko wa mbele:
- Vichwa, aya, orodha na jedwali rahisi za Markdown
- Maandishi ya skiripti nyingi ambayo njia ya HTML inaweza kupanga (CJK, Kilatini na skiripti nyingine zinazoshughulikiwa na CSS ya uchapishaji)
- PDF inayochapishika na kushirikika kwa mitiririko ya nyaraka-kama-msimbo
Kisichokawia:
- Fonti za mandhari za kihariri chako kama ulinganifu wa uhakika kwenye kila kionyeshi
- Mivunjo ya mistari ya skrini kamili kutoka faili ya
.md - Vipengele vya mwingiliano vya Markdown visivyo na kifani kwenye PDF (visanduku vya kuchagua, sehemu zinazokunjwa, viungo vya wiki)
Ingizo la ZIP ni kwa kuunganisha Markdown pamoja na viambatisho ambavyo njia ya HTML inaweza kupata kando ya hati. Lichukulie kama urahisishaji wa kufunga, si kama uhakika kwamba kila picha au kirejeo cha CSS kitakuwa sawa kwenye kila kionyeshi.
PDF hadi Markdown: tabaka la maandishi huingia, Markdown hutoka
PDF hadi Markdown (POST /api/v1/convert/pdf/markdown) huchimba maudhui ya maandishi kuwa Markdown kupitia pdf-inspector. Jibu ni text/markdown linalopakuliwa kama faili ya .md. PDF za kidijitali zenye tabaka safi la maandishi hubadilika vizuri zaidi. Kurasa za skani zisizo na tabaka la maandishi hutoa Markdown tupu au isiyo na maana hadi ufanye OCR kwanza, na OCR kwenye tovuti hii pia hurudisha Markdown, si tabaka la PDF linaloweza kutafutwa.
Tarajia:
- Vichwa na aya pale heuristiki za ukubwa wa fonti zinapofanya kazi vizuri (unaweza bado kuhesabu upya viwango vya
#kwa mkono) - Jedwali kama jedwali za Markdown pale utambuzi unapofanya kazi; mipangilio ya safu nyingi inaweza kupangwa kwa mstari katika mpangilio tofauti wa kusoma
- Vichwa na vina vya kurasa vinavyorudiwa kwa kila ukurasa (kata baada ya)
- Picha na milinganyo-kama-picha kutokuwa viambatisho vya ndani au LaTeX kiotomatiki
Kama unahitaji maandishi tambarare bila heuristiki za vichwa, PDF hadi Maandishi ni uchimbaji ulio tambarare zaidi. Utoaji wa umbo la jedwali unaorudisha HTTP 204 humaanisha hakuna vitalu vya safu vilivyogunduliwa; ona Utoaji wa jedwali tupu (204).
Mzunguko wa kwenda na kurudi huthibitisha nini hasa
| Hudumu kwa kiasi | Kwa kawaida haidumu |
|---|---|
| Maneno, mfuatano wa vichwa, muundo wa orodha | Jiometri ya ukurasa kamili kwa pikseli |
| Jedwali rahisi kama maandishi | Fonti na kerning kamili |
| Rasimu inayofanya kazi kwa Git au ajenti | Ukurasa unaofanana na uchapishaji |
Kwenda na kurudi mara mbili kutatoa mchepuko. Markdown→PDF humwagika kupitia WeasyPrint; PDF→Markdown hujenga upya muundo kutoka heuristiki za uchimbaji. Hakuna hatua inayohifadhi kati isiyo na upotevu ya modeli ya mpangilio ya muundo mwingine.
Chagua mwelekeo wa kawaida
Kama unahitaji mpangilio wa uchapishaji kama mfumo wa kumbukumbu, hifadhi PDF na uchukulie Markdown kama utoaji au mlisho wa ajenti. Kama unahitaji tofauti, ukaguzi wa msimbo na uingizaji wa ajenti, pendelea Markdown na uchukulie PDF kama hatua ya kuchapisha. Usihifadhi vyote viwili kama “vyanzo vya ukweli” sawa na kutarajia vibaki sawa baada ya uhariri.
Mzunguko wa vitendo wa nyaraka-kama-msimbo: hariri Markdown kwenye Git → Markdown hadi PDF kwa kipande kinachoshirikika → epuka PDF→Markdown→PDF kama tabia ya kila siku. Tumia PDF→Markdown uliporithi PDF ya kidijitali na unahitaji maandishi kwa ajenti, kisha ichukulie Markdown hiyo kama rasimu mpya, si kama uhakika wa ukurasa wa awali.
Faili zilizosimbwa huhitaji Unlock iliyoidhinishwa kabla ya ubadilishaji wowote. Faili zilizoharibika zisizoweza kuchanganuliwa zinapaswa kupita Pata Taarifa / Repair kwanza. Kwa vituo hivyo hivyo kupitia HTTP, ona Watengenezaji.