pandoc - Online in de cloud

PROGRAMMA:

NAAM

pandoc - algemene markup-converter

KORTE INHOUD

pandoc [opties] [Invoer bestand] ...

PRODUCTBESCHRIJVING

Pandoc is een Haskell-bibliotheek voor het converteren van het ene markup-formaat naar het andere, en een
opdrachtregelprogramma dat deze bibliotheek gebruikt. Het kan Markdown, CommonMark, PHP Markdown lezen
Extra, GitHub-Flavored Markdown en (subsets van) Textile, reStructuredText, HTML, LaTeX,
MediaWiki-opmaak, TWiki-opmaak, Haddock-opmaak, OPML, Emacs Org-modus, DocBook, txt2tags,
EPUB, ODT en Word-docx; en het kan platte tekst schrijven, Markdown, CommonMark, PHP Markdown
Extra, Markdown met GitHub-smaak, reStructuredText, XHTML, HTML5, LaTeX (inclusief beamer
diavoorstellingen), ConTeXt, RTF, OPML, DocBook, OpenDocument, ODT, Word docx, GNU Texinfo,
MediaWiki-opmaak, DokuWiki-opmaak, Haddock-opmaak, EPUB (v2 of v3), FictionBook2, Textiel,
groff man-pagina's, Emacs Org-modus, AsciiDoc, InDesign ICML en Slidy, Slideous, DZSlides,
onthullen.js of S5 HTML-diavoorstellingen. Het kan ook PDF-uitvoer produceren op systemen waarop LaTeX,
ConTeXt of wkhtmltopdf is geïnstalleerd.

Pandoc's verbeterde versie van Markdown bevat syntaxis voor voetnoten, tabellen, flexibel
geordende lijsten, definitielijsten, afgeschermde codeblokken, superscript en subscript,
doorhalen, metadatablokken, automatische inhoudsopgaven, ingesloten LaTeX-wiskunde, citaten,
en Markdown binnen HTML-blokelementen. (Deze verbeteringen, die hieronder worden beschreven onder
Pandoc's Markdown kan worden uitgeschakeld met behulp van het invoer- of uitvoerformaat markdown_strict.)

In tegenstelling tot de meeste bestaande tools voor het converteren van Markdown naar HTML, die regex gebruiken
vervangingen, heeft pandoc een modulair ontwerp: het bestaat uit een set lezers, die parseren
tekst in een bepaald formaat en produceer een native weergave van het document, en een set van
schrijvers, die deze native representatie omzetten in een doelformaat. Dus het toevoegen van een
invoer- of uitvoerformaat vereist alleen het toevoegen van een lezer of schrijver.

Omdat pandoc's tussentijdse weergave van een document minder expressief is dan veel andere
de formaten waartussen het converteert, men mag geen perfecte conversies tussen elk verwachten
formaat en elke andere. Pandoc probeert de structurele elementen van een
document, maar geen opmaakdetails zoals margegrootte. En enkele documentelementen,
zoals complexe tabellen, passen mogelijk niet in het eenvoudige documentmodel van Pandoc. Terwijl
conversies van Pandoc's Markdown naar alle formaten streven ernaar perfect te zijn, conversies van
formaten die expressiever zijn dan Pandoc's Markdown kunnen naar verwachting lossy zijn.

gebruik pandoc
Zo nee Invoer bestand is opgegeven, wordt de invoer gelezen stdin. Anders de invoerbestanden zijn
aaneengeschakeld (met een lege regel ertussen) en gebruikt als invoer. Uitvoer gaat naar stdout by
standaard (hoewel uitvoer naar stdout is uitgeschakeld voor de odt-, docx-, epub- en epub3-uitvoer
formaten). Gebruik voor uitvoer naar een bestand de optie -o:

pandoc -o uitvoer.html invoer.txt

Pandoc produceert standaard een documentfragment, geen op zichzelf staand document met een proper
koptekst en voettekst. Gebruik de vlag -s of --standalone om een ​​zelfstandig document te maken:

pandoc -s -o uitvoer.html invoer.txt

Zie Sjablonen hieronder voor meer informatie over hoe zelfstandige documenten worden geproduceerd.

In plaats van een bestand kan een absolute URI worden opgegeven. In dit geval zal pandoc het
inhoud met behulp van HTTP:

pandoc -f html -t prijsverlaging http://www.fsf.org

Als er meerdere invoerbestanden worden gegeven, zal pandoc ze allemaal samenvoegen (met lege regels
tussen hen) vóór het parseren. Deze functie is uitgeschakeld voor binaire invoerformaten zoals
EPUB, odt en docx.

Het formaat van de invoer en uitvoer kan expliciet worden opgegeven met behulp van opdrachtregelopties.
Het invoerformaat kan worden opgegeven met de opties -r/--read of -f/--from, de uitvoer
formatteren met de opties -w/--write of -t/--to. Dus om hello.txt van Markdown te converteren
naar LaTeX, zou je kunnen typen:

pandoc -f markdown -t latex hallo.txt

Om hello.html van HTML naar Markdown te converteren:

pandoc -f html -t markdown hallo.html

Ondersteunde uitvoerformaten staan ​​hieronder vermeld onder de optie -t/--to. Ondersteunde invoer
formaten staan ​​hieronder vermeld onder de optie -f/--from. Merk op dat de eerste, textiel, latex,
en html-lezers zijn niet compleet; er zijn enkele constructies die ze niet ontleden.

Als het invoer- of uitvoerformaat niet expliciet is gespecificeerd, zal pandoc proberen het te raden
van de extensies van de invoer- en uitvoerbestandsnamen. Zo kunnen bijv.

pandoc -o hallo.tex hallo.txt

zal hello.txt van Markdown naar LaTeX converteren. Als er geen uitvoerbestand is opgegeven (zodat
uitgang gaat naar stdout), of als de extensie van het uitvoerbestand onbekend is, het uitvoerformaat
wordt standaard ingesteld op HTML. Als er geen invoerbestand is opgegeven (zodat de invoer afkomstig is van stdin), of
als de extensies van de invoerbestanden onbekend zijn, wordt aangenomen dat het invoerformaat dat is
Markdown tenzij expliciet gespecificeerd.

Pandoc gebruikt de UTF-8-tekencodering voor zowel invoer als uitvoer. Als je lokale
tekencodering is geen UTF-8, u moet invoer en uitvoer door iconv leiden:

iconv -t utf-8 invoer.txt | pandoc | iconv -f utf-8

Merk op dat in sommige uitvoerformaten (zoals HTML, LaTeX, ConTeXt, RTF, OPML, DocBook en
Texinfo), informatie over de tekencodering is opgenomen in de documentkop,
die alleen wordt opgenomen als u de optie -s/--standalone gebruikt.

Wij creëren a PDF
Om een ​​PDF te maken, geeft u een uitvoerbestand op met de extensie .pdf. Pandoc zal dat standaard doen
gebruik LaTeX om het naar PDF te converteren:

pandoc-test.txt -o-test.pdf

Voor de productie van een PDF moet een LaTeX-engine zijn geïnstalleerd (zie --latex-engine hieronder),
en gaat ervan uit dat de volgende LaTeX-pakketten beschikbaar zijn: amsfonts, amsmath, lm,
ifxetex, ifluatex, eurosym, listings (als de optie --listings wordt gebruikt), fancyvrb,
longtable, booktabs, graphicx en grffile (als het document afbeeldingen bevat), hyperref,
ulem, geometrie (met de variabele geometrie ingesteld), setspace (met linestretch) en babel
(met lang). Het gebruik van xelatex of lualatex als LaTeX-engine vereist fontspec;
xelatex gebruikt mathspec, polyglossia (met lang), xecjk en bidi (met de variabele dir
set). De pakketten upquote en microtype worden gebruikt, indien beschikbaar, en csquotes worden gebruikt
voor slimme interpunctie indien toegevoegd aan de sjabloon of opgenomen in een headerbestand. De
natbib-, biblatex-, bibtex- en biber-pakketten kunnen optioneel worden gebruikt voor citatie
weergave. Deze zijn inbegrepen bij alle recente versies van TeX Live.

Als alternatief kan pandoc ConTeXt of wkhtmltopdf gebruiken om een ​​PDF te maken. Geef hiervoor op
een uitvoerbestand met de extensie .pdf, zoals eerder, maar voeg -t context of -t html5 toe aan het
opdrachtregel.

PDF-uitvoer kan worden beheerd met behulp van variabelen voor LaTeX (als LaTeX wordt gebruikt) en variabelen
voor ConTeXt (als ConTeXt wordt gebruikt). Als wkhtmltopdf wordt gebruikt, dan zijn de variabelen margin-left,
margin-right, margin-top, margin-bottom en papersize hebben ook invloed op de uitvoer
--css.

OPTIES

Snel naar opties
-f FORMAT, -r FORMAT, --van=FORMAT, --lees=FORMAT
Geef het invoerformaat op. FORMAT kan native zijn (native Haskell), json (JSON-versie van
native AST), markdown (pandoc's uitgebreide Markdown), markdown_strict (original
niet-uitgebreide Markdown), markdown_phpextra (PHP Markdown Extra), markdown_github
(GitHub-Flavored Markdown), commonmark (CommonMark Markdown), textiel (textiel),
eerste (reStructuredText), html (HTML), docbook (DocBook), t2t (txt2tags), docx
(docx), odt (ODT), epub (EPUB), opml (OPML), org (Emacs Org-modus), mediawiki
(MediaWiki markup), twiki (TWiki markup), schelvis (Haddock markup) of latex
(Latex). Als +lhs wordt toegevoegd aan markdown, rst, latex of html, is de invoer
behandeld als geletterde Haskell-bron: zie Geletterde Haskell-ondersteuning hieronder. Markdown
syntaxisextensies kunnen afzonderlijk worden in- of uitgeschakeld door +EXTENSION toe te voegen
of -EXTENSION voor de formaatnaam. Dus bijvoorbeeld
markdown_strict+footnotes+definition_lists is strikt Markdown met voetnoten en
definitielijsten ingeschakeld, en markdown-pipe_tables+hard_line_breaks is van Pandoc
Markdown zonder pijptabellen en met harde regeleinden. Zie de Markdown van Pandoc,
hieronder voor een lijst met extensies en hun namen.

-t FORMAT, -w FORMAT, --naar=FORMAT, --schrijven=FORMAT
Geef het uitvoerformaat op. FORMAT kan native zijn (native Haskell), json (JSON-versie
van native AST), platte tekst (platte tekst), markdown (pandoc's uitgebreide Markdown),
markdown_strict (oorspronkelijke niet-uitgebreide Markdown), markdown_phpextra (PHP Markdown
Extra), markdown_github (Markdown met GitHub-smaak), commonmark (CommonMark
Markdown), eerst (reStructuredText), html (XHTML), html5 (HTML5), latex (LaTeX),
beamer (LaTeX beamer diashow), context (ConTeXt), man (groff man), mediawiki
(MediaWiki markup), dokuwiki (DokuWiki markup), textiel (Textiel), org (Emacs Org
modus), texinfo (GNU Texinfo), opml (OPML), docbook (DocBook), opendocument
(OpenDocument), odt (OpenOffice-tekstdocument), docx (Word docx), schelvis (Haddock
opmaak), rtf (rich text-indeling), epub (EPUB v2-boek), epub3 (EPUB v3), fb2
(FictionBook2 e-book), asciidoc (AsciiDoc), icml (InDesign ICML), slide (Slidy HTML
en javascript diashow), slideous (Slideous HTML en javascript diashow),
dzslides (DZSlides HTML5 + javascript diashow), revealjs (reveal.js HTML5 +
javascript diavoorstelling), s5 (S5 HTML en javascript diavoorstelling), of het pad van een
aangepaste lua-schrijver (zie Aangepaste schrijvers hieronder). Merk op dat odt, epub en epub3
output zal niet worden omgeleid naar stdout; een uitvoerbestandsnaam moet worden opgegeven met behulp van
de uitvoeroptie -o/--. Als +lhs wordt toegevoegd aan markdown, rst, latex, beamer, html,
of html5, wordt de uitvoer weergegeven als geletterde Haskell-bron: zie Literate
Haskell-ondersteuning, hieronder. Markdown-syntaxisextensies kunnen afzonderlijk worden ingeschakeld of
uitgeschakeld door +EXTENSION of -EXTENSION toe te voegen aan de formaatnaam, zoals beschreven
boven onder -f.

-o FILE, --uitvoer=FILE
Schrijf uitvoer naar FILE in plaats van stdout. Indien FILE is -, uitvoer gaat naar stdout.
(Uitzondering: als het uitvoerformaat odt, docx, epub of epub3 is, is uitvoer naar stdout
gehandicapt.)

--gegevensmap=DIRECTORY
Specificeer de map met gebruikersgegevens om te zoeken naar Pandoc-gegevensbestanden. Als deze optie is
niet opgegeven, wordt de standaard gebruikersgegevensdirectory gebruikt. Dit is, in Unix:

$HOME/.pandoc

in WindowsXP:

C:\Documents And Settings\GEBRUIKERSNAAM\Application Data\pandoc

en in Windows Vista of hoger:

C:\Gebruikers\GEBRUIKERSNAAM\AppData\Roaming\pandoc

U kunt de standaardmap met gebruikersgegevens op uw systeem vinden door te kijken naar de
uitvoer van pandoc --version. Een reference.odt, reference.docx, epub.css, sjablonen,
slidey, slideous of s5-directory die in deze directory wordt geplaatst, zal pandoc's overschrijven
normale standaardwaarden.

--bash-voltooiing
Genereer een bash-voltooiingsscript. Voeg dit toe om bash-voltooiing met pandoc in te schakelen
naar je .bashrc:

eval "$(pandoc --bash-completion)"

--uitgebreid
Geef uitgebreide uitvoer voor foutopsporing. Momenteel heeft dit alleen effect bij PDF-uitvoer.

-in, --versie
Gedrukte versie.

-H, --help
Toon gebruiksmelding.

Lezer opties
-R, --ontleed-rauw
Parseer onvertaalbare HTML-codes en LaTeX-omgevingen als onbewerkte HTML of LaTeX,
in plaats van ze te negeren. Heeft alleen invloed op HTML- en LaTeX-invoer. Ruwe HTML kan zijn
gedrukt in Markdown, reStructuredText, HTML, Slidy, Slideous, DZSlides, reveal.js,
en S5-uitvoer; raw LaTeX kan worden afgedrukt in Markdown, reStructuredText, LaTeX en
ConTeXt-uitvoer. De standaard is dat de lezers onvertaalbare HTML-codes weglaten
en LaTeX-omgevingen. (De LaTeX-lezer gaat door onvertaalbaar LaTeX
commando's, zelfs als -R niet is opgegeven.)

-S, --slim
Produceer typografisch correcte uitvoer, converteer rechte aanhalingstekens naar gekrulde aanhalingstekens,
--- naar em-streepjes, -- naar en-streepjes, en ... naar ellipsen. Niet-afbrekende spaties zijn
ingevoegd na bepaalde afkortingen, zoals "Mr." (Opmerking: deze optie is geselecteerd
automatisch wanneer het uitvoerformaat latex of context is, tenzij --no-tex-ligatures
is gebruikt. Het heeft geen effect op latexinvoer.)

--oude streepjes
Selecteert het pandoc <= 1.8.2.1-gedrag voor het ontleden van slimme streepjes: - voor een cijfer
is een en-streepje, en -- is een em-streepje. Deze optie is automatisch geselecteerd voor
textiel invoer.

--base-header-niveau=NUMMER
Specificeer het basisniveau voor kopteksten (standaard ingesteld op 1).

--ingesprongen-codeklassen=KLASSEN
Geef klassen op die moeten worden gebruikt voor ingesprongen codeblokken, bijvoorbeeld perl, numberLines of
haskel. Meerdere klassen kunnen worden gescheiden door spaties of komma's.

--standaard-afbeelding-extensie=UITBREIDING
Geef een standaardextensie op die moet worden gebruikt wanneer afbeeldingspaden/-URL's geen extensie hebben. Dit
stelt u in staat om dezelfde bron te gebruiken voor formaten die verschillende soorten
afbeeldingen. Momenteel is deze optie alleen van invloed op de Markdown- en LaTeX-lezers.

--filter =UITVOERBAAR
Geef een uitvoerbaar bestand op dat moet worden gebruikt als een filter dat de pandoc AST transformeert na het
invoer wordt geparseerd en voordat de uitvoer wordt geschreven. Het uitvoerbare bestand moet JSON lezen
van stdin en schrijf JSON naar stdout. De JSON moet geformatteerd zijn zoals die van Pandoc
JSON-invoer en -uitvoer. De naam van het uitvoerformaat wordt doorgegeven aan het filter
als eerste argument. Vandaar,

pandoc --filter ./caps.py -t latex

is gelijk aan

pandoc -t json | ./caps.py latex | pandoc -f json -t latex

De laatste vorm kan handig zijn voor het debuggen van filters.

Filters kunnen in elke taal worden geschreven. Text.Pandoc.JSON exporteert naarJSONFilter naar
vergemakkelijken het schrijven van filters in Haskell. Degenen die er liever filters in schrijven
python kan de module pandocfilters gebruiken, te installeren vanuit PyPI. Er zijn ook
pandoc-filterbibliotheken in PHP, perl en javascript/node.js.

Merk op dat de UITVOERBAAR zal worden gezocht in het PATH van de gebruiker, en niet in de working
directory, als er geen directory is opgegeven. Als u een script wilt uitvoeren in de working
directory, laat de bestandsnaam voorafgaan door ./.

-M KEY[=VAL], --metagegevens=KEY[:VAL]
Stel het metadataveld in KEY naar de waarde VAL. Een waarde die is opgegeven op de opdrachtregel
overschrijft een waarde die in het document is opgegeven. Waarden worden geparseerd als YAML boolean
of tekenreekswaarden. Als er geen waarde is opgegeven, wordt de waarde behandeld als Booleaans
WAAR. Net als --variable zorgt --metadata ervoor dat sjabloonvariabelen worden ingesteld. Maar niet zoals
--variable, --metadata beïnvloedt de metadata van het onderliggende document (dat is
toegankelijk via filters en kan in sommige uitvoerformaten worden afgedrukt).

--normaliseren
Normaliseer het document na het lezen: voeg aangrenzende Str- of Emph-elementen samen, bijvoorbeeld
bijvoorbeeld, en verwijder herhaalde spaties.

-P, --preserve-tabbladen
Behoud tabbladen in plaats van ze naar spaties te converteren (standaard). Merk op dat dit
heeft alleen invloed op tabbladen in letterlijke codereeksen en codeblokken; tabbladen in gewone tekst
worden behandeld als spaties.

--tab-stop=NUMMER
Geef het aantal spaties per tabblad op (standaard is 4).

--track-changes=accepteren|weigeren|alles
Specificeert wat er moet gebeuren met invoegingen en verwijderingen geproduceerd door het MS Word "Track
Wijzigingen". Accepteer (standaard), voegt alle invoegingen in en negeert alles
verwijderingen. weigeren voegt alle verwijderingen in en negeert invoegingen. all zet beide in
inserties en deleties, verpakt in reeksen met insertie- en deletieklassen,
respectievelijk. De auteur en het tijdstip van wijziging zijn inbegrepen. alles is nuttig voor
scripting: alleen wijzigingen accepteren van bijvoorbeeld een bepaalde recensent of voor een bepaalde
datum. Deze optie is alleen van invloed op de docx-lezer.

--extract-media=DIR
Extraheer afbeeldingen en andere media in een docx- of epub-container naar het pad
DIR, maak het indien nodig aan en pas de afbeeldingsreferenties in het document zo aan
ze wijzen naar de uitgepakte bestanden. Deze optie is alleen van invloed op de docx en epub
lezers.

Snel naar schrijver opties
-Ja, --zelfstandig
Produceer uitvoer met een geschikte kop- en voettekst (bijvoorbeeld een op zichzelf staande HTML,
LaTeX, of RTF-bestand, geen fragment). Deze optie wordt automatisch ingesteld voor pdf,
epub-, epub3-, fb2-, docx- en odt-uitvoer.

--sjabloon=FILE
Te gebruiken FILE als aangepaste sjabloon voor het gegenereerde document. Impliceert --zelfstandig.
Zie Sjablonen hieronder voor een beschrijving van de sjabloonsyntaxis. Als er geen verlenging is
opgegeven, wordt een extensie die overeenkomt met de schrijver toegevoegd, zodat
--template=speciaal zoekt naar special.html voor HTML-uitvoer. Als de sjabloon dat niet is
gevonden, zal pandoc ernaar zoeken in de templates-subdirectory van de gebruikersgegevens
directory (zie --data-dir). Als deze optie niet wordt gebruikt, een standaardsjabloon
geschikt voor het uitvoerformaat zal worden gebruikt (zie -D/--print-default-template).

-V KEY[=VAL], --variabele=KEY[:VAL]
Stel de sjabloonvariabele in KEY naar de waarde VAL bij het weergeven van het document
zelfstandige modus. Dit is over het algemeen alleen nuttig wanneer de optie --template wordt gebruikt
om een ​​aangepast sjabloon op te geven, aangezien pandoc automatisch de variabelen instelt die worden gebruikt in
de standaard sjablonen. Als Nee VAL is opgegeven, krijgt de sleutel de waarde
waar.

-D FORMAT, --print-standaard-sjabloon=FORMAT
Druk de standaardsjabloon van het systeem af voor een uitvoer FORMAT. (Zie -t voor een lijst van
mogelijk FORMATs.) Sjablonen in de directory met gebruikersgegevens worden genegeerd.

--print-standaard-gegevensbestand=FILE
Druk een systeemstandaardgegevensbestand af. Bestanden in de map met gebruikersgegevens worden genegeerd.

--dpi=NUMMER
Geef de dpi-waarde (dots per inch) op voor conversie van pixels naar
inch/centimeter en vice versa. De standaardwaarde is 96 dpi. Technisch gezien de juiste
term zou ppi (pixels per inch) zijn.

--wrap=[auto|geen|behouden]
Bepaal hoe tekst wordt ingepakt in de uitvoer (de broncode, niet de gerenderde
versie). Met auto (de standaardinstelling) probeert pandoc regels naar de kolom te laten lopen
breedte gespecificeerd door --columns (standaard 80). Als er geen is, zal Pandoc geen lijnen omwikkelen
helemaal niet. Met bewaren probeert Pandoc de verpakking van het
brondocument (dat wil zeggen, waar er niet-semantische nieuwe regels in de bron zijn, daar
zullen ook niet-semantische nieuwe regels in de uitvoer zijn).

--geen-omslag
Verouderd synoniem voor --wrap=none.

--kolommen=NUMMER
Specificeer de lengte van regels in tekens (voor tekstterugloop). Dit betreft alleen de
gegenereerde broncode, niet de lay-out op de weergegeven pagina.

--toc, --inhoudsopgave
Voeg een automatisch gegenereerde inhoudsopgave toe (of, in het geval van latex,
context, en eerst een instructie om er een te maken) in het uitvoerdocument. Dit
optie heeft geen effect op de uitvoer van man, docbook, slidy, slideous, s5, docx of odt.

--toc-diepte=NUMMER
Geef het aantal sectieniveaus op dat in de inhoudsopgave moet worden opgenomen. De
standaard is 3 (wat betekent dat de kopteksten van niveau 1, 2 en 3 worden weergegeven in de
inhoud).

--geen-hoogtepunt
Schakelt syntaxisaccentuering uit voor codeblokken en inlines, zelfs wanneer een taal
attribuut wordt gegeven.

--highlight-stijl=STIJL
Specificeert de kleurstijl die moet worden gebruikt in de gemarkeerde broncode. Opties zijn
pygments (standaard), kate, monochroom, espresso, zenburn, schelvis en tango.
Voor meer informatie over syntaxisaccentuering in Pandoc, zie Syntaxisaccentuering,
hieronder.

-H FILE, --include-in-header=FILE
Inclusief inhoud van FILE, letterlijk, aan het einde van de koptekst. Deze kan gebruikt worden,
bijvoorbeeld om speciale CSS of javascript in HTML-documenten op te nemen. Deze optie
kan herhaaldelijk worden gebruikt om meerdere bestanden in de koptekst op te nemen. Zij zullen zijn
opgenomen in de opgegeven volgorde. Impliceert --zelfstandig.

-B FILE, --include-before-body=FILE
Inclusief inhoud van FILE, letterlijk, aan het begin van de documenttekst (bijv
na de tag in HTML, of het commando \begin{document} in LaTeX). Dit kan
worden gebruikt om navigatiebalken of banners in HTML-documenten op te nemen. Deze optie kan
herhaaldelijk worden gebruikt om meerdere bestanden op te nemen. Deze worden bij de bestelling gevoegd
opgegeven. Impliceert --zelfstandig.

-A FILE, --include-after-body=FILE
Inclusief inhoud van FILE, letterlijk, aan het einde van de documenttekst (vóór de
tag in HTML, of het commando \end{document} in LaTeX). Deze optie kan zijn
herhaaldelijk worden gebruikt om meerdere bestanden op te nemen. Deze worden bij de bestelling gevoegd
opgegeven. Impliceert --zelfstandig.

Opties die van invloed specifiek schrijvers
--op zichzelf staand
Maak een zelfstandig HTML-bestand zonder externe afhankelijkheden, met behulp van data: URI's naar
de inhoud van gekoppelde scripts, stylesheets, afbeeldingen en video's opnemen. De
resulterende bestand zou "op zichzelf staand" moeten zijn, in die zin dat het geen extern bestand nodig heeft
bestanden en geen internettoegang om correct door een browser te worden weergegeven. Deze optie werkt
alleen met HTML-uitvoerindelingen, waaronder html, html5, html+lhs, html5+lhs, s5,
slide, slideous, dzslides en revealjs. Scripts, afbeeldingen en stylesheets op
absolute URL's worden gedownload; die op relatieve URL's zullen relatief worden gezocht
de werkmap (als het eerste bronbestand lokaal is) of relatief ten opzichte van de basis
URL (als het eerste bronbestand extern is). Beperking: bronnen die zijn geladen
dynamisch via JavaScript kan niet worden opgenomen; als gevolg,
--self-contained werkt niet met --mathjax, en sommige geavanceerde functies (bijv
zoom- of sprekernotities) werken mogelijk niet in een offline "op zichzelf staande" dia Reveal.js
tonen.

--html-q-tags
Gebruik tags voor aanhalingstekens in HTML.

--ascii
Gebruik alleen ascii-tekens in de uitvoer. Momenteel alleen ondersteund voor HTML-uitvoer
(die numerieke entiteiten gebruikt in plaats van UTF-8 wanneer deze optie is geselecteerd).

--referentie-links
Gebruik referentie-achtige links, in plaats van inline links, in het schrijven van Markdown of
hergestructureerde tekst. Standaard worden inline links gebruikt.

--atx-headers
Gebruik headers in ATX-stijl in Markdown- en asciidoc-uitvoer. De standaard is om te gebruiken
headers in setext-stijl voor niveaus 1-2 en vervolgens ATX-headers.

--hoofdstukken
Behandel kopteksten op het hoogste niveau als hoofdstukken in LaTeX-, ConTeXt- en DocBook-uitvoer. Wanneer
de LaTeX-documentklasse is ingesteld op rapport, boek of memoires, is deze optie geïmpliceerd.
Als beamer het uitvoerformaat is, worden kopteksten op het hoogste niveau \part{..}.

-N, --nummer-secties
Nummer sectiekoppen in LaTeX-, ConTeXt-, HTML- of EPUB-uitvoer. Standaard,
secties zijn niet genummerd. Secties met klasse ongenummerd zullen nooit genummerd zijn,
zelfs als --number-sections is opgegeven.

--nummer-offset=NUMMER[,NUMMER,...]
Offset voor sectiekoppen in HTML-uitvoer (genegeerd in andere uitvoerformaten). De
het eerste nummer wordt toegevoegd aan het sectienummer voor kopteksten op het hoogste niveau, het tweede voor
kopteksten op het tweede niveau, enzovoort. Dus als u bijvoorbeeld het eerste topniveau wilt
koptekst in uw document nummer "6" te geven, specificeer --number-offset=5. Als jouw
document begint met een koptekst van niveau 2 die u nummer "1.5" wilt geven, specificeer
--getal-offset=1,4. Offsets zijn standaard 0. Impliceert --getal-secties.

--geen-tex-ligaturen
Gebruik de TeX-ligaturen niet voor aanhalingstekens, apostrofs en streepjes (`...',
``..'', --, ---) bij het schrijven of lezen van LaTeX of ConTeXt. Bij het lezen van LaTeX, parse
de karakters `, ', en - letterlijk, in plaats van ligaturen te ontleden voor aanhalingstekens
markeringen en streepjes. Als u LaTeX of ConTeXt schrijft, drukt u unicode-aanhalingsteken en af
streepjes letterlijk, in plaats van ze om te zetten naar de standaard ASCII TeX
ligaturen. Opmerking: normaal wordt --smart automatisch geselecteerd voor LaTeX en ConTeXt
uitvoer, maar het moet expliciet worden gespecificeerd als --no-tex-ligatures is geselecteerd. Als
je letterlijke gekrulde aanhalingstekens, streepjes en weglatingstekens gebruikt in je bron, dan mag dat
wil --no-tex-ligaturen gebruiken zonder --smart.

--vermeldingen
Gebruik het listingpakket voor LaTeX-codeblokken

-l, --toenemend
Zorg ervoor dat lijstitems in diavoorstellingen stapsgewijs worden weergegeven (één voor één). De standaardwaarde is
om lijsten allemaal tegelijk weer te geven.

--slide-niveau=NUMMER
Specificeert dat kopteksten met het opgegeven niveau dia's maken (voor beamer, s5,
glibberig, glibberig, dzslides). Headers boven dit niveau in de hiërarchie zijn gewend
verdeel de diavoorstelling in secties; koppen onder dit niveau creëren subkoppen
binnen een dia. De standaardinstelling is om het dianiveau in te stellen op basis van de inhoud van de
document; zie De diavoorstelling structureren.

--sectie-divs
Wikkel secties in labels (of tags in HTML5) en voeg identifiers toe aan
de omhulling (of ) in plaats van de koptekst zelf. Zie Koptekst
identifiers, hieronder.

--email-obfuscation=geen|javascript|referenties
Geef een methode op voor het verbergen van mailto:-koppelingen in HTML-documenten. niemand vertrekt
mailto: links zoals ze zijn. javascript verdoezelt ze met behulp van javascript.
verwijzingen verdoezelen ze door hun letters als decimaal of hexadecimaal af te drukken
karakter referenties. De standaard is javascript.

--id-voorvoegsel=STRING
Geef een voorvoegsel op dat moet worden toegevoegd aan alle automatisch gegenereerde identifiers in HTML en
DocBook-uitvoer en naar voetnootnummers in Markdown-uitvoer. Dit is handig voor
het voorkomen van dubbele identifiers bij het genereren van fragmenten die in andere moeten worden opgenomen
bladzijden.

-T STRING, --title-voorvoegsel=STRING
Specificeren STRING als voorvoegsel aan het begin van de titel die in de HTML verschijnt
header (maar niet in de titel zoals deze wordt weergegeven aan het begin van de HTML-body).
Impliceert --zelfstandig.

-c URL, --css=URL
Link naar een CSS-stylesheet. Deze optie kan herhaaldelijk worden gebruikt om op te nemen
meerdere bestanden. Ze zullen worden opgenomen in de opgegeven volgorde.

--referentie-odt=FILE
Gebruik het opgegeven bestand als stijlreferentie bij het maken van een ODT. Voor de beste resultaten,
de referentie-ODT moet een gewijzigde versie zijn van een ODT die is geproduceerd met pandoc.
De inhoud van de referentie-ODT wordt genegeerd, maar de stylesheets worden gebruikt in de
nieuwe ODT. Als er geen referentie-ODT is opgegeven op de opdrachtregel, zal pandoc kijken
voor een bestand reference.odt in de map met gebruikersgegevens (zie --data-dir). Als dit is
ook niet gevonden, worden verstandige standaardwaarden gebruikt.

--referentie-docx=FILE
Gebruik het opgegeven bestand als stijlreferentie bij het maken van een docx-bestand. Voor het beste
resultaten, moet de referentie-docx een gewijzigde versie zijn van een geproduceerd docx-bestand
pandoc gebruiken. De inhoud van de referentie docx wordt genegeerd, maar de stylesheets
en documenteigenschappen (inclusief marges, paginaformaat, kop- en voettekst) worden gebruikt
in de nieuwe docx. Als er geen referentie docx is opgegeven op de opdrachtregel, wordt pandoc
zoekt naar een bestand reference.docx in de map met gebruikersgegevens (zie --data-dir).
Als ook deze niet wordt gevonden, worden verstandige standaardwaarden gebruikt. De volgende stijlen
worden gebruikt door pandoc: [alinea] Normal, Body Text, First Paragraph, Compact, Title,
Ondertitel, Auteur, Datum, Samenvatting, Bibliografie, Kop 1, Kop 2, Kop 3,
Kop 4, Kop 5, Kop 6, Bloktekst, Voetnoottekst, Definitieterm,
Definitie, bijschrift, tabelbijschrift, afbeeldingbijschrift, figuur, figuur met bijschrift, inhoudsopgave
rubriek; [teken] Standaard alinealettertype, hoofdtekstteken, verbatimteken,
Voetnootverwijzing, hyperlink; [tabel] Normale tafel.

--epub-stylesheet=FILE
Gebruik het opgegeven CSS-bestand om de EPUB op te maken. Als er geen stylesheet is opgegeven,
pandoc zoekt naar een bestand epub.css in de map met gebruikersgegevens (zie --data-dir).
Als het daar niet wordt gevonden, worden verstandige standaardwaarden gebruikt.

--epub-omslagafbeelding=FILE
Gebruik de opgegeven afbeelding als de EPUB-omslag. Het wordt aanbevolen dat de afbeelding wordt
minder dan 1000px in breedte en hoogte. Merk op dat u in een Markdown-brondocument u
kan ook een omslagafbeelding specificeren in een YAML-metadatablok (zie EPUB-metadata hieronder).

--epub-metadata=FILE
Zoek in het opgegeven XML-bestand naar metadata voor de EPUB. Het bestand moet bevatten
een reeks Dublin Core-elementen. Bijvoorbeeld:

Creatieve Commons
es-AR

Pandoc zal standaard de volgende metadata-elementen bevatten: (van
de documenttitel), (van de auteurs van het document), (van de
documentdatum, die in ISO 8601-indeling moet zijn), (uit het lang
variabele, of, als deze niet is ingesteld, de landinstelling), en (A
willekeurig gegenereerde UUID). Elk van deze kan worden overschreven door elementen in de
metadata-bestand.

Opmerking: als het brondocument Markdown is, kan een YAML-metadatablok in het document
in plaats daarvan worden gebruikt. Zie hieronder onder EPUB-metadata.

--epub-embed-font=FILE
Sluit het opgegeven lettertype in de EPUB in. Deze optie kan worden herhaald om in te sluiten
meerdere lettertypen. Er kunnen ook wildcards worden gebruikt: bijvoorbeeld DejaVuSans-*.ttf.
Als u echter jokertekens gebruikt op de opdrachtregel, zorg er dan voor dat u deze escape of put
de hele bestandsnaam tussen enkele aanhalingstekens, om te voorkomen dat ze worden geïnterpreteerd door de
schelp. Om de ingesloten lettertypen te gebruiken, moet u declaraties toevoegen zoals de
volgen naar uw CSS (zie --epub-stylesheet):

@lettertype {
font-familie: DejaVuSans;
lettertype: normaal;
font-weight: normaal;
src:url("DejaVuSans-Regular.ttf");
}
@lettertype {
font-familie: DejaVuSans;
lettertype: normaal;
font-weight: bold;
src:url("DejaVuSans-Bold.ttf");
}
@lettertype {
font-familie: DejaVuSans;
lettertype-stijl: cursief;
font-weight: normaal;
src:url("DejaVuSans-Oblique.ttf");
}
@lettertype {
font-familie: DejaVuSans;
lettertype-stijl: cursief;
font-weight: bold;
src:url("DejaVuSans-BoldOblique.ttf");
}
body { font-family: "DejaVuSans"; }

--epub-hoofdstuk-niveau=NUMMER
Geef het koptekstniveau op waarop de EPUB moet worden gesplitst in afzonderlijke "hoofdstuk"-bestanden.
De standaard is om te splitsen in hoofdstukken op niveau 1 kopteksten. Deze optie is alleen van invloed
de interne samenstelling van de EPUB, niet de manier waarop hoofdstukken en secties zijn
getoond aan gebruikers. Sommige lezers kunnen traag zijn als de hoofdstukbestanden te groot zijn,
dus voor grote documenten met weinig kopteksten van niveau 1, zou men een hoofdstuk willen gebruiken
niveau 2 of 3.

--latex-engine=pdflatex|lualatex|xelatex
Gebruik de opgegeven LaTeX-engine bij het produceren van PDF-uitvoer. De standaard is pdflatex.
Als de engine niet in uw PATH staat, kan het volledige pad van de engine worden opgegeven
hier.

--latex-engine-opt=STRING
Gebruik de gegeven string als een opdrachtregelargument voor de latex-engine. Als gebruikt
meerdere keren worden de argumenten voorzien van spaties ertussen. Merk op dat nee
controleren op dubbele opties is voltooid.

Citaat weergave
--bibliografie=FILE
Stel het bibliografieveld in de metadata van het document in op FILE, met voorrang op elke waarde
instellen in de metadata en citaten verwerken met pandoc-citeproc. (Dit is
gelijk aan --metadata bibliography=FILE --filter pandoc-citeproc.) If --natbib
of --biblatex wordt ook geleverd, pandoc-citeproc wordt niet gebruikt, waardoor dit equivalent is
naar --metadata bibliografie=FILE. Als u dit argument meerdere keren opgeeft, wordt elk
FILE zal worden toegevoegd aan de bibliografie.

--csl=FILE
Stel het csl-veld in de metadata van het document in op FILE, met voorrang op elke ingestelde waarde
de metagegevens. (Dit is gelijk aan --metadata csl=FILE.) Deze optie is alleen
relevant met pandoc-citeproc.

--citatie-afkortingen=FILE
Zet het veld citatie-afkortingen in de metadata van het document op FILE, overheersend
elke waarde die is ingesteld in de metadata. (Dit is gelijk aan
--metadata citation-abbreviations=FILE.) Deze optie is alleen relevant bij
pandoc-citeproc.

--natbib
Gebruik natbib voor citaten in LaTeX-uitvoer. Deze optie is niet voor gebruik met de
pandoc-citeproc-filter of met PDF-uitvoer. Het is bedoeld voor gebruik bij het produceren van een
LaTeX-bestand dat kan worden verwerkt met bibtex.

--biblatex
Gebruik biblatex voor citaten in LaTeX-uitvoer. Deze optie is niet voor gebruik met de
pandoc-citeproc-filter of met PDF-uitvoer. Het is bedoeld voor gebruik bij het produceren van een
LaTeX-bestand dat kan worden verwerkt met bibtex of biber.

Math weergave in HTML
-m [URL], --latexwiskunde[=URL]
Gebruik LaTeXMathML om ingesloten TeX-wiskunde weer te geven in HTML-uitvoer. De URL zou moeten wijzen
naar het laadscript LaTeXMathML.js. Als een URL wordt niet verstrekt, een link naar
LaTeXMathML.js op de startpagina van LaTeXMathML wordt ingevoegd.

--wiskunde[=URL]
Converteer TeX math naar MathML (zowel in docbook als in html en html5). Op zichzelf staand
html-uitvoer, een klein javascript (of een link naar zo'n script als een URL is aangeleverd)
zal worden ingevoegd waardoor de MathML in sommige browsers kan worden bekeken.

--jsmath[=URL]
Gebruik jsMath om ingesloten TeX-wiskunde weer te geven in HTML-uitvoer. De URL zou moeten verwijzen naar
het jsMath load-script (bijv. jsMath/easy/load.js); indien verstrekt, wordt deze gekoppeld
in de header van zelfstandige HTML-documenten. Als een URL wordt niet verstrekt, geen link
naar het jsMath load-script wordt ingevoegd; het is dan aan de auteur om te voorzien
zo'n link in de HTML-template.

--wiskunde[=URL]
Gebruik MathJax om ingesloten TeX-wiskunde weer te geven in HTML-uitvoer. De URL zou moeten verwijzen naar
het laadscript van MathJax.js. Als een URL niet wordt verstrekt, een link naar de MathJax CDN
zal worden ingevoegd.

--gladtex
Sluit TeX wiskunde in tags in HTML-uitvoer. Deze kunnen dan worden verwerkt door
gladTeX om links naar afbeeldingen van de opgezette formules te produceren.

--mimetex[=URL]
Render TeX wiskunde met behulp van het mimeTeX CGI-script. Als URL is niet gespecificeerd, het is
aangenomen dat het script op /cgi-bin/mimetex.cgi staat.

--webtex[=URL]
Geef TeX-formules weer met een extern script dat TeX-formules omzet in afbeeldingen.
De formule wordt samengevoegd met de opgegeven URL. Als URL is niet gespecificeerd,
de Google Chart API zal worden gebruikt.

--katex[=URL]
Gebruik KaTeX om ingebedde TeX-wiskunde weer te geven in HTML-uitvoer. De URL zou moeten wijzen op de
katex.js laadscript. Als een URL niet wordt verstrekt, zal er een link naar het KaTeX CDN zijn
ingebracht.

--katex-stylesheet=URL
De URL moet verwijzen naar het katex.css-stylesheet. Als deze optie niet is opgegeven,
er wordt een link naar de KaTeX CDN ingevoegd. Merk op dat deze optie niet impliceert
--katex.

Opties voor wikkel scripts
--dump-args
Druk informatie over opdrachtregelargumenten af ​​naar stdout, ga dan naar buiten. Deze optie
is voornamelijk bedoeld voor gebruik in wrapper-scripts. De eerste uitvoerregel
bevat de naam van het uitvoerbestand gespecificeerd met de optie -o, of - (voor
stdout) als er geen uitvoerbestand is opgegeven. De overige regels bevatten de
opdrachtregelargumenten, één per regel, in de volgorde waarin ze verschijnen. Deze niet
neem reguliere pandoc-opties en hun argumenten op, maar neem ook eventuele opties op
verschijnen na een scheidingsteken -- aan het einde van de regel.

--negeer argumenten
Negeer opdrachtregelargumenten (voor gebruik in wrapper-scripts). Normale pandoc-opties
worden niet genegeerd. Zo kunnen bijv.

pandoc --ignore-args -o foo.html -s foo.txt -- -e latin1

is gelijk aan

pandoc -o foo.html -s

TEMPLATES

Wanneer de -s/--standalone optie wordt gebruikt, gebruikt pandoc een sjabloon om kop- en voettekst toe te voegen
materiaal dat nodig is voor een op zichzelf staand document. Om de standaardsjabloon te zien die dat is
gebruikt, typ gewoon

pandoc -D *FORMAAT*

WAAR FORMAT is de naam van het uitvoerformaat. Een aangepaste sjabloon kan worden opgegeven met behulp van
de optie --template. U kunt ook de standaardsjablonen van het systeem voor een gegeven overschrijven
uitvoerformaat FORMAT door een bestand templates/default.*FORMAT* in de gebruikersgegevens te plaatsen
directory (zie --data-dir, hierboven). Uitzonderingen: Pas voor odt-uitvoer het
default.opendocument-sjabloon. Pas voor pdf-uitvoer de default.latex-sjabloon aan.

Sjablonen bevatten variabelen, die het opnemen van willekeurige informatie op elk gewenst moment mogelijk maken
punt in het bestand. Variabelen kunnen binnen het document worden ingesteld met behulp van YAML-metadatablokken.
Ze kunnen ook op de opdrachtregel worden ingesteld met de optie -V/--variabele: variabelen worden ingevoerd
op deze manier overschrijven metadatavelden met dezelfde naam.

Variabelen reeks by pandoc
Sommige variabelen worden automatisch ingesteld door Pandoc. Deze variëren enigszins afhankelijk van de
uitvoerformaat, maar inclusief metadatavelden en het volgende:

titel, auteur, gegevens
identificatie van basisaspecten van het document mogelijk maken. Opgenomen in PDF-metadata
via LaTeX en ConTeXt. Deze kunnen worden ingesteld via een Pandoc-titelblok, dat
staat meerdere auteurs toe, of via een YAML-metadatablok:

---
auteur:
- Aristoteles
- Peter Abélard
...

subtitel
ondertiteling van documenten, opgenomen in HTML, EPUB, LaTeX, ConTeXt en Word docx; geeft weer
in LaTeX alleen bij gebruik van een documentklasse die \subtitle ondersteunt, zoals beamer
of de KOMA-Script-serie (scrartcl, scrreprt, scrbook).

abstract
documentsamenvatting, opgenomen in LaTeX, ConTeXt, AsciiDoc en Word docx

trefwoorden
lijst met trefwoorden die moeten worden opgenomen in HTML-, PDF- en AsciiDoc-metadata; misschien
herhaald zoals voor de auteur hierboven

header-inclusief
inhoud gespecificeerd door -H/--include-in-header (kan meerdere waarden hebben)

geval niet-null waarde als --toc/--table-of-contents was gespecificeerd

toc-titel
titel van inhoudsopgave (werkt alleen met EPUB en docx)

omvatten-voor
inhoud gespecificeerd door -B/--include-before-body (kan meerdere waarden hebben)

inclusief-na
inhoud gespecificeerd door -A/--include-after-body (kan meerdere waarden hebben)

lichaam lichaam van document

meta-json
JSON-representatie van alle metadata van het document

Taal variabelen
LANG identificeert de hoofdtaal van het document met behulp van een code volgens BCP 47
(bijv. nl of en-GB). Voor sommige uitvoerformaten zal pandoc het converteren naar een
juiste formaat opgeslagen in de aanvullende variabelen babel-lang, polyglossia-lang
(LaTeX) en contexttaal (ConTeXt).

Eigen Pandoc-reeksen en div's met het lang-attribuut (waarde in BCP 47) kunnen worden gebruikt
om de taal in dat bereik te veranderen.

anders
een lijst met andere talen die in het document worden gebruikt in de YAML-metadata, volgens
BCP 47. Bijvoorbeeld: otherlangs: [en-GB, fr]. Deze wordt automatisch gegenereerd
van de lang-attributen in alle reeksen en div's, maar kan worden overschreven. Momenteel
alleen gebruikt door LaTeX via de gegenereerde babel-otherlangs en
polyglossia-otherlangs variabelen. De LaTeX-schrijver voert polyglossia-opdrachten uit in
de tekst maar de variabele babel-newcommands bevat toewijzingen voor hen aan de
overeenkomstige babel.

dir de basisrichting van het document, hetzij rtl (rechts naar links) of ltr
(van links naar rechts).

Voor bidirectionele documenten, native pandoc-reeksen en div's met het dir-attribuut
(waarde rtl of ltr) kan worden gebruikt om de basisrichting in sommige uitvoer te overschrijven
formaten. Dit is misschien niet altijd nodig als de uiteindelijke renderer (bijvoorbeeld de
browser, bij het genereren van HTML) ondersteunt het Unicode bidirectionele algoritme.

Bij gebruik van LaTeX voor bidirectionele documenten is alleen de xelatex-engine volledig
ondersteund (gebruik --latex-engine=xelatex).

Variabelen voor dia's
Er zijn variabelen beschikbaar voor het maken van diavoorstellingen met pandoc, inclusief alle reveal.js
configuratie opties.

slide-url
basis-URL voor Slidy-documenten (standaard ingesteld op http://www.w3.org/Talks/Tools/Slidy2)

slideous-url
basis-URL voor Slideous-documenten (standaard ingesteld op slideous)

s5-url basis-URL voor S5-documenten (standaard ingesteld op s5/standaard)

onthullenjs-url
basis-URL voor Reveal.js-documenten (standaard is Reveal.js)

thema, kleurenthema, fontthema, innerlijke thema, buitenthema
thema's voor LaTeX beamerdocumenten

navigatie
bestuurt navigatiesymbolen in beamerdocumenten (standaard is leeg voor geen navigatie
symbolen; andere geldige waarden zijn frame, verticaal en horizontaal).

sectie-titels
activeert op "titelpagina's" voor nieuwe secties in beamerdocumenten (standaard = waar).

Variabelen voor Latex
LaTeX-variabelen worden gebruikt bij het maken van een PDF.

papiergrootte
papierformaat, bijv. Letter, A4

lettertypegrootte
lettergrootte voor hoofdtekst (bijv. 10pt, 12pt)

documentklasse
documentklasse, bijv. artikel, rapport, boek, memoires

klasseoptie
optie voor documentklasse, bijv. eenzijdig; kan worden herhaald voor meerdere opties

geometrie
optie voor geometriepakket, bijv. margin=1in; kan worden herhaald voor meerdere opties

marge-links, marge-rechts, marge-top, marge-onder
stelt marges in, als geometrie niet wordt gebruikt (anders overschrijft geometrie deze)

lijnrek
past de regelafstand aan met behulp van het setspace-pakket, bijvoorbeeld 1.25, 1.5

lettertypefamilie
lettertypepakket voor gebruik met pdflatex: TeX Live bevat veel opties, gedocumenteerd in
de LaTeX-lettertypecatalogus. De standaard is Latijns-modern.

lettertypefamilieopties
opties voor pakket gebruikt als lettertypefamilie: bijv. osf,sc met lettertypefamilie ingesteld op
mathpazo voorziet Palatino van ouderwetse figuren en echte kleine kapitalen; misschien
herhaald voor meerdere opties

hoofdlettertype, sansfont, monolettertype, wiskundelettertype, CJKhoofdlettertype
lettertypefamilies voor gebruik met xelatex of lualatex: neem de naam van een willekeurig systeemlettertype,
met behulp van het fontspec-pakket. Merk op dat als CJKmainfont wordt gebruikt, het xecjk-pakket
moet beschikbaar zijn.

mainfontopties, zonder lettertypeopties, monofontopties, mathfontopties, CJK-opties
opties om te gebruiken met mainfont, sansfont, monofont, mathfont, CJKmainfont in xelatex
en lualatex. Sta alle keuzes toe die beschikbaar zijn via fontspec, zoals de
OpenType-functies Numbers=OldStyle,Numbers=Proportioneel. Voor herhaling vatbaar
meerdere opties.

lettertype
staat toe dat lettertypecodering wordt gespecificeerd via fontenc-pakket (met pdflatex);
standaard is T1 (zie gids voor LaTeX-lettertypecoderingen)

kleurlinks
kleur toevoegen aan linktekst; automatisch ingeschakeld als een van linkcolor, citecolor,
urlcolor of toccolor zijn ingesteld

link kleur, citeerkleur, urlkleur, kleur
kleur voor interne links, citatielinks, externe links en links in tabel van
inhoud: gebruikt een van de vooraf gedefinieerde LaTeX-kleuren

links-als-notities
zorgt ervoor dat koppelingen als voetnoten worden afgedrukt

inspringen gebruikt documentklasse-instellingen voor inspringen (anders de standaard LaTeX-sjabloon
verwijdert inspringing en voegt ruimte toe tussen alinea's)

subparagraaf
schakelt standaardgedrag van LaTeX-sjabloon uit dat (sub)alinea's herdefinieert als
secties, waardoor het uiterlijk van geneste koppen in sommige klassen wordt gewijzigd

bedankt specificeert de inhoud van de voetnoot van het dankwoord na de titel van het document.

geval inclusief inhoudsopgave (kan ook worden ingesteld met --toc/--table-of-contents)

toc-diepte
sectieniveau dat in de inhoudsopgave moet worden opgenomen

lof, lot
inclusief lijst met figuren, lijst met tabellen

bibliografie
bibliografie te gebruiken voor het oplossen van referenties

biblio-stijl
bibliografiestijl, indien gebruikt met --natbib en --biblatex.

biblatexopties
lijst met opties voor biblatex.

Variabelen voor Context
papiergrootte
papierformaat, bijv. Letter, A4, liggend (zie ConTeXt Papierinstellingen); kan herhaald worden
voor meerdere opties

lay-out opties voor paginamarges en tekstschikking (zie ConTeXt Layout); kan herhaald worden
voor meerdere opties

marge-links, marge-rechts, marge-top, marge-onder
stelt marges in, als lay-out niet wordt gebruikt (anders overschrijft lay-out deze)

lettertypegrootte
lettergrootte voor hoofdtekst (bijv. 10pt, 12pt)

hoofdlettertype, sansfont, monolettertype, mathlettertype
lettertypefamilies: neem de naam van elk systeemlettertype (zie ConTeXt-lettertype wisselen)

link kleur, contrastkleur
kleur voor links buiten en binnen een pagina, bijv. rood, blauw (zie ConTeXt Color)

linkstijl
letterstijl voor links, bijv. normaal, vet, schuin, vet schuin, type, hoofdletter,
Klein

inspringen
regelt het inspringen van alinea's, bijv. ja, klein, volgende (zie ConTeXt Inspringen);
kan worden herhaald voor meerdere opties

witte ruimte
spaties tussen alinea's, bijv. geen, klein (met behulp van setupwhitespace)

tussenregelruimte
regelafstand aanpassen, bijv. 4ex (met behulp van setupinterlinespace); voor herhaling vatbaar
meerdere opties

koptekst, voettekst
tekst die in lopende kop- of voettekst moet worden geplaatst (zie ConTeXt Kop- en voetteksten);
kan tot vier keer worden herhaald voor verschillende plaatsing

paginanummering
stijl en locatie van paginanummering (met behulp van paginanummering instellen); voor herhaling vatbaar
meerdere opties

geval inclusief inhoudsopgave (kan ook worden ingesteld met --toc/--table-of-contents)

lof, lot
inclusief lijst met figuren, lijst met tabellen

Variabelen voor man paginas
sectie
sectienummer in man-pagina's

hoofd koptekst in man-pagina's

footer voettekst in man-pagina's

het aanpassen van
past tekst aan naar linker (l), rechter (r), midden (c) of beide (b) marges

koppelteken
indien waar (standaard), wordt woordafbreking gebruikt

gebruik variabelen in templates
Variabelenamen zijn reeksen alfanumerieke tekens, - en _, beginnend met een letter. A
variabelenaam omgeven door $-tekens wordt vervangen door de waarde ervan. Bijvoorbeeld de
teken $title$ in

$titel$

wordt vervangen door de titel van het document.

Gebruik $$ om een ​​letterlijke $ in een sjabloon te schrijven.

Sjablonen kunnen voorwaarden bevatten. De syntaxis is als volgt:

$if(variabele)$
X
$anders$
Y
$eindif$

Dit zal X in de sjabloon opnemen als de variabele een niet-nullwaarde heeft; anders zal het
neem Y op. X en Y zijn tijdelijke aanduidingen voor elke geldige sjabloontekst en kunnen omvatten
geïnterpoleerde variabelen of andere voorwaarden. De sectie $else$ mag worden weggelaten.

Wanneer variabelen meerdere waarden kunnen hebben (bijvoorbeeld auteur in een document met meerdere auteurs),
je kunt het trefwoord $for$ gebruiken:

$voor(auteur)$

$eindvoor$

U kunt optioneel een scheidingsteken opgeven dat moet worden gebruikt tussen opeenvolgende items:

$for(auteur)$$auteur$$sep$, $endfor$

Een punt kan worden gebruikt om een ​​veld van een variabele te selecteren die een object als waarde heeft. Dus,
bijvoorbeeld:

$auteur.naam$ ($auteur.affiliatie$)

Als u aangepaste sjablonen gebruikt, moet u deze mogelijk herzien als Pandoc-wijzigingen. Wij adviseren
het bijhouden van de wijzigingen in de standaardsjablonen en het wijzigen van uw aangepaste sjablonen
overeenkomstig. Een gemakkelijke manier om dit te doen is door de repository van pandoc-templates te splitsen en samen te voegen
in veranderingen na elke pandoc release.

PANDOCS AFSLUITING

Pandoc begrijpt een uitgebreide en enigszins herziene versie van John Gruber's Markdown
syntaxis. In dit document wordt de syntaxis uitgelegd en worden de verschillen met de standaard Markdown opgemerkt.
Tenzij anders vermeld, kunnen deze verschillen worden onderdrukt door de markdown_strict te gebruiken
formaat in plaats van markdown. Een extensie kan worden ingeschakeld door +EXTENSION toe te voegen aan het
formaatnaam en uitgeschakeld door -EXTENSION toe te voegen. Markdown_strict+footnotes is bijvoorbeeld
strikte Markdown met voetnoten ingeschakeld, terwijl markdown-footnotes-pipe_tables Pandoc's is
Markdown zonder voetnoten of pijptabellen.

Filosofie
Markdown is ontworpen om gemakkelijk te schrijven en, nog belangrijker, gemakkelijk te lezen:

Een document in Markdown-indeling moet als zodanig kunnen worden gepubliceerd, als platte tekst, zonder
eruit alsof het is gemarkeerd met tags of opmaakinstructies. -- Joh
Gruber

Dit principe heeft de beslissingen van pandoc geleid bij het vinden van syntaxis voor tabellen, voetnoten en
andere extensies.

Er is echter één opzicht waarin de doelstellingen van Pandoc verschillen van de oorspronkelijke doelstellingen
van Markdown. Terwijl Markdown oorspronkelijk is ontworpen met het genereren van HTML in het achterhoofd,
pandoc is ontworpen voor meerdere uitvoerformaten. Dus terwijl Pandoc de inbedding toestaat
van onbewerkte HTML, het ontmoedigt het en biedt andere, niet-HTML-achtige manieren van representatie
belangrijke documentelementen zoals definitielijsten, tabellen, wiskunde en voetnoten.

De leden
Een alinea bestaat uit een of meer regels tekst gevolgd door een of meer lege regels. Nieuwe regels
worden behandeld als spaties, dus u kunt uw alinea's opnieuw plaatsen zoals u wilt. Als je een harde nodig hebt
regeleinde, plaats twee of meer spaties aan het einde van een regel.

Uitbreiding: ontsnapte_line_breaks
Een backslash gevolgd door een nieuwe regel is ook een hard regeleinde. Opmerking: in multilijn en raster
tabelcellen, is dit de enige manier om een ​​harde regelafbreking te maken, aangezien volgspaties in
de cellen worden genegeerd.

Headers
Er zijn twee soorten headers: Setext en ATX.

Setext-stijl headers
Een koptekst in setext-stijl is een tekstregel die "onderstreept" is met een rij =-tekens (voor een level
één kop) of - tekens (voor een kop van niveau twee):

Een header van niveau één
==================

Een level-twee header
------------------

De koptekst kan inline opmaak bevatten, zoals nadruk (zie Inline opmaak,
hieronder).

ATX-stijl headers
Een koptekst in ATX-stijl bestaat uit één tot zes #-tekens en een regel tekst, optioneel gevolgd
door een willekeurig aantal #-tekens. Het aantal #-tekens aan het begin van de regel is de
kopniveau:

## Een koptekst van niveau twee

### Een koptekst van niveau drie ###

Net als kopteksten in setext-stijl, kan de koptekst opmaak bevatten:

# Een level-one header met een [link](/url) en *nadruk*

Uitbreiding: blanco_before_header
De standaard Markdown-syntaxis vereist geen lege regel voor een koptekst. Pandoc wel
dit vereisen (behalve natuurlijk aan het begin van het document). De reden voor de
vereiste is dat een # maar al te gemakkelijk aan het begin van een regel terechtkomt
ongeval (misschien door regelwikkeling). Denk bijvoorbeeld aan:

Ik hou van verschillende van hun smaken ijs:
#22, bijvoorbeeld, en #5.

Voorvoegsel identifiers
Uitbreiding: header_attributen
Aan kopteksten kunnen attributen worden toegewezen met behulp van deze syntaxis aan het einde van de regel die de
koptekst:

{#identifier .class .class sleutel=waarde sleutel=waarde}

Zo krijgen bijvoorbeeld de volgende headers allemaal de identifier foo toegewezen:

# Mijn koptekst {#foo}

## Mijn koptekst ## {#foo}

Mijn andere koptekst {#foo}
---------------

(Deze syntaxis is compatibel met PHP Markdown Extra.)

Merk op dat hoewel deze syntaxis toewijzing van klassen en sleutel/waarde-attributen toestaat,
schrijvers gebruiken over het algemeen niet al deze informatie. Identifiers, klassen en sleutel/waarde
attributen worden gebruikt in HTML en HTML-gebaseerde formaten zoals EPUB en slide. Identificaties
worden gebruikt voor labels en linkankers in de LaTeX-, ConTeXt-, Textile- en AsciiDoc-schrijvers.

Kopteksten met de klasse ongenummerd zullen niet genummerd worden, zelfs als --number-sections dat wel is
opgegeven. Een enkel koppelteken (-) in een attribuutcontext is gelijk aan .ongenummerd, en
bij voorkeur in niet-Engelse documenten. Dus,

# Mijn koptekst {-}

is net hetzelfde als

# Mijn koptekst {.unnumbered}

Uitbreiding: auto_identifiers
Een header zonder een expliciet gespecificeerde identifier wordt automatisch toegewezen aan een
unieke identificatie op basis van de koptekst. Om de identifier uit de header af te leiden
tekst,

· Verwijder alle opmaak, links, enz.

· Verwijder alle voetnoten.

· Verwijder alle interpunctie, behalve onderstrepingstekens, koppeltekens en punten.

· Vervang alle spaties en nieuwe regels door koppeltekens.

· Converteer alle alfabetische tekens naar kleine letters.

· Verwijder alles tot aan de eerste letter (ID's mogen niet beginnen met een cijfer of
leesteken).

· Als er hierna niets meer over is, gebruik dan het identificatiegedeelte.

Zo is bijv.

Header-ID
────────────────────────────────────────────────── ──────
Header-ID's in HTML-header-ID's-in-html
*Honden*?--in *mijn* huis? honden--in-mijn-huis
[HTML], [S5] of [RTF]? html-s5-of-rtf
3. Toepassingen toepassingen
33-sectie

Deze regels zouden het in de meeste gevallen mogelijk moeten maken om de identifier uit de header te bepalen
tekst. De uitzondering is wanneer meerdere kopteksten dezelfde tekst hebben; in dit geval de eerste
krijgt een identifier zoals hierboven beschreven; de tweede krijgt dezelfde identifier met -1
toegevoegd; de derde met -2; enzovoort.

Deze identifiers worden gebruikt om linkdoelen te bieden in de inhoudsopgave gegenereerd door
de optie --toc|--inhoudsopgave. Ze maken het ook gemakkelijk om links van één te verstrekken
gedeelte van een document naar een ander. Een link naar deze sectie kan er bijvoorbeeld uitzien
deze:

Zie het gedeelte over
[header-ID's](#header-ID's-in-html-latex-en-context).

Merk echter op dat deze methode om links naar secties aan te bieden alleen werkt in HTML, LaTeX,
en ConTeXt-formaten.

Als de optie --section-divs is opgegeven, wordt elke sectie verpakt in een div (of
een sectie, als --html5 was opgegeven), en de identifier zal aan de bijlage worden toegevoegd
(of ) tag in plaats van de header zelf. Hierdoor kunnen hele secties worden
gemanipuleerd met behulp van javascript of anders behandeld in CSS.

Uitbreiding: impliciete_header_referenties
Pandoc gedraagt ​​zich alsof er referentielinks zijn gedefinieerd voor elke kop. Dus in plaats van

[header-ID's](#header-ID's-in-html)

je kunt gewoon schrijven

[header-ID's]

or

[header-ID's][]

or

[het gedeelte over header-ID's][header-ID's]

Als er meerdere kopteksten met identieke tekst zijn, wordt de bijbehorende verwijzing gekoppeld
alleen naar de eerste, en je zult expliciete links moeten gebruiken om naar de anderen te linken, zoals
hierboven omschreven.

Net als gewone verwijzingslinks zijn deze verwijzingen niet hoofdlettergevoelig.

Expliciete linkreferentiedefinities hebben altijd voorrang op impliciete headerreferenties.
In het volgende voorbeeld wijst de link dus naar bar, niet naar #foo:

# Foe

[foe]: bar

Zie [foo]

Block citaten
Markdown gebruikt e-mailconventies voor het citeren van tekstblokken. Een blokcitaat is één of
meer paragrafen of andere blokelementen (zoals lijsten of koppen), met elke regel
voorafgegaan door een >-teken en een optionele spatie. (De > hoeft niet links te beginnen
marge, maar mag niet meer dan drie spaties inspringen.)

> Dit is een blokcitaat. Dit
> alinea heeft twee regels.
>
> 1. Dit is een lijst binnen een blokcitaat.
> 2. Tweede punt.

Een "luie" vorm, die alleen het teken > op de eerste regel van elk blok nodig heeft, is dat wel
ook toegestaan:

> Dit is een blokcitaat. Dit
alinea heeft twee regels.

> 1. Dit is een lijst binnen een blokcitaat.
2. Tweede punt.

Onder de blokelementen die in een blokcitaat kunnen worden opgenomen, bevinden zich andere blokcitaten.
Dat wil zeggen, blokcitaten kunnen worden genest:

> Dit is een blokcitaat.
>
> > Een blokcitaat binnen een blokcitaat.

Als het >-teken wordt gevolgd door een optionele spatie, wordt die spatie beschouwd als onderdeel van
de blokcitaatmarkering en maakt geen deel uit van de inspringing van de inhoud. Dus, om een
ingesprongen codeblok in een blokcitaat, hebt u vijf spaties nodig na de >:

> codes

Uitbreiding: blank_before_blockquote
De standaard Markdown-syntaxis vereist geen lege regel voor een blokcitaat. Pandoc wel
dit vereisen (behalve natuurlijk aan het begin van het document). De reden voor de
vereiste is dat het maar al te gemakkelijk is dat een > aan het begin van een regel terecht komt
ongeval (misschien door regelwikkeling). Dus, tenzij het formaat markdown_strict wordt gebruikt,
het volgende levert geen genest blokcitaat op in pandoc:

> Dit is een blokcitaat.
>> Genest.

woordelijk (code) blokken
getand code blokken
Een tekstblok met vier spaties ingesprongen (of één tab) wordt behandeld als letterlijke tekst: dat wil zeggen,
speciale tekens activeren geen speciale opmaak, en alle spaties en regeleinden zijn dat wel
behouden. Bijvoorbeeld,

als (een > 3) {
moveShip(5 * zwaartekracht, OMLAAG);
}

De aanvankelijke inspringing (vier spaties of één tab) wordt niet beschouwd als onderdeel van de woordelijke tekst
tekst en wordt verwijderd in de uitvoer.

Let op: lege regels in de woordelijke tekst hoeven niet met vier spaties te beginnen.

Omheind code blokken
Uitbreiding: omheinde_code_blokken
Naast standaard ingesprongen codeblokken ondersteunt pandoc omheind code blokken. Deze
begin met een rij van drie of meer tildes (~) en eindig met een rij tildes die op
minstens zo lang als de startrij. Alles tussen deze regels wordt behandeld als code. Nee
inspringen is nodig:

~~~~~~~
als (een > 3) {
moveShip(5 * zwaartekracht, OMLAAG);
}
~~~~~~~

Net als gewone codeblokken, moeten omheinde codeblokken worden gescheiden van omringende tekst door
lege regels.

Als de code zelf een rij tildes of backticks bevat, gebruik dan gewoon een langere rij tildes
of backticks aan het begin en einde:

~~~~~~~~~~~~~~~~
~~~~~~~~~~
code inclusief tildes
~~~~~~~~~~
~~~~~~~~~~~~~~~~

Uitbreiding: backtick_code_blokken
Hetzelfde als fenced_code_blocks, maar gebruikt backticks (`) in plaats van tildes (~).

Uitbreiding: omheinde_code_attributen
Optioneel kunt u attributen koppelen aan een afgeschermd of backtick codeblok met behulp van deze syntaxis:

~~~~ {#mijncode .haskell .numberLines startFrom="100"}
qsorteren [] = []
qsort (x:xs) = qsort (filter (< x) xs) ++ [x] ++
qsort (filter (>= x) xs)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Hier is mycode een identifier, haskell en numberLines zijn klassen en startFrom is een
attribuut met waarde 100. Sommige uitvoerformaten kunnen deze informatie gebruiken om syntaxis uit te voeren
markeren. Momenteel zijn HTML en
Latex. Als markeren wordt ondersteund voor uw uitvoerformaat en taal, dan is de code
blok erboven verschijnt gemarkeerd, met genummerde regels. (Om te zien welke talen zijn
ondersteund, doe dan pandoc --version.) Anders zal het bovenstaande codeblok er als volgt uitzien:



...



Er kan ook een snelkoppelingsformulier worden gebruikt om de taal van het codeblok te specificeren:

```Haskel
qsorteren [] = []
``

Dit komt overeen met:

``` {.haskell}
qsorteren [] = []
``

Als de extensie fenced_code_attributes is uitgeschakeld, maar de invoer klasseattribuut(en) bevat
voor het codeblok wordt het eerste klasseattribuut afgedrukt na het openingshek als een
kaal woord.

Gebruik de vlag --no-highlight om alle markering te voorkomen. Om de markeringsstijl in te stellen,
gebruik --highlight-stijl. Voor meer informatie over accentuering, zie Syntaxisaccentuering,
hieronder.

Lijn blokken
Uitbreiding: lijn_blokken
Een regelblok is een reeks regels die begint met een verticale streep (|) gevolgd door een spatie.
De indeling in regels blijft behouden in de uitvoer, net als eventuele voorloopspaties;
anders worden de regels opgemaakt als Markdown. Dit is handig voor couplet en
adressen:

| De limerick packs lacht anatomisch
| In de ruimte is dat best zuinig.
| Maar de goede die ik heb gezien
| Zo zelden zijn schoon
| En de schone zijn zo zelden komisch

| Hoofdstraat 200.
| Berkeley, CA 94718

De regels kunnen indien nodig hard worden omwikkeld, maar de vervolgregel moet beginnen met een
ruimte.

| De Hoogedelachtbare Zeer Eerbiedwaardige en Rechtvaardige Samuel L.
Constable, jr.
| Hoofdstraat 200.
| Berkeley, CA 94718

Deze syntaxis is ontleend aan reStructuredText.

lijsten
Kogel camera's lijsten
Een lijst met opsommingstekens is een lijst met lijstitems met opsommingstekens. Een lijstitem met opsommingstekens begint met een opsommingsteken
(*, + of -). Hier is een eenvoudig voorbeeld:

* een
* twee
* drie

Dit levert een "compacte" lijst op. Als u een "losse" lijst wilt, waarin elk item staat
opgemaakt als een alinea, plaats spaties tussen de items:

* een

* twee

* drie

De kogels hoeven niet gelijk te liggen met de linkermarge; ze kunnen een, twee of ingesprongen zijn
drie ruimtes. Het opsommingsteken moet worden gevolgd door witruimte.

Lijstitems zien er het beste uit als volgende regels gelijk liggen met de eerste regel (na het opsommingsteken):

* hier is mijn eerste
lijst item.
* en mijn tweede.

Maar Markdown staat ook een "lui" formaat toe:

* hier is mijn eerste
lijst item.
* en mijn tweede.

De vier-spatie regeren
Een lijstitem kan meerdere alinea's en andere inhoud op blokniveau bevatten. Echter,
volgende alinea's moeten worden voorafgegaan door een witregel en vier spaties ingesprongen of een tab.
De lijst ziet er beter uit als de eerste alinea is uitgelijnd met de rest:

* Eerste paragraaf.

Wordt vervolgd.

* Tweede paragraaf. Met een codeblok, dat moet worden ingesprongen
acht spaties:

{code}

Lijstitems kunnen andere lijsten bevatten. In dit geval is de voorafgaande blanco regel optioneel.
De geneste lijst moet vier spaties of één tab ingesprongen zijn:

* fruit
+ appels
- Macintosh
- rood heerlijk
+ peren
+ perziken
* groenten
+ broccoli
+ snijbiet

Zoals hierboven vermeld, kunt u met Markdown lijstitems "lui" schrijven in plaats van inspringen
vervolg lijnen. Als er echter meerdere alinea's of andere blokken in een lijst staan
item, moet de eerste regel van elk item ingesprongen zijn.

+ Een luie, luie lijst
item.

+ Nog een; dit ziet er uit
slecht maar is legaal.

Tweede alinea van tweede
lijst item.

Opmerking: Hoewel de regel met vier spaties voor vervolgparagrafen afkomstig is van de ambtenaar
Markdown-syntaxisgids, de referentie-implementatie, Markdown.pl, volgt deze niet. Dus
pandoc zal andere resultaten geven dan Markdown.pl wanneer auteurs zijn ingesprongen
vervolgparagrafen minder dan vier spaties.

De Markdown-syntaxisgids is niet expliciet of de regel met vier spaties van toepassing is op allen
inhoud op blokniveau in een lijstitem; het vermeldt alleen paragrafen en codeblokken. Maar het
impliceert dat de regel van toepassing is op alle inhoud op blokniveau (inclusief geneste lijsten), en
pandoc interpreteert het op die manier.

Geordend lijsten
Geordende lijsten werken net als lijsten met opsommingstekens, behalve dat de items beginnen met tellers
in plaats van kogels.

In standaard Markdown zijn tellers decimale getallen gevolgd door een punt en een spatie.
De nummers zelf worden genegeerd, dus er is geen verschil tussen deze lijst:

1. een
2. twee
3. drie

en deze:

5. een
7. twee
1. drie

Uitbreiding: mooie_lijsten
In tegenstelling tot standaard Markdown, staat pandoc toe dat geordende lijstitems worden gemarkeerd met hoofdletters en
kleine letters en romeinse cijfers, naast arabische cijfers. Lijstmarkeringen kunnen zijn
tussen haakjes of gevolgd door een enkele rechter haakjes of punt. Ze moeten zijn
gescheiden van de tekst die volgt door ten minste één spatie, en als de lijstmarkering een
hoofdletter met een punt, met minimaal twee spaties.

Met de fancy_lists-extensie kan '#' ook worden gebruikt als een geordende lijstmarkering in plaats van
een cijfer:

#. een
#. twee

Uitbreiding: startnummer
Pandoc let ook op het gebruikte type lijstmarkering en op het startnummer,
en beide worden waar mogelijk bewaard in het uitvoerformaat. Dus het volgende
geeft een lijst met getallen gevolgd door een enkel haakje, beginnend met 9, en a
sublijst met Romeinse cijfers in kleine letters:

9) Negende
10) Tiende
11) Elfde
i. subon
ii. subtwee
iii. subdrie

Pandoc start een nieuwe lijst telkens wanneer een ander type lijstmarkering wordt gebruikt. Dus de
volgende zal drie lijsten maken:

(2) Twee
(5) Drie
1. vier
* Vijf

Als standaard lijstmarkeringen gewenst zijn, gebruik dan #.:

#. een
#. twee
#. drie

Definitie lijsten
Uitbreiding: definitie_lijsten
Pandoc ondersteunt definitielijsten, waarbij sommige de syntaxis van PHP Markdown Extra gebruiken
extensies.

Termijn 1

: Definitie 1

Term 2 met *inline opmaak*

: Definitie 2

{sommige code, onderdeel van Definitie 2}

Derde alinea van definitie 2.

Elke term moet op één regel passen, eventueel gevolgd door een witregel, en moet
worden gevolgd door een of meer definities. Een definitie begint met een dubbele punt of tilde, wat
kan een of twee spaties zijn ingesprongen.

Een term kan meerdere definities hebben en elke definitie kan uit een of meer blokken bestaan
elementen (paragraaf, codeblok, lijst, etc.), elk vier spaties ingesprongen of één tabstop.
De hoofdtekst van de definitie (inclusief de eerste regel, afgezien van de dubbele punt of tilde)
moeten vier spaties worden ingesprongen. Net als bij andere Markdown-lijsten kunt u echter "lui"
inspringing weglaten behalve aan het begin van een alinea of ​​ander blokelement:

Termijn 1

: Definitie
met luie voortzetting.

Tweede alinea van de definitie.

Als u ruimte laat voor de definitie (zoals in het bovenstaande voorbeeld), wordt de tekst van de
definitie zal worden behandeld als een alinea. In sommige uitvoerformaten betekent dit meer
afstand tussen term/definitieparen. Laat de spatie weg voor een compactere lijst met definities
voor de definitie:

Termijn 1
~ Definitie 1

Termijn 2
~ Definitie 2a
~ Definitie 2b

Houd er rekening mee dat ruimte tussen items in een definitielijst vereist is. (Een variant die loslaat
deze vereiste, maar verbiedt "luie" harde verpakking, kan worden geactiveerd met
compact_definition_lists: zie Niet-pandoc-extensies hieronder.)

genummerd voorbeeld lijsten
Uitbreiding: voorbeeld_lijsten
De speciale lijstmarkering @ kan worden gebruikt voor opeenvolgend genummerde voorbeelden. De eerste lijst
item met een @-markering wordt genummerd met '1', de volgende '2', enzovoort, gedurende het hele
document. De genummerde voorbeelden hoeven niet in één lijst voor te komen; elke nieuwe lijst met @
gaat verder waar de vorige stopte. Dus bijvoorbeeld:

(@) Mijn eerste voorbeeld krijgt nummer (1).
(@) Mijn tweede voorbeeld krijgt nummer (2).

Uitleg van voorbeelden.

(@) Mijn derde voorbeeld krijgt nummer (3).

Genummerde voorbeelden kunnen worden gelabeld en elders in het document worden vermeld:

(@good) Dit is een goed voorbeeld.

Zoals (@good) illustreert, ...

Het label kan elke reeks alfanumerieke tekens, onderstrepingstekens of koppeltekens zijn.

Compact en los lijsten
Pandoc gedraagt ​​zich anders dan Markdown.pl in sommige "randgevallen" waarbij lijsten betrokken zijn.
Overweeg deze bron:

+ Eerst
+ Tweede:
- Tarief
- Foei
- Vijand

+ Derde

Pandoc zet dit om in een "compacte lijst" (met nr tags rond "Eerste", "Tweede",
of "Derde"), terwijl Markdown zet tags rond "Tweede" en "Derde" (maar niet "Eerste"),
vanwege de lege ruimte rond "Third". Pandoc volgt een simpele regel: als de tekst is
gevolgd door een lege regel, wordt het behandeld als een alinea. Aangezien "Second" wordt gevolgd door een
lijst, en niet als een lege regel, wordt het niet behandeld als een paragraaf. Het feit dat de lijst is
gevolgd door een lege regel is niet relevant. (Opmerking: Pandoc werkt op deze manier zelfs wanneer de
markdown_strict-indeling is opgegeven. Dit gedrag komt overeen met de ambtenaar
Markdown-syntaxisbeschrijving, hoewel deze verschilt van die van Markdown.pl.)

Einde a lijst
Wat als u een ingesprongen codeblok achter een lijst wilt plaatsen?

- artikel één
- punt twee

{ mijn codeblok }

Probleem! Hier zal pandoc (net als andere Markdown-implementaties) {mijn codeblok} behandelen als
de tweede alinea van item twee, en niet als een codeblok.

Om de lijst na item twee "af te snijden", kunt u wat niet-ingesprongen inhoud invoegen, zoals een
HTML-opmerking, die in geen enkel formaat zichtbare uitvoer zal produceren:

- artikel één
- punt twee



{ mijn codeblok }

Je kunt dezelfde truc gebruiken als je twee opeenvolgende lijsten wilt in plaats van één grote lijst:

1. een
2. twee
3. drie



1. een
2. Dos
3. drie

Horizontaal reglement
Een regel met een rij van drie of meer *, - of _ tekens (optioneel gescheiden door
spaties) produceert een horizontale regel:

* * * *

---------------

Tafels
Er kunnen vier soorten tabellen worden gebruikt. De eerste drie soorten veronderstellen het gebruik van a
lettertype met vaste breedte, zoals Courier. De vierde soort kan worden gebruikt met proportionele afstand
fonts, omdat het niet nodig is om kolommen uit te lijnen.

Uitbreiding: tabelbijschriften
Bij alle 4 soorten tabellen kan optioneel een onderschrift worden geleverd (zoals geïllustreerd in de
voorbeelden hieronder). Een bijschrift is een alinea die begint met de tekenreeks Tabel: (of gewoon :),
die zal worden afgeschaft. Het kan zowel voor als achter de tafel verschijnen.

Uitbreiding: eenvoudige_tabellen
Eenvoudige tabellen zien er zo uit:

Rechts Links Midden Standaard
------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1

Tabel: Demonstratie van eenvoudige tabelsyntaxis.

De kopteksten en tabelrijen moeten elk op één regel passen. Kolomuitlijningen worden bepaald door
de positie van de koptekst ten opzichte van de stippellijn eronder:

· Als de stippellijn gelijk loopt met de koptekst aan de rechterkant maar verder reikt
aan de linkerkant is de kolom rechts uitgelijnd.

· Als de stippellijn gelijk loopt met de koptekst aan de linkerkant maar verder reikt
aan de rechterkant is de kolom links uitgelijnd.

· Als de stippellijn aan beide zijden buiten de koptekst uitsteekt, is de kolom gecentreerd.

· Als de stippellijn aan beide zijden gelijk loopt met de koptekst, is de standaarduitlijning
gebruikt (in de meeste gevallen blijft dit staan).

De tabel moet eindigen met een lege regel, of een regel streepjes gevolgd door een blanco regel.

De kolomkoppen kunnen worden weggelaten, mits een stippellijn wordt gebruikt om de tabel af te sluiten. Voor
voorbeeld:

------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1
------- ------ ---------- -------

Wanneer kopteksten worden weggelaten, wordt de kolomuitlijning bepaald op basis van de eerste regel
van het tafellichaam. In de bovenstaande tabellen zijn de kolommen dus rechts, links, midden en
respectievelijk rechts uitgelijnd.

Uitbreiding: multiline_tabellen
Met tabellen met meerdere regels kunnen kopteksten en tabelrijen meerdere tekstregels beslaan (maar cellen
die meerdere kolommen of rijen van de tabel beslaan, worden niet ondersteund). Hier is een voorbeeld:

-------------------------------------------------- -----------
Gecentreerd Standaard Rechts Links
Koptekst uitgelijnd uitgelijnd uitgelijnd
----------- ------- --------------- ----------------- --------
Eerste rij 12.0 Voorbeeld van een rij die
beslaat meerdere regels.

Tweede rij 5.0 Hier is er nog een. Opmerking
de lege regel ertussen
rijen.
-------------------------------------------------- -----------

Tabel: Hier is het bijschrift. Het kan ook overspannen zijn
meerdere regels.

Deze werken als eenvoudige tabellen, maar met de volgende verschillen:

· Ze moeten beginnen met een rij streepjes, vóór de koptekst (tenzij de kopteksten
overgeslagen).

· Ze moeten eindigen met een rij streepjes en daarna een lege regel.

· De rijen moeten worden gescheiden door lege regels.

In tabellen met meerdere regels let de tabelparser op de breedte van de kolommen en de
schrijvers proberen deze relatieve breedten in de uitvoer te reproduceren. Dus, als je die vindt
de kolommen zijn te smal in de uitvoer, probeer deze te verbreden in de Markdown-bron.

Kopteksten kunnen worden weggelaten in tabellen met meerdere regels en in eenvoudige tabellen:

----------- ------- --------------- ----------------- --------
Eerste rij 12.0 Voorbeeld van een rij die
beslaat meerdere regels.

Tweede rij 5.0 Hier is er nog een. Opmerking
de lege regel ertussen
rijen.
----------- ------- --------------- ----------------- --------

: Hier is een tabel met meerdere regels zonder koppen.

Het is mogelijk dat een tabel met meerdere regels slechts één rij heeft, maar de rij moet worden gevolgd
door een lege regel (en dan de rij streepjes die de tabel beëindigt), of de tabel kan zijn
geïnterpreteerd als een eenvoudige tabel.

Uitbreiding: raster_tabellen
Rastertabellen zien er als volgt uit:

: Voorbeeld rastertabel.

+--------------+---------------+----------------- ---+
| Vruchten | Prijs | Voordelen |
+===============+===============+================ ===+
| Bananen | $ 1.34 | - ingebouwde wikkel |
| | | - felle kleur |
+--------------+---------------+----------------- ---+
| Sinaasappelen | $ 2.10 | - geneest scheurbuik |
| | | - lekker |
+--------------+---------------+----------------- ---+

De rij =s scheidt de kop van de tabel en kan worden weggelaten voor a
koploze tabel. De cellen van rastertabellen kunnen willekeurige blokelementen bevatten (multiple
paragrafen, codeblokken, lijsten, enz.). Uitlijningen worden niet ondersteund, en cellen ook niet
meerdere kolommen of rijen beslaan. Rastertabellen kunnen eenvoudig worden gemaakt met behulp van de Emacs-tabelmodus.

Uitbreiding: pipe_tabellen
Pijptabellen zien er als volgt uit:

| Juist | Links | Standaard | Centrum |
|------:|:-----|---------|:------:|
| 12 | 12 | 12 | 12 |
| 123 | 123 | 123 | 123 |
| 1 | 1 | 1 | 1 |

: Demonstratie van syntaxis van pijptabellen.

De syntaxis is identiek aan PHP Markdown Extra-tabellen. De begin- en eindpijp
karakters zijn optioneel, maar leidingen zijn vereist tussen alle kolommen. De dubbele punten geven aan
kolomuitlijning zoals weergegeven. De koptekst kan niet worden weggelaten. Om een ​​koploze tabel te simuleren,
voeg een koptekst toe met lege cellen.

Aangezien de pijpen kolomgrenzen aangeven, hoeven kolommen niet verticaal te worden uitgelijnd
ze zijn in het bovenstaande voorbeeld. Dit is dus een volkomen legale (hoewel lelijke) pijptabel:

fruit| prijs
-----|-----:
appel|2.05
peer|1.37
oranje|3.09

De cellen van pijptabellen mogen geen blokelementen bevatten zoals alinea's en lijsten, en
kan niet over meerdere regels lopen. Als een pijptabel een rij bevat waarvan de afdrukbare inhoud is
breder is dan de kolombreedte (zie --columns), dan zal de inhoud van de cel omlopen, met de
relatieve celbreedten bepaald door de breedten van de scheidingslijnen.

Opmerking: pandoc herkent ook pijptabellen van de volgende vorm, zoals geproduceerd door
Orgtbl-modus van Emacs:

| Een | Twee |
|-----+-------|
| mijn | tafel |
| is | leuk |

Het verschil is dat + wordt gebruikt in plaats van |. Andere orgtbl-functies worden niet ondersteund.
In het bijzonder, om niet-standaard kolomuitlijning te krijgen, moet u dubbele punten toevoegen zoals hierboven.

Metadata blokken
Uitbreiding: pandoc_title_block
Als het bestand begint met een titelblok

% titel
% auteur(s) (gescheiden door puntkomma's)
% datum

het wordt geparseerd als bibliografische informatie, niet als gewone tekst. (Het zal worden gebruikt, voor
bijvoorbeeld in de titel van zelfstandige LaTeX- of HTML-uitvoer.) Het blok kan alleen een
titel, een titel en een auteur, of alle drie de elementen. Als u een auteur wilt opnemen, maar
geen titel, of een titel en een datum maar geen auteur, je hebt een lege regel nodig:

%
% Auteur

% Mijn titel
%
% 15 juni 2006

De titel mag meerdere regels beslaan, maar vervolgregels moeten beginnen met voorloopspatie,
dus:

% Mijn titel
op meerdere lijnen

Als een document meerdere auteurs heeft, kunnen de auteurs vooraf op afzonderlijke regels worden geplaatst
spatie, of gescheiden door puntkomma's, of beide. Dus al het volgende is equivalent:

% Auteur Een
Auteur twee

% Auteur Een; Auteur twee

% Auteur Een;
Auteur twee

De datum moet op één regel passen.

Alle drie de metadatavelden kunnen standaard inline opmaak bevatten (cursief, links,
voetnoten, enz.).

Titelblokken worden altijd geparseerd, maar ze hebben alleen invloed op de uitvoer wanneer de
--standalone (-s) optie is gekozen. In HTML-uitvoer verschijnen titels twee keer: één keer in de
documentkop - dit is de titel die bovenaan het venster in een browser zal verschijnen
-- en eenmaal aan het begin van de documenttekst. De titel in de documentkop kan
een optioneel voorvoegsel hebben (optie --title-prefix of -T). De titel in de body
verschijnt als een H1-element met klasse "title", zodat het kan worden onderdrukt of opnieuw kan worden geformatteerd
CSS. Als een titelvoorvoegsel is opgegeven met -T en er geen titelblok in het document verschijnt,
het titelvoorvoegsel wordt op zichzelf gebruikt als de HTML-titel.

De man-paginaschrijver extraheert een titel, het sectienummer van de man-pagina en andere kop- en voetteksten
informatie uit de titelregel. De titel wordt verondersteld het eerste woord van de titel te zijn
lijn, die optioneel kan eindigen met een (eencijferig) sectienummer tussen haakjes.
(Er mag geen spatie zijn tussen de titel en de haakjes.) Alles wat hierna komt is
verondersteld aanvullende voet- en koptekst te zijn. Een enkel pipe-teken (|) zou moeten zijn
gebruikt om de voettekst van de koptekst te scheiden. Dus,

% PANDOC(1)

levert een man-pagina op met de titel PANDOC en sectie 1.

% PANDOC(1) Pandoc-gebruikershandleidingen

zal ook "Pandoc Gebruikershandleidingen" in de voettekst hebben.

% PANDOC(1) Pandoc-gebruikershandleidingen | Versie 4.0

zal ook "Versie 4.0" in de koptekst hebben.

Uitbreiding: yaml_metadata_block
Een YAML-metadatablok is een geldig YAML-object, begrensd door een regel van drie koppeltekens (---)
bovenaan en een lijn van drie koppeltekens (---) of drie punten (...) onderaan. Een YAML
metadatablok kan overal in het document voorkomen, maar als het niet aan het begin staat, is het
moet worden voorafgegaan door een lege regel. (Merk op dat, vanwege de manier waarop pandoc samenvoegt
invoerbestanden wanneer er meerdere worden verstrekt, kunt u de metadata ook in een aparte YAML bewaren
bestand en geef het door aan pandoc als een argument, samen met uw Markdown-bestanden:

pandoc chap1.md chap2.md chap3.md metadata.yaml -s -o boek.html

Zorg er wel voor dat het YAML-bestand begint met --- en eindigt met --- of ....)

Metadata worden uit de velden van het YAML-object gehaald en toegevoegd aan bestaande
metagegevens documenteren. Metadata kunnen lijsten en objecten bevatten (willekeurig genest), maar allemaal
string scalairen worden geïnterpreteerd als Markdown. Velden waarvan de naam eindigt op een underscore
zal worden genegeerd door Pandoc. (Ze kunnen een rol krijgen van externe verwerkers.)

Een document kan meerdere metadatablokken bevatten. De metadatavelden worden gecombineerd
via een links bevooroordeeld unie: als twee metadatablokken hetzelfde veld proberen in te stellen, wordt het
waarde uit het eerste blok wordt overgenomen.

Wanneer pandoc wordt gebruikt met -t markdown om een ​​Markdown-document te maken, een YAML-metadatablok
wordt alleen geproduceerd als de -s/--standalone optie wordt gebruikt. Alle metadata zullen
verschijnen in een enkel blok aan het begin van het document.

Houd er rekening mee dat de YAML-escape-regels moeten worden gevolgd. Dus als een titel bijvoorbeeld een
dubbele punt, moet worden geciteerd. Het pipe-teken (|) kan worden gebruikt om een ​​ingesprongen blok te beginnen
dat zal letterlijk worden geïnterpreteerd, zonder te hoeven ontsnappen. Dit formulier is nodig
wanneer het veld lege regels bevat:

---
titel: 'Dit is de titel: er staat een dubbele punt in'
auteur:
- naam: Auteur Een
affiliatie: University of Somewhere
- naam: auteur twee
affiliatie: University of Nowhere
tags: [niets, niets]
samenvatting: |
Dit is de samenvatting.

Het bestaat uit twee alinea's.
...

Sjabloonvariabelen worden automatisch ingesteld op basis van de metadata. Zo bijvoorbeeld in
HTML schrijven, wordt de variabele abstract ingesteld op het HTML-equivalent van de Markdown in
het abstracte veld:

Dit is de samenvatting.
Het bestaat uit twee alinea's.

Opmerking: de variabele auteur in de standaardsjablonen verwacht een eenvoudige lijst of tekenreeks. Naar
gebruik je de gestructureerde auteurs in het voorbeeld, dan heb je een aangepast sjabloon nodig. Bijvoorbeeld:

$voor(auteur)$
$if(auteur.naam)$
$auteur.naam$$if(auteur.affiliatie)$ ($auteur.affiliatie$)$endif$
$anders$
$auteur$
$eindif$
$eindvoor$

backslash ontsnappingen
Uitbreiding: all_symbols_escapeable
Behalve binnen een codeblok of inline code, elk leesteken of spatie voorafgegaan door
een backslash wordt letterlijk behandeld, zelfs als dit normaal gesproken opmaak zou aangeven.
Dus bijvoorbeeld als men schrijft

*\*Hallo\**

men zal krijgen

*Hallo*

in plaats van

Hallo

Deze regel is gemakkelijker te onthouden dan de standaardregel van Markdown, die alleen de
volgende tekens die backslash-escaped moeten zijn:

\`*_{}[]()>#+-.!

(Als echter de markdown_strict-indeling wordt gebruikt, wordt de standaard Markdown-regel gebruikt.)

Een spatie met backslash-escaped wordt geparseerd als een niet-afbrekende spatie. Het verschijnt in TeX-uitvoer
als ~ en in HTML en XML als \ of \ .

Een nieuwe regel met een backslash-escaped (dwz een backslash aan het einde van een regel) wordt geparseerd
als een harde regelonderbreking. Het verschijnt in TeX-uitvoer als \\ en in HTML als . Dit is
een leuk alternatief voor de "onzichtbare" manier van Markdown om harde regeleinden aan te geven met twee
volgspaties op een regel.

Backslash-escapes werken niet in letterlijke contexten.

Smart interpunctie
Verlengstuk
Als de optie --smart is opgegeven, zal pandoc typografisch correcte uitvoer produceren,
rechte aanhalingstekens omzetten in gekrulde aanhalingstekens, --- naar em-streepjes, -- naar en-streepjes, en ... naar
ellipsen. Vaste spaties worden ingevoegd na bepaalde afkortingen, zoals "Mr."

Opmerking: als uw LaTeX-sjabloon of een van de meegeleverde headerbestanden het csquotes-pakket aanroept,
pandoc zal dit automatisch detecteren en \enquote{...} gebruiken voor geciteerde tekst.

In lijn opmaak
nadruk
Naar benadrukken wat tekst, omring het met *s of _, zoals dit:

Deze tekst wordt _benadrukt met onderstrepingstekens_, en dit
is *benadrukt met sterretjes*.

Dubbel * of _ produceert sterke nadruk:

Dit is **sterke nadruk** en __met underscores__.

Een *- of _-teken omgeven door spaties, of een backslash-escaped, veroorzaakt geen nadruk:

Dit is *niet benadrukt*, en \*dit ook niet\*.

Uitbreiding: intrawoord_underscores
Omdat _ soms wordt gebruikt in woorden en identifiers, interpreteert pandoc een _ niet
omgeven door alfanumerieke tekens als nadrukmarkering. Als je wilt benadrukken
slechts een deel van een woord, gebruik *:

haalbaar*, niet haalbaar*.

strikeout
Uitbreiding: strikeout
Om een ​​tekstgedeelte met een horizontale lijn door te halen, begint en eindigt u met ~~. Dus,
bijvoorbeeld

Dit ~~is verwijderde tekst.~~

Superscript en abonnementen
Uitbreiding: superscript, subscript
Superscript kan worden geschreven door de tekst in superscript te omgeven door ^ tekens;
subscripts kunnen worden geschreven door de subscripttekst te omringen met ~-tekens. Dus voor
voorbeeld,

H~2~O is een vloeistof. 2^10^ is 1024.

Als de superscript- of subscripttekst spaties bevat, moeten deze spaties worden ontsnapt
met backslashes. (Dit is om onbedoeld superscript en abonneren door te voorkomen
het gewone gebruik van ~ en ^.) Dus als je de letter P wilt met 'een kat' in subscripts,
gebruik P~a\ cat~, niet P~a cat~.

woordelijk
Om een ​​korte tekst letterlijk te maken, plaatst u deze tussen backticks:

Wat is het verschil tussen `>>=` en `>>`?

Als de woordelijke tekst een backtick bevat, gebruik dan dubbele backticks:

Hier is een letterlijke backtick `` ` ``.

(De spaties na de openende backticks en voor de afsluitende backticks worden genegeerd.)

De algemene regel is dat een woordelijke reeks begint met een reeks opeenvolgende backticks
(eventueel gevolgd door een spatie) en eindigt met een string van hetzelfde aantal backticks
(eventueel voorafgegaan door een spatie).

Merk op dat backslash-escapes (en andere Markdown-constructies) niet letterlijk werken
contexten:

Dit is een backslash gevolgd door een sterretje: `\*`.

Uitbreiding: inline_code_attributen
Attributen kunnen aan letterlijke tekst worden toegevoegd, net als bij afgeschermde codeblokken:

`<$>`{.haskell}

Klein caps
Om kleinkapitalen te schrijven, kunt u een HTML span-tag gebruiken:

Kleine kapitalen

(De puntkomma is optioneel en er kan ruimte zijn na de dubbele punt.) Dit werkt in alle gevallen
uitvoerformaten die small caps ondersteunen.

Math
Uitbreiding: tex_wiskunde_dollars
Alles tussen twee $-tekens wordt behandeld als TeX-wiskunde. De opening $ moet een hebben
niet-spatieteken direct rechts ervan, terwijl de afsluitende $ een niet-spatie moet hebben
teken onmiddellijk links ervan en mag niet onmiddellijk gevolgd worden door een cijfer. Dus,
$ 20,000 en $ 30,000 kunnen niet worden geparseerd als wiskunde. Als u om wat voor reden dan ook tekst moet insluiten
letterlijke $-tekens, backslash-escape ze en ze worden niet behandeld als wiskundige scheidingstekens.

TeX wiskunde wordt afgedrukt in alle uitvoerformaten. Hoe het wordt weergegeven, hangt af van de uitvoer
formaat:

prijsverlaging, Latex, Emacs Org mode, Context
Het zal letterlijk verschijnen tussen $-tekens.

reStructuredText
Het wordt weergegeven met behulp van een geïnterpreteerde tekstrol :math:.

asciidoc
Het wordt weergegeven als latexmath:[...].

Texinfo
Het wordt weergegeven in een @math-opdracht.

groff man
Het wordt woordelijk weergegeven zonder $'s.

MediaWiki, DokuWiki
Het wordt binnen weergegeven labels.

Textiel
Het wordt binnen tags weergegeven.

RTF, Document openen, ODT
Het wordt, indien mogelijk, weergegeven met Unicode-tekens, en anders ook
woordelijk verschijnen.

DocBook
Als de vlag --mathml wordt gebruikt, wordt deze weergegeven met behulp van MathML in een inline-vergelijking
of informele vergelijkingstag. Anders wordt het, indien mogelijk, weergegeven met unicode
tekens.

docx Het wordt weergegeven met behulp van OMML wiskundige opmaak.

FictieBoek2
Als de optie --webtex wordt gebruikt, worden formules weergegeven als afbeeldingen met behulp van Google Charts
of andere compatibele webservice, gedownload en ingebed in het e-book. Anders,
ze zullen letterlijk verschijnen.

HTML-code, glibberig, DZ-dia's, S5, EPUB
De manier waarop wiskunde in HTML wordt weergegeven, is afhankelijk van de geselecteerde opdrachtregelopties:

1. De standaard is om TeX-wiskunde zoveel mogelijk weer te geven met Unicode-tekens,
zoals bij RTF-, DocBook- en OpenDocument-uitvoer. Formules worden binnen een bereik geplaatst
met class="math", zodat ze anders kunnen worden vormgegeven dan de omgeving
tekst indien nodig.

2. Als de optie --latexmathml wordt gebruikt, wordt TeX math weergegeven tussen $ of $$
karakters en plaats tags met klasse LaTeX. Het LaTeXMathML-script wel
worden gebruikt om het als formules weer te geven. (Deze truc werkt niet in alle browsers,
maar het werkt in Firefox. In browsers die LaTeXMathML niet ondersteunen, wordt TeX math
verschijnt letterlijk tussen $-tekens.)

3. Als de optie --jsmath wordt gebruikt, wordt TeX-wiskunde in tags geplaatst (voor
inline wiskunde) of tags (voor weergave wiskunde) met klasse wiskunde. De jsMath
script zal worden gebruikt om het weer te geven.

4. Als de optie --mimetex wordt gebruikt, wordt het mimeTeX CGI-script aangeroepen
genereer afbeeldingen voor elke TeX-formule. Dit zou in alle browsers moeten werken. De
--mimetex optie neemt een optionele URL als argument. Als er geen URL is opgegeven, is het
wordt aangenomen dat het mimeTeX CGI-script zich in /cgi-bin/mimetex.cgi bevindt.

5. Als de optie --gladtex wordt gebruikt, worden TeX-formules ingesloten tagt in
de HTML-uitvoer. Het resulterende htex-bestand kan vervolgens worden verwerkt door gladTeX,
die voor elke formule afbeeldingsbestanden zal produceren en een HTML-bestand met koppelingen naar
deze afbeeldingen. De werkwijze is dus:

pandoc -s --gladtex mijnbestand.txt -o mijnbestand.htex
gladtex -d mijnbestand-afbeeldingen mijnbestand.htex
# produceert myfile.html en afbeeldingen in myfile-images

6. Als de optie --webtex wordt gebruikt, worden TeX-formules geconverteerd naar labels
die link naar een extern script dat formules omzet in afbeeldingen. De Formule
wordt URL-gecodeerd en samengevoegd met de verstrekte URL. Als er geen URL is
opgegeven, wordt de Google Chart API gebruikt
(http://chart.apis.google.com/chart?cht=tx&chl=).

7. Als de optie --mathjax wordt gebruikt, wordt TeX math weergegeven tussen \(...\) (voor
inline wiskunde) of \[...\] (voor weergave wiskunde) en plaats tags met class
wiskunde. Het MathJax-script wordt gebruikt om het als formules weer te geven.

Rauw HTML
Uitbreiding: ruwe_html
Met Markdown kunt u overal in een document onbewerkte HTML (of DocBook) invoegen (behalve
woordelijke contexten, waarbij <, > en & letterlijk worden geïnterpreteerd). (Technisch gezien is dit niet het geval
een extensie, aangezien de standaard Markdown het toestaat, maar er is een extensie van gemaakt zodat
het kan indien gewenst worden uitgeschakeld.)

De onbewerkte HTML wordt ongewijzigd doorgegeven in HTML, S5, Slidy, Slideous, DZSlides, EPUB,
Markdown en textieluitvoer, en onderdrukt in andere formaten.

Uitbreiding: markdown_in_html_blocks
Standaard Markdown stelt u in staat HTML "blokken" op te nemen: blokken HTML tussen gebalanceerd
tags die met lege regels van de omringende tekst zijn gescheiden en beginnen en eindigen op
de linkermarge. Binnen deze blokken wordt alles geïnterpreteerd als HTML, niet als Markdown; Dus
(bijvoorbeeld), * betekent geen nadruk.

Pandoc gedraagt ​​zich op deze manier wanneer het formaat markdown_strict wordt gebruikt; maar standaard pandoc
interpreteert materiaal tussen HTML-bloktags als Markdown. Zo zal Pandoc bijvoorbeeld
draaien



*een*
[een link](http://google.com)



om in



een
<a href="/http://google.com">een koppeling



terwijl Markdown.pl het zal behouden zoals het is.

Er is één uitzondering op deze regel: tekst tussen and tags is not
geïnterpreteerd als Markdown.

Deze afwijking van standaard Markdown zou het gemakkelijker moeten maken om Markdown met HTML te mixen
blok elementen. Men kan bijvoorbeeld een blok Markdown-tekst omringen met labels
zonder te voorkomen dat het wordt geïnterpreteerd als Markdown.

Uitbreiding: inheemse_divs
Gebruik native Pandoc Div-blokken voor inhoud binnenin labels. Voor het grootste deel zou dit moeten
geeft dezelfde output als markdown_in_html_blocks, maar het maakt het makkelijker om pandoc te schrijven
filters om groepen blokken te manipuleren.

Uitbreiding: native_spans
Gebruik native Pandoc Span-blokken voor inhoud binnen tags. Voor het grootste deel dit
zou dezelfde uitvoer moeten geven als raw_html, maar het maakt het gemakkelijker om pandoc-filters naar te schrijven
manipuleren van groepen inlines.

Rauw TeX
Uitbreiding: ruwe_tex
Naast onbewerkte HTML maakt pandoc het mogelijk om onbewerkte LaTeX, TeX en ConTeXt op te nemen in een
document. Inline TeX-commando's worden bewaard en ongewijzigd doorgegeven aan de LaTeX en
ConTeXt-schrijvers. Zo kunt u bijvoorbeeld LaTeX gebruiken om BibTeX-citaties op te nemen:

Dit resultaat werd bewezen in \cite{jones.1967}.

Merk op dat in LaTeX-omgevingen, zoals

\begin{tabular}{|l|l|}\hlijn
Leeftijd & Frequentie \\ \hline
18--25 & 15 \\
26--35 & 33 \\
36--45 & 22 \\ \hlijn
\end{tabel}

het materiaal tussen de begin- en eindtags wordt geïnterpreteerd als onbewerkte LaTeX, niet als
Afwaardering.

Inline LaTeX wordt genegeerd in andere uitvoerindelingen dan Markdown, LaTeX en ConTeXt.

Latex macro's
Uitbreiding: latex_macro's
Voor uitvoerformaten anders dan LaTeX, zal pandoc LaTeX \newcommand en \renewcommand ontleden
definities en pas de resulterende macro's toe op alle LaTeX-wiskunde. Dus bijvoorbeeld de
het volgende werkt in alle uitvoerformaten, niet alleen in LaTeX:

\nieuwcommando{\tuple}[1]{\langle #1 \rangle}

$\tuple{a, b, c}$

In LaTeX-uitvoer wordt de \newcommand-definitie gewoon ongewijzigd doorgegeven aan de uitvoer.

Kruisstukken
Met Markdown kunnen koppelingen op verschillende manieren worden gespecificeerd.

Automatisch links
Als u een URL of e-mailadres tussen punthaken plaatst, wordt het een link:

<http://google.com>
<[e-mail beveiligd]>

In lijn links
Een inline link bestaat uit de linktekst tussen vierkante haken, gevolgd door de URL in
haakjes. (Optioneel kan de URL worden gevolgd door een linktitel, tussen aanhalingstekens.)

Dit is een [inline link](/url), en hier is [een met
een titel](http://fsf.org "klik hier voor een leuke tijd!").

Er mag geen spatie zijn tussen het gedeelte tussen haakjes en het gedeelte tussen haakjes. De link
tekst kan opmaak bevatten (zoals nadruk), maar de titel niet.

E-mailadressen in inline links worden niet automatisch gedetecteerd, dus moeten ze worden voorafgegaan door
mailto:

[Schrijf me!](mailto:[e-mail beveiligd])

Referentie links
An uitdrukkelijk referentielink bestaat uit twee delen, de link zelf en de linkdefinitie, die
kan elders in het document voorkomen (voor of na de link).

De link bestaat uit linktekst tussen vierkante haken, gevolgd door een label tussen vierkante haken.
(Er kan ruimte tussen beide zijn.) De koppelingsdefinitie bestaat uit het label tussen haakjes,
gevolgd door een dubbele punt en een spatie, gevolgd door de URL, en optioneel (na een spatie) a
linktitel tussen aanhalingstekens of tussen haakjes. Het label mag niet ontleedbaar zijn als een
citatie (ervan uitgaande dat de citaties-extensie is ingeschakeld): citaties hebben voorrang op
koppelingslabels.

Hier zijn een paar voorbeelden:

[mijn label 1]: /foo/bar.html "Mijn titel, optioneel"
[mijn label 2]: /foo
[mijn label 3]: http://fsf.org (De stichting voor vrije software)
[mijn label 4]: /bar#special 'Een titel tussen enkele aanhalingstekens'

De URL kan optioneel worden omgeven door punthaken:

[mijn label 5]:http://foo.bar.baz>

De titel kan op de volgende regel komen:

[mijn label 3]: http://fsf.org
"De basis voor vrije software"

Houd er rekening mee dat koppelingslabels niet hoofdlettergevoelig zijn. Dit gaat dus werken:

Hier is [mijn link][FOO]

[Foo]: /bar/baz

In een stilzwijgend referentielink, het tweede paar haakjes is leeg:

Zie [mijn website][].

[mijn website]: http://foo.bar.baz

Opmerking: in Markdown.pl en de meeste andere Markdown-implementaties verwijzen linkdefinities
kan niet voorkomen in geneste constructies zoals lijstitems of blokcitaten. Pandoc-liften
deze willekeurig ogende beperking. Dus het volgende is prima in pandoc, maar niet in
de meeste andere implementaties:

> Mijn blok [quote].
>
> [citaat]: /foo

Uitbreiding: snelkoppeling_referentie_links
In een kortere weg referentielink, het tweede paar haakjes kan geheel worden weggelaten:

Zie [mijn website].

[mijn website]: http://foo.bar.baz

Intern links
Gebruik het automatisch gegenereerde
identifier (zie Header identifiers). Bijvoorbeeld:

Zie de [Inleiding](#inleiding).

or

Zie de [Inleiding].

[Introductie]: #introductie

Interne links worden momenteel ondersteund voor HTML-indelingen (inclusief HTML-diavoorstellingen en
EPUB), LaTeX en ConTeXt.

Afbeeldingen
Een link onmiddellijk voorafgegaan door een ! wordt behandeld als een afbeelding. De linktekst zal zijn
gebruikt als de alt-tekst van de afbeelding:


![filmrol]

[filmrol]: movie.gif

Uitbreiding: impliciete_figuren
Een afbeelding die op zichzelf in een alinea voorkomt, wordt weergegeven als een figuur met een bijschrift.
(In LaTeX wordt een figuuromgeving gebruikt; in HTML wordt de afbeelding in een div
met klassefiguur, samen met een bijschrift in ap met klassebijschrift.) De alt
tekst wordt gebruikt als onderschrift.


Als je gewoon een normale inline afbeelding wilt, zorg er dan voor dat dit niet het enige is in de
paragraaf. Een manier om dit te doen is door een vaste spatie in te voegen na de afbeelding:

\

Uitbreiding: link_attributen
Attributen kunnen worden ingesteld op links en afbeeldingen:

Een inline {#id .class width=30 height=20px}
en een referentie ![image][ref] met attributen.

[ref]: foo.jpg "optionele titel" {#id .class key=val key2="val 2"}

(Deze syntaxis is compatibel met PHP Markdown Extra wanneer alleen #id en .class worden gebruikt.)

Voor HTML en EPUB, alle kenmerken behalve breedte en hoogte (maar inclusief srcset en maten)
worden doorgegeven zoals ze zijn. De andere schrijvers negeren attributen die niet worden ondersteund door
hun uitvoerformaat.

De attributen width en height op afbeeldingen worden speciaal behandeld. Bij gebruik zonder een
eenheid, wordt aangenomen dat de eenheid pixels is. Echter, een van de volgende eenheids-ID's
kan worden gebruikt: px, cm, mm, in, inch en %. Er mogen geen spaties tussen het nummer staan
en de eenheid. Bijvoorbeeld:

{ breedte=50% }

· Afmetingen worden geconverteerd naar inches voor uitvoer in op pagina's gebaseerde formaten zoals LaTeX.
Afmetingen worden geconverteerd naar pixels voor uitvoer in HTML-achtige formaten. Gebruik de --dpi
optie om het aantal pixels per inch op te geven. De standaardinstelling is 96 dpi.

· De eenheid % is over het algemeen relatief ten opzichte van enige beschikbare ruimte. Bijvoorbeeld bovenstaand voorbeeld
zal geven aan (HTML),
\includegraphics[width=0.5\textwidth]{file.jpg} (LaTeX), of
\externfiguur[bestand.jpg][breedte=0.5\tekstbreedte] (ConTeXt).

· Sommige uitvoerformaten hebben de notie van een klasse (ConTeXt) of een unieke identifier (LaTeX
\caption), of beide (HTML).

· Als er geen kenmerken voor breedte of hoogte zijn opgegeven, is de terugval om naar de afbeelding te kijken
resolutie en de dpi-metagegevens die zijn ingesloten in het afbeeldingsbestand.

voetnoten
Uitbreiding: voetnoten
Pandoc's Markdown staat voetnoten toe, waarbij de volgende syntaxis wordt gebruikt:

Hier is een voetnootreferentie,[^1] en nog een.[^longnote]

[^1]: Hier is de voetnoot.

[^longnote]: Hier is er een met meerdere blokken.

Volgende paragrafen zijn ingesprongen om aan te geven dat ze
horen bij de vorige voetnoot.

{ een.code }

De hele alinea kan worden ingesprongen, of alleen de eerste
lijn. Op deze manier werken voetnoten met meerdere alinea's zoals
lijstitems met meerdere alinea's.

Deze alinea zal geen deel uitmaken van de notitie, omdat het
is niet ingesprongen.

De identifiers in voetnootverwijzingen mogen geen spaties, tabs of nieuwe regels bevatten. Deze
identifiers worden alleen gebruikt om de voetnootverwijzing te correleren met de noot zelf; in de
uitvoer, worden voetnoten opeenvolgend genummerd.

De voetnoten zelf hoeven niet aan het einde van het document te worden geplaatst. Ze kunnen verschijnen
overal behalve binnen andere blokelementen (lijsten, blokcitaten, tabellen, enz.).

Uitbreiding: inline_notities
Inline voetnoten zijn ook toegestaan ​​(hoewel ze, in tegenstelling tot gewone noten, geen
meerdere alinea's). De syntaxis is als volgt:

Hier is een inline-notitie.^[Inline-notities zijn sindsdien gemakkelijker te schrijven
u hoeft geen identifier te kiezen en naar beneden te gaan om de te typen
opmerking.]

Inline en reguliere voetnoten kunnen vrij worden gemengd.

Citaten
Uitbreiding: citaten
Met behulp van een extern filter, pandoc-citeproc, kan pandoc automatisch citaties en
een bibliografie in een aantal stijlen. Basisgebruik is

pandoc --filter pandoc-citeproc mijninvoer.txt

Om deze functie te gebruiken, moet u een bibliografiebestand specificeren met behulp van de
bibliografie-metagegevensveld in een YAML-metagegevenssectie of --bibliography-opdrachtregel
argument. U kunt meerdere --bibliography-argumenten opgeven of bibliografie-metadata instellen
veld naar YAML-array, als u meerdere bibliografiebestanden wilt gebruiken. De bibliografie mag
hebben een van deze formaten:

Formaat Bestandsextensie
──────────────────────────────
BibLaTeX .bib
BibTeX .bibtex
Copac.copac

CSL JSON .json
CSL YAML .yaml
EndNote .nl
EndNote XML .xml
ISI.wos
MEDLINE .medline
MODS .mods
RIS.ris

Merk op dat .bib kan worden gebruikt met zowel BibTeX- als BibLaTeX-bestanden; gebruik .bibtex om te forceren
BibTeX.

Merk op dat pandoc-citeproc --bib2json en pandoc-citeproc --bib2yaml .json en
.yaml-bestanden van een van de ondersteunde indelingen.

In-field markup: in BibTeX- en BibLaTeX-databases analyseert pandoc-citeproc een subset van
LaTeX-opmaak; in CSL YAML-databases, pandoc Markdown; en in CSL JSON-databases, een
HTML-achtige opmaak:


cursief

...
pin

<Span style="font-variant:small-caps;">... or ...
kleine hoofdletters

...
subscript

...
superscript

<Span class="nocase">...
voorkomen dat een zin met een hoofdletter wordt geschreven als hoofdlettergebruik

pandoc-citeproc -j en -y converteren de CSL JSON- en CSL YAML-formaten voor zover
mogelijk.

Als alternatief voor het specificeren van een bibliografiebestand met behulp van --bibliography of de YAML
metadataveld bibliografie kunt u de citatiegegevens direct in de referenties opnemen
veld van de YAML-metadata van het document. Het veld moet een array van YAML-gecodeerd bevatten
referenties, bijvoorbeeld:

---
referenties:
- type: artikel-tijdschrift
Identiteitskaart: WatsonCrick1953
auteur:
- familie: Watson
gegeven: JD
- familie: Krekel
gegeven: FHC
uitgegeven:
datum-delen:
- - 1953
- 4
- 25
titel: 'Moleculaire structuur van nucleïnezuren: een structuur voor deoxyribose
Nucleïnezuur'
title-short: Moleculaire structuur van nucleïnezuren
containertitel: Natuur
inhoud: 171
uitgave: 4356
pagina: 737-738
DOI: 10.1038/171737a0
URL: http://www.nature.com/nature/journal/v171/n4356/abs/171737a0.html
taal: en-GB
...

(pandoc-citeproc --bib2yaml kan deze produceren uit een bibliografiebestand in een van de
ondersteunde formaten.)

Citaties en referenties kunnen worden opgemaakt met elke stijl die wordt ondersteund door de Citation Style
Taal, vermeld in de Zotero Style Repository. Deze bestanden worden gespecificeerd met behulp van de
--csl optie of het csl metadata veld. Pandoc-citeproc gebruikt standaard de Chicago
Handleiding van Style auteur-datum formaat. Het CSL-project geeft meer informatie over
stijlen vinden en bewerken.

Om uw citaten hyperlinks te maken naar de overeenkomstige bibliografie-items, voegt u toe
link-citaties: trouw aan uw YAML-metadata.

Citaten staan ​​tussen vierkante haken en worden gescheiden door puntkomma's. Elke vermelding moet
een sleutel hebben, samengesteld uit '@' + de citatie-ID uit de database, en mag
optioneel een voorvoegsel, een locator en een achtervoegsel hebben. De citatiesleutel moet beginnen met een
letter, cijfer of _, en kan alfanumerieke tekens, _ en interne leestekens bevatten
(:.#$%&-+?<>~/). Hier zijn enkele voorbeelden:

Bla bla [zie @doe99, pp. 33-35; ook @smith04, hoofdstuk. 1].

Bla bla [@doe99, pp. 33-35, 38-39 en *passim*].

Bla bla [@smith04; @doe99].

pandoc-citeproc detecteert locatortermen in de CSL locale bestanden. Ofwel afgekort of
onverkorte formulieren worden geaccepteerd. In de landinstelling en-US kunnen locator-termen worden geschreven
enkelvoud of meervoud, als boek, bk./bks.; hoofdstuk, hoofdstuk/hoofdstuk; kolom,
col./cols.; figuur, afb./afb.; folio, fol./fols.; nummer, nr./nrs.; lijn, l./ll.; opmerking,
n./nn.; opus, op./opp.; pagina, p./pp.; alinea, alinea/paragrafen; deel, pt./ptn.; sectie,
sec./sec.; subverbo, sv/s.vv.; vers, v./vv.; volume, vol./vol.; ¶/¶¶; §/§§. Als Nee
locatorterm wordt gebruikt, wordt uitgegaan van "pagina".

Een minteken (-) voor de @ onderdrukt de vermelding van de auteur in de bronvermelding. Dit
kan handig zijn als de auteur al in de tekst wordt genoemd:

Smith zegt blah [-@smith04].

U kunt ook als volgt een citaat in de tekst schrijven:

@smith04 zegt blah.

@smith04 [blz. 33] zegt bla.

Als de stijl een lijst met geciteerde werken vereist, wordt deze aan het einde van de
document. Normaal gesproken wilt u uw document beëindigen met een passende koptekst:

laatste paragraaf...

# Referenties

De bibliografie wordt na deze kop ingevoegd. Merk op dat de ongenummerde klasse zal
worden toegevoegd aan deze kop, zodat de sectie niet wordt genummerd.

Als u items in de bibliografie wilt opnemen zonder ze daadwerkelijk in de hoofdtekst te citeren
tekst, kunt u een dummy nocite-metadataveld definiëren en de citaten daar plaatsen:

---
nocite: |
@item1, @item2
...

@item3

In dit voorbeeld bevat het document alleen een citaat voor item3, maar de bibliografie
bevat items voor item1, item2 en item3.

Voor LaTeX- of PDF-uitvoer kunt u ook natbib of biblatex gebruiken om bibliografie weer te geven. In
Om dit te doen, specificeert u bibliografiebestanden zoals hierboven beschreven, en voegt u --natbib of toe
--biblatex argument voor aanroeping van pandoc. Houd er rekening mee dat bibliografiebestanden moeten zijn
in respectievelijk formaat (BibTeX of BibLaTeX).

Zie voor meer informatie de man-pagina van pandoc-citeproc.

Niet-pandoc extensies
De volgende Markdown-syntaxisextensies zijn niet standaard ingeschakeld in pandoc, maar kunnen dat wel zijn
ingeschakeld door +EXTENSION toe te voegen aan de formaatnaam, waarbij EXTENSION de naam is van het
verlenging. Markdown+hard_line_breaks is bijvoorbeeld Markdown met harde lijn
pauzes.

Uitbreiding: lijsten_zonder_voorafgaande_blankline
Laat een lijst direct na een alinea verschijnen, zonder tussenliggende spatie.

Uitbreiding: harde_line_breaks
Zorgt ervoor dat alle nieuwe regels binnen een alinea worden geïnterpreteerd als harde regeleinden in plaats van
ruimten.

Uitbreiding: negeer_lijn_einden
Zorgt ervoor dat nieuwe regels binnen een alinea worden genegeerd, in plaats van te worden behandeld als spaties of
als harde regeleinden. Deze optie is bedoeld voor gebruik met Oost-Aziatische talen waar
spaties worden niet gebruikt tussen woorden, maar tekst is verdeeld in regels voor de leesbaarheid.

Uitbreiding: oost_asian_line_breaks
Zorgt ervoor dat nieuwe regels binnen een alinea worden genegeerd, in plaats van te worden behandeld als spaties of
als harde regeleinden, wanneer ze voorkomen tussen twee Oost-Aziatische brede karakters. Dit is een
betere keuze dan ignore_line_breaks voor teksten die een mix van Oost-Aziatische brede bevatten
karakters en andere karakters.

Uitbreiding: emoji
Parseert tekstuele emoji's zoals :smile: als Unicode-emoticons.

Uitbreiding: tex_math_single_backslash
Zorgt ervoor dat alles tussen \( en \) wordt geïnterpreteerd als inline TeX-wiskunde, en alles
tussen \[ en \] om te worden geïnterpreteerd als display TeX math. Let op: een nadeel hiervan
extensie is dat het escapen ( en [.

Uitbreiding: tex_math_dubbele_backslash
Zorgt ervoor dat alles tussen \\( en \\) wordt geïnterpreteerd als inline TeX-wiskunde, en alles
tussen \\[ en \\] om te worden geïnterpreteerd als weergave TeX-wiskunde.

Uitbreiding: markdown_kenmerk
Standaard interpreteert pandoc materiaal binnen tags op blokniveau als Markdown. Dit
De extensie verandert het gedrag zodat Markdown alleen binnen tags op blokniveau wordt geparseerd als
de tags hebben het kenmerk markdown=1.

Uitbreiding: mmd_title_blok
Maakt een titelblok in MultiMarkdown-stijl boven aan het document mogelijk, bijvoorbeeld:

Titel: Mijn titel
Auteur: John Doe
Date: September 1, 2008
Commentaar: Dit is een voorbeeld van een mmd-titelblok, met
een veld dat meerdere lijnen omvat.

Zie de MultiMarkdown-documentatie voor details. Als pandoc_title_block of
yaml_metadata_block is ingeschakeld, heeft het voorrang op mmd_title_block.

Uitbreiding: afkortingen
Parseert PHP Markdown Extra afkortingen, zoals

*[HTML]: Hypertext-opmaaktaal

Merk op dat het pandoc-documentmodel geen afkortingen ondersteunt, dus als deze extensie
is ingeschakeld, worden afkortingen gewoon overgeslagen (in plaats van te worden geparseerd als
paragrafen).

Uitbreiding: autolink_bare_uris
Maakt van alle absolute URI's koppelingen, zelfs als deze niet tussen puntige accolades <...> staan.

Uitbreiding: ascii_identifiers
Zorgt ervoor dat de identifiers geproduceerd door auto_identifiers pure ASCII zijn. Accenten zijn
ontdaan van Latijnse letters met accenten, en niet-Latijnse letters worden weggelaten.

Uitbreiding: mmd_link_attributen
Parseert sleutel-waardekenmerken in multimarkdown-stijl op link- en afbeeldingsreferenties. Dit
extensie moet niet worden verward met de extensie link_attributes.

Dit is een referentie ![image][ref] met multimarkdown attributen.

[referentie]: http://path.to/image "Afbeeldingstitel" width=20px height=30px
id=mijnId class="mijnKlasse1 mijnKlasse2"

Uitbreiding: mmd_header_identifiers
Parseert koptekst-ID's in multimarkdown-stijl (tussen vierkante haken, na de koptekst but
vóór eventuele volgnummers in een ATX-header).

Uitbreiding: compacte_definitie_lijsten
Activeert de syntaxis van de definitielijst van Pandoc 1.12.x en eerder. Deze syntaxis verschilt
van degene die hierboven is beschreven onder Definitielijsten in verschillende opzichten:

· Er is geen lege regel vereist tussen opeenvolgende items van de definitielijst.

· Laat ruimte tussen opeenvolgende items weg om een ​​"strakke" of "compacte" lijst te krijgen; de ruimte
tussen een term en zijn definitie heeft geen invloed op iets.

· Luie terugloop van alinea's is niet toegestaan: de hele definitie moet vier inspringen
ruimten.

Markdown varianten
Naast de uitgebreide Markdown van pandoc worden de volgende Markdown-varianten ondersteund:

markdown_phpextra (PHP Markdown Extra's)
voetnoten, pipe_tables, raw_html, markdown_attribute, fenced_code_blocks,
definition_lists, intraword_underscores, header_attributes, link_attributes,
afkortingen, shortcut_reference_links.

markdown_github (GitHub-gearomatiseerd afwaardering)
pipe_tables, raw_html, tex_math_single_backslash, omheinde_code_blokken,
auto_identifiers, ascii_identifiers, backtick_code_blocks, autolink_bare_uris,
intraword_underscores, strikeout, harde_line_breaks, emoji,
snelkoppeling_referentie_links.

prijsverlaging_mmd (MultiMarkdown)
pipe_tables raw_html, markdown_attribute, mmd_link_attributes, raw_tex,
tex_math_double_backslash, intraword_underscores, mmd_title_block, voetnoten,
definition_lists, all_symbols_escapable, impliciete_header_referenties,
auto_identifiers, mmd_header_identifiers, snelkoppeling_referentie_links.

prijsverlaging_strikt (Markdown.pl)
ruwe_html

uitbreidingen met formaten anders neem contact Markdown
Sommige van de hierboven besproken extensies kunnen worden gebruikt met andere indelingen dan Markdown:

· auto_identifiers kunnen worden gebruikt met invoer van latex, rst, mediawiki en textiel (en wordt gebruikt
standaard).

· tex_math_dollars, tex_math_single_backslash en tex_math_double_backslash kunnen worden gebruikt
met html-invoer. (Dit is handig voor het lezen van webpagina's die zijn opgemaakt met MathJax, voor
voorbeeld.)

PRODUCEREN DIA SHOWS MET PANDOC

U kunt pandoc gebruiken om een ​​HTML + javascript diapresentatie te maken die kan worden bekeken
via een webbrowser. Er zijn vijf manieren om dit te doen, met behulp van S5, DZSlides, Slidy, Slideous,
of onthullen.js. U kunt ook een PDF-diavoorstelling maken met LaTeX-beamer.

Hier is de Markdown-bron voor een eenvoudige diavoorstelling, habit.txt:

% Gebruiken
% John Doe
% 22 maart 2005

# In de ochtend

## Opstaan

- Wekker uitschakelen
- Opstaan

## Ontbijt

- Eet eieren
- Koffie drinken

# S avonds

## Diner

- Eet spagetti
- Drink wijn

------------------


## Gaan slapen

- Ga naar bed
- Schapen tellen

Typ gewoon om een ​​HTML/javascript-diavoorstelling te maken

pandoc -t FORMAT -s gewoonten.txt -o gewoonten.html

waarbij FORMAT s5, slidy, slideous, dzslides of revealjs is.

Voor Slidy, Slideous, reveal.js en S5 is het bestand geproduceerd door pandoc met de
-s/--standalone optie sluit een link in naar javascripts en CSS-bestanden, waarvan wordt aangenomen dat ze
beschikbaar op het relatieve pad s5/default (voor S5), slideous (voor Slideous), reveal.js
(voor reveal.js), of op de Slidy-website op w3.org (voor Slidy). (Deze paden kunnen zijn
gewijzigd door de variabelen slidey-url, slideous-url, revealjs-url of s5-url in te stellen; zien
Variabelen voor dia's, hierboven.) Voor DZSlides zijn de (relatief korte) javascript en css
standaard in het bestand opgenomen.

Bij alle HTML-dia-indelingen kan de optie --self-contained worden gebruikt om er een te maken
bestand dat alle gegevens bevat die nodig zijn om de diavoorstelling weer te geven, inclusief gekoppeld
scripts, stylesheets, afbeeldingen en video's.

Om een ​​PDF-diavoorstelling te maken met behulp van beamer, typt u

pandoc -t beamer gewoonten.txt -o gewoonten.pdf

Merk op dat een diavoorstelling van Reveal.js ook kan worden geconverteerd naar een PDF door deze naar een bestand af te drukken
vanuit de browser.

Structureren the glijbaan tonen
Standaard is de glijbaan niveau is het hoogste koptekstniveau in de hiërarchie dat wordt gevolgd
direct op inhoud, en niet op een andere kop, ergens in het document. In het voorbeeld
hierboven worden kopteksten van niveau 1 altijd gevolgd door kopteksten van niveau 2, die worden gevolgd door
inhoud, dus 2 is het niveau van de dia. Deze standaard kan worden overschreven met behulp van --slide-level
optie.

Het document is opgedeeld in dia's volgens de volgende regels:

· Een horizontale regel start altijd een nieuwe dia.

· Een koptekst op dianiveau start altijd een nieuwe dia.

· Kopteksten onder het dianiveau in de hiërarchie maakt kopteksten binnen een glijbaan.

· Kopteksten boven het dianiveau in de hiërarchie maakt "titeldia's", die alleen bevatten
de sectietitel en hulp om de diavoorstelling in secties op te splitsen.

· Een titelpagina wordt automatisch opgebouwd uit het titelblok van het document, indien aanwezig.
(In het geval van beamer kan dit worden uitgeschakeld door standaard enkele regels uit te commentariëren
sjabloon.)

Deze regels zijn ontworpen om veel verschillende stijlen van diavoorstellingen te ondersteunen. Als je dat niet doet
Als u uw dia's wilt structureren in secties en subsecties, kunt u gewoon niveau 1 gebruiken
kopteksten voor alle dia's. (In dat geval is niveau 1 het dia-niveau.) Maar dat kan
structureer de diavoorstelling ook in secties, zoals in het bovenstaande voorbeeld.

Opmerking: in diashows van reveal.js, als het dianiveau 2 is, is er een tweedimensionale lay-out
geproduceerd, met level 1 headers horizontaal bouwen en level 2 headers bouwen
verticaal. Het wordt niet aanbevolen om diepere nesting van sectieniveaus te gebruiken
onthullen.js.

Incrementeel lijsten
Standaard produceren deze schrijvers lijsten die 'allemaal tegelijk' weergeven. Als je je lijsten wilt
gebruik de optie -i om incrementeel weer te geven (één item tegelijk). Als je een
bepaalde lijst om af te wijken van de standaard (dat wil zeggen om stapsgewijs weer te geven zonder de
-i optie en alles in één keer met de -i optie), zet het in een blokcitaat:

> - Eet spaghetti
> - Drink wijn

Op deze manier kunnen incrementele en niet-incrementele lijsten in één document worden gemengd.

invoegen pauzes
U kunt "pauzes" toevoegen aan een dia door een alinea op te nemen met drie punten,
gescheiden door spaties:

# Schuif met een pauze

inhoud voor de pauze

. . .

inhoud na de pauze

Styling the dia's
U kunt de stijl van HTML-dia's wijzigen door er aangepaste CSS-bestanden in te plaatsen
$DATADIR/s5/default (voor S5), $DATADIR/slidy (voor Slidy) of $DATADIR/slideous (voor
Slideous), waarbij $DATADIR de map met gebruikersgegevens is (zie --data-dir, hierboven). De
originelen zijn te vinden in de systeemgegevensdirectory van pandoc (in het algemeen
$CABALDIR/pandoc-VERSION/s5/default). Pandoc zal daar zoeken naar alle bestanden die het niet heeft
vinden in de map met gebruikersgegevens.

Voor dzslides is de CSS opgenomen in het HTML-bestand zelf en kan daar worden gewijzigd.

Alle configuratie-opties van reveal.js kunnen worden ingesteld via variabelen. Thema's kunnen dat bijvoorbeeld
worden gebruikt door de themavariabele in te stellen:

-V thema=maan

Of u kunt een aangepaste stylesheet specificeren met de optie --css.

Om beamer-dia's op te maken, kunt u een thema, kleurthema, lettertypethema, innerthema en
outertheme, met behulp van de optie -V:

pandoc -t beamer gewoonten.txt -V thema:Warschau -o gewoonten.pdf

Merk op dat koptekstattributen in dia-attributen veranderen (op een of ) in
HTML-dia-indelingen, waarmee u individuele dia's kunt stylen. In beamer, de enige header
attribuut dat van invloed is op dia's is de klasse allowframebreaks, die de
allowframebreaks, waardoor er meerdere dia's worden gemaakt als de inhoud te vol raakt
de lijst. Dit wordt vooral aanbevolen voor bibliografieën:

# Referenties {.allowframebreaks}

Spreker aantekeningen
onthullen.js heeft goede ondersteuning voor sprekernotities. U kunt notities toevoegen aan uw Markdown-document
dus:


Dit is mijn notitie.

- Het kan Markdown bevatten
- zoals deze lijst



Druk tijdens het bekijken van de presentatie op s om het notitievenster weer te geven. Notities zijn er nog niet
ondersteund voor andere dia-indelingen, maar de notities verschijnen niet op de dia's zelf.

Inlijsting attributen in beamer
Soms is het nodig om de LaTeX [fragile] optie toe te voegen aan een frame in beamer (voor
bijvoorbeeld bij gebruik van de geslagen omgeving). Dit kan geforceerd worden door het fragiele toe te voegen
class naar de koptekst die de dia introduceert:

# Breekbare glijbaan {.fragile}

Alle andere frame-attributen beschreven in Sectie 8.1 van de Beamer Gebruikershandleiding kunnen
ook worden gebruikt: allowdisplaybreaks, allowframebreaks, b, c, t, environment, label, plain,
krimpen.

CREREN EPUB's MET PANDOC

EPUB Metadata
EPUB-metadata kunnen worden opgegeven met de optie --epub-metadata, maar als de source
document Markdown is, is het beter om een ​​YAML-metadatablok te gebruiken. Hier is een voorbeeld:

---
titel:
- type: hoofd
tekst: Mijn Boek
- type: ondertitel
tekst: Een onderzoek naar metadata
Schepper:
- rol: auteur
tekst: John Smith
- rol: redacteur
tekst: Sarah Jones
identificatie:
- schema: DOI
tekst: doi:10.234234.234/33
uitgever: Mijn Pers
rechten: © 2007 John Smith, CC BY-NC
...

De volgende velden worden herkend:

identificatie
Ofwel een tekenreekswaarde of een object met velden tekst en schema. Geldige waarden voor
schema zijn ISBN-10, GTIN-13, UPC, ISMN-10, DOI, LCCN, GTIN-14, ISBN-13,
Wettelijk depotnummer, URN, OCLC, ISMN-13, ISBN-A, JP, OLCC.

titel Ofwel een tekenreekswaarde, ofwel een object met de velden file-as en type, of een lijst daarvan
voorwerpen. Geldige waarden voor type zijn main, subtitle, short, collection, edition,
uitgebreid.

schepper
Ofwel een tekenreekswaarde, of een object met velden role, file-as en text, of een lijst
van dergelijke objecten. Geldige waarden voor rol zijn MARC-relators, maar pandoc zal het proberen
om de voor mensen leesbare versies (zoals "auteur" en "editor") te vertalen naar het
juiste marc-relaties.

inzender
Zelfde formaat als maker.

gegevens Een tekenreekswaarde in de notatie JJJJ-MM-DD. (Alleen het jaartal is nodig.) Pandoc zal
probeer andere gangbare datumnotaties te converteren.

LANG (of nalatenschap: taal)
Een tekenreekswaarde in BCP 47-indeling. Pandoc zal standaard de lokale taal gebruiken als
er wordt niets gespecificeerd.

onderwerpen
Een tekenreekswaarde of een lijst met dergelijke waarden.

beschrijving
Een tekenreekswaarde.

type dan: Een tekenreekswaarde.

formaat Een tekenreekswaarde.

relatie
Een tekenreekswaarde.

dekking
Een tekenreekswaarde.

rechten Een tekenreekswaarde.

omslagfoto
Een tekenreekswaarde (pad naar omslagafbeelding).

stylesheet
Een tekenreekswaarde (pad naar CSS-stylesheet).

pagina-progressie-richting
Ofwel ltr of rtl. Hiermee geeft u het kenmerk paginavoortgangsrichting op voor het
ruggengraat element.

Linked gemiddeld
Pandoc zal standaard gekoppelde media (inclusief audio en video) downloaden en opnemen
in de EPUB-container, wat een volledig op zichzelf staande EPUB oplevert. Als je wilt linken naar
externe mediabronnen, gebruik in plaats daarvan onbewerkte HTML in uw bron en voeg data-external="1" toe aan
de tag met het src-attribuut. Bijvoorbeeld:


<source src="/http://example.com/music/toccata.mp3"
data-external="1" type="audio/mpeg">

GELETTERD HASKELL Support

Als u +lhs (of +literate_haskell) toevoegt aan een geschikt invoer- of uitvoerformaat
(markdown, markdown_strict, rst of latex voor input of output; beamer, html of html5 voor
uitvoer), zal Pandoc het document behandelen als geletterde Haskell-bron. Dit betekent dat

· In Markdown-invoer worden "bird track"-secties geparseerd als Haskell-code in plaats van
blok citaten. Tekst tussen \begin{code} en \end{code} wordt ook behandeld als
Haskell-code. Voor headers in ATX-stijl wordt het teken '=' gebruikt in plaats van '#'.

· In Markdown-uitvoer worden codeblokken met de klassen haskell en literate weergegeven met behulp van
vogelsporen en blokcitaten worden één spatie ingesprongen, dus dat is niet zo
behandeld als Haskell-code. Bovendien worden headers weergegeven in setext-stijl (met
onderstreept) in plaats van in ATX-stijl (met '#'-tekens). (Dit komt omdat ghc behandelt
'#'-tekens in kolom 1 als introductie van regelnummers.)

· In geherstructureerde tekstinvoer worden secties met "vogelsporen" geparseerd als Haskell-code.

· In geherstructureerde tekstuitvoer worden codeblokken met class haskell gerenderd met bird
tracks.

· In LaTeX-invoer wordt tekst in codeomgevingen geparseerd als Haskell-code.

· In LaTeX-uitvoer worden codeblokken met class haskell in code weergegeven
omgevingen.

· In HTML-uitvoer worden codeblokken met klasse haskell weergegeven met klasse
geletterde haskell en vogelsporen.

Voorbeelden:

pandoc -f prijsverlaging+lhs -t html

leest geletterde Haskell-broncode opgemaakt met Markdown-conventies en schrijft gewone HTML
(zonder vogelsporen).

pandoc -f prijsverlaging+lhs -t html+lhs

schrijft HTML met de Haskell-code in vogelsporen, zodat het kan worden gekopieerd en geplakt als
geletterde Haskell-bron.

SYNTAXIS BIJZONDERHEDEN

Pandoc markeert automatisch de syntaxis in omheinde codeblokken die zijn gemarkeerd met een
taal naam. De highlighting-kate van de Haskell-bibliotheek wordt gebruikt voor highlighting, welke
werkt in HTML-, Docx- en LaTeX/PDF-uitvoer. Het kleurenschema kan worden geselecteerd met behulp van de
--highlight-stijl optie. Het standaardkleurenschema is pygments, dat de
standaardkleurenschema gebruikt door de Python-bibliotheek pygments, maar pygments is dat eigenlijk niet
gebruikt om de markering te doen.

Typ pandoc --version om een ​​lijst met taalnamen te zien die pandoc zal herkennen.

Gebruik de optie --no-highlight om markeren uit te schakelen.

OP MAAT SCHRIJVERS

Pandoc kan worden uitgebreid met aangepaste schrijvers geschreven in lua. (Pandoc bevat een lua
interpreter, dus lua hoeft niet apart te worden geïnstalleerd.)

Om een ​​aangepaste schrijver te gebruiken, specificeert u eenvoudig het pad naar het lua-script in plaats van de uitvoer
formaat. Bijvoorbeeld:

pandoc -t data/sample.lua

Het maken van een aangepaste schrijver vereist het schrijven van een lua-functie voor elk mogelijk element in een
Pandoc-document. Om een ​​gedocumenteerd voorbeeld te krijgen dat u kunt wijzigen volgens uw
nodig heeft, doen

pandoc --print-default-gegevensbestand sample.lua

AUTEURS

© 2006-2015 John MacFarlane ([e-mail beveiligd]). Uitgegeven onder de GPL, versie 2 of
groter. Deze software heeft geen enkele garantie. (Zie COPYRIGHT voor volledig
copyright- en garantiemeldingen.)

Bijdragers zijn onder andere Aaron Wolen, Albert Krewinkel, Alexander Kondratskiy, Alexander
Sulfrian, Alexander V Vershilov, Alfred Wechselberger, Andreas Lööw, Andrew Dunning,
Antoine Latter, Arata Mizuki, Arlo O'Keeffe, Artyom Kazak, Ben Gamari, Beni
Cherniavsky-Paskin, Bjorn Buckwalter, Bradley Kuhn, Brent Yorgey, Bryan O'Sullivan, B.
Scott Michel, Caleb McDaniel, Calvin Beck, Christoffer Ackelman, Christoffer Sawicki,
Clare Macrae, Clint Adams, Conal Elliott, Craig S. Bosma, Daniel Bergey, Daniel T.
Staal, David Lazar, David Röthlisberger, Denis Laxalde, Douglas Calvert, Douglas F.
Calvert, Eric Kow, Eric Seidel, Florian Eitel, François Gannaz, Freiric Barral, Fyodor
Sheremetyev, Gabor Pali, Gavin Beatty, Greg Maslov, Grégory Bataille, Greg Rundlett,
gwern, Gwern Branwen, Hans-Peter Deifel, Henry de Valence, Ilya V. Portnov, oneindig0x,
Jaime Marquínez Ferrándiz, James Aspnes, Jamie F. Olson, Jan Larres, Jason Ronallo, Jeff
Arnold, Jeff Runningen, Jens Petersen, Jérémy Bobbio, Jesse Rosenthal, J. Lewis Muir, Joe
Hillenbrand, John MacFarlane, Jonas Smedegaard, Jonathan Daugherty, Josef Svenningsson,
Jose Luis Duran, Julien Cretel, Justin Bogner, Kelsey Hightower, Konstantin Zudov,
Lars-Dominik Braun, Luke Plant, Mark Szepieniec, Mark Wright, Masayoshi Takahashi, Matej
Kollar, Mathias Schenner, Matthew Pickering, Matthias CM Troffaes, Mauro Bieg, Max
Bolingbroke, Max Rydahl Andersen, Merijn Verstraaten, Michael Snoyman, Michael Thompson,
MinRK, Nathan Gass, Neil Mayhew, Nick Bart, Nicolas Kaiser, Nikolay Yakimov, nkalvi, Paulo
Tanimoto, Paul Rivier, Peter Wang, Philippe Ombredanne, Phillip Alday, Puneeth Chaganti,
qerub, Ralf Stephan, Recai Oktaş, rodja.trappe, RyanGlScott, Scott Morrison, Sergei
Trofimovich, Sergey Astanin, Shahbaz Youssefi, Shaun Attfield, shreevatsa.public, Simon
Hengel, Sumit Sahrawat, Takahashim, Thsutton, Tim Lin, Timothy Humphries, Todd Sifleet,
Tom Leese, Uli Köhler, Václav Zeman, Viktor Kronvall, Vincent, Wikiwide en Xavier Olive.

De Pandoc-broncode en alle documentatie kunnen worden gedownload vanhttp://pandoc.org>.

Gebruik pandoc online met behulp van onworks.net-services