Markdown na PDF

Laai 'n .md- of .markdown-lêer op en kry 'n PDF waarin # 'n opskrif word, **bold** vet teks word en 'n pyptabel 'n tabel word. Dit is die vinnigste manier om 'n README, vergadernotas of 'n spesifikasie te gee aan iemand wat nog nooit van Markdown gehoor het nie.

of los DOC, DOCX, DOCM …-lêers hier ·

Maks. 95 MB per lêer· Tot 20 lêers· Uitgevee na 30 minute

Uitvoer

Skakel om na

Bladsygrootte

Oriëntasie

Lêers word op ons bedieners verwerk en na 30 minute uitgevee.

Hoe om hierdie nutsding te gebruik

1
Laai die .md-lêer op
Voeg een Markdown-lêer of tot 20 op een slag by, elk tot 95 MB. Maak op GitHub die lêer oop, laai die rou weergawe af en laai dit op.
2
Gaan die bladsy- en boekmerkopsies na
Boekmerke uit opskrifte is aan, sodat opskrifte in die PDF-sybalk verskyn. Kantlyne begin by Normaal; stel Bladsygrootte op A4 of Letter onder Gevorderde instellings vir druk.
3
Skakel om na PDF
Druk Skakel om na PDF en laai die weergegee dokument af. Die opgelaaide lêer en die PDF word ná 30 minute uitgevee.

Antwoord

Hoe skakel ek Markdown om na PDF?

Laai die .md-lêer op en druk Skakel om na PDF. Die Markdown word eers weergegee, so die PDF wys geformateerde opskrifte, lyste, skakels, tabelle en kode in plaas van die rou simbole.

Markdown, CommonMark en GFM: watter sintaksis die PDF verstaan

2004
Markdown
John Gruber publiseer die sintaksis en 'n Perl-skrif, met insette van Aaron Swartz. Die reëls laat baie randgevalle oop.
2014
CommonMark
'n Groep wat John MacFarlane insluit, publiseer 'n ondubbelsinnige spesifikasie met toetsgevalle, wat eers as Standard Markdown aangekondig is.
2016
text/markdown
RFC 7763 registreer die amptelike media-tipe vir Markdown-lêers.
2017
GFM-spesifikasie
GitHub publiseer GitHub Flavored Markdown as 'n streng superset van CommonMark, met tabelle, taaklyste en deurhaling bygevoeg.

Die vroeë dubbelsinnigheid is hoekom dieselfde lêer effens anders op GitHub, in VS Code, in Obsidian en in 'n statiese webwerfgenerator weergegee word. Twee leë lyne, 'n lys wat met twee spasies in plaas van vier ingeskuif is, of 'n opskrif sonder spasie ná # kan die resultaat verander. Lêers wat volgens CommonMark geskryf is, met GFM-tabelle waar jy dit nodig het, word byna oral dieselfde weergegee, ook in hierdie omskakelaar.

As jou lêer eintlik gewone notas sonder Markdown-sintaksis is, druk die teks na PDF-bladsy dit presies soos getik. As jy die inhoud reeds as 'n webbladsy het, behou HTML na PDF die webwerf se eie styl.

Wat elke Markdown-element in die PDF word

Algemene sintaksis en hoe dit op die bladsy verskyn
Element	Markdown	In die PDF
Opskrifte	`#` tot `######`	Opskrifte in verskillende groottes; met Boekmerke uit opskrifte aan, inskrywings in die PDF-sybalk
Beklemtoning	`vet`, `kursief`, `~~deurgehaal~~`	Vet, skuins en deurgehaalde teks
Lyste	`-`, `*`, `1.`	Kolpunt- en genommerde lyste, genestel deur inspringing
Skakels	`[label](https://…)`	Klikbare teks; relatiewe skakels verloor hul teiken
Kode	Truktekens en omheinde ``` blokke	Vaste-breedte teks op 'n geskakeerde blok; hou lyne kort sodat hulle by die bladsybreedte pas
Tabelle	GFM-pyptabelle	Tabelle met lyne; breë tabelle pas beter in landskap
Beelde	`![alt](https://…)`	Word gewys wanneer die adres 'n volle, openbare URL is

MD

Markdown

Markdown is 'n ligte opmaaksintaksis wat in 2004 deur John Gruber geskep is. Dit gebruik platteteks-simbole, soos # vir opskrifte, * vir beklemtoning en - vir lyste, wat as rou teks leesbaar bly en netjies na HTML omgeskakel word. Dit is die standaard vir README-lêers, dokumentasie, wiki's, notaprogramme en baie statiese webwerfgenerators. Daar is verskeie dialekte, soos CommonMark en GitHub Flavored Markdown, wat in besonderhede soos tabelle verskil. Enige teksredigeerder kan .md-lêers oopmaak.

Kompressie: –
Deursigtigheid: –
Animasie: –
Bekendgestel: 2004 · John Gruber

MD-omskakelaar

PDF

Portable Document Format

PDF is in 1993 deur Adobe geskep en het in 2008 die oop ISO 32000-standaard geword. Dit maak teks, lettertipes, beelde en uitleg vas sodat 'n dokument op elke skerm en drukker dieselfde lyk. PDF's kan vorms, handtekeninge, skakels, aanhangsels en deursoekbare teks bevat, en die PDF/A-variant word vir langtermyn-argivering gebruik. Die vaste uitleg maak PDF's moeilik om te redigeer, en geskandeerde PDF's bevat net beelde tensy OCR toegepas word. Elke blaaier en bedryfstelsel kan dit oopmaak.

Kompressie: –
Deursigtigheid: Ja
Animasie: Nee
Bekendgestel: 1993 · Adobe

PDF-omskakelaar

Markdown lyk eers klaar nadat 'n weergawer sy simbole in formatering omskep, en die meeste ontvangers het nie een nie; 'n PDF wys vir hulle die opskrifte, tabelle en kodeblokke wat jy bedoel het in plaas van hekkies en sterretjies.

Markdown-ekstras wat nie omgeskakel word nie

Diagramme, wiskunde en front matter bly as teks

Mermaid-diagramme, LaTeX-wiskunde tussen dollartekens, YAML-voorwerk bo-aan die lêer en program-spesifieke inbeddings is uitbreidings buite beide CommonMark en die GFM-spesifikasie. Voer diagramme en formules as beelde uit en skakel daarna, en vee die voorwerkblok uit as jy nie wil hê dit moet op bladsy een gedruk word nie.

Vrae oor Markdown na PDF

Watter Markdown-variant moet my lêer volg vir 'n netjiese PDF?

Hou by CommonMark plus die GitHub-uitbreidings wat die meeste redigeerders ondersteun: pyptabelle, omheinde kodeblokke en deurhaling. Sintaksis wat net een program verstaan, soos wiki-skakels, kom die waarskynlikste as gewone teks uit.

Hoe behou ek die beelde uit my Markdown-lêer in die PDF?

Slegs die .md-lêer word opgelaai, so 'n beeld wat as 'n relatiewe pad soos ./img/chart.png geskryf is, het niks om na te wys nie. Skakel beelde met hul volle https://-adres, of plak die teks in 'n dokument wat die prente bevat en skakel dit eerder om.

Kan ek notas omskakel wat uit Obsidian of Notion uitgevoer is?

Ja, albei voer standaard .md-lêers uit. Notion sit beelde in 'n aparte vouer, en Obsidian-notas gebruik dikwels [[wiki-skakels]] en inbeddings wat nie standaard Markdown is nie. Verwag dus dat dit as rou teks sal verskyn, en vervang dit eers met gewone skakels.

Kan ek die lettertipe van die Markdown-PDF kies?

Daar is geen lettertipe-instelling nie; die omskakelaar pas 'n leesbare verstek vir lopende teks en 'n vaste-breedte lettertipe vir kode toe. Bladsygrootte, oriëntasie, kantlyne, 'n wagwoord en PDF/A is almal onder Gevorderde instellings beskikbaar.

Moet ek Markdown as PDF of as Word-lêer stuur?

PDF as mense dit moet lees, druk of onderteken soos dit is. As 'n beoordelaar die teks met nagespoorde veranderinge wil wysig, gee Markdown na Word 'n wysigbare dokument met dieselfde opskrifte en lyste.