pandoc - Online sa Cloud

PROGRAMA:

NAME

pandoc - pangkalahatang markup converter

SINOPSIS

pandoc [pagpipilian] [input-file] ...

DESCRIPTION

Ang Pandoc ay isang Haskell library para sa pag-convert mula sa isang markup format patungo sa isa pa, at a
command-line tool na gumagamit ng library na ito. Mababasa nito ang Markdown, CommonMark, PHP Markdown
Extra, GitHub-Flavored Markdown, at (mga subset ng) Textile, reStructuredText, HTML, LaTeX,
MediaWiki markup, TWiki markup, Haddock markup, OPML, Emacs Org mode, DocBook, txt2tags,
EPUB, ODT at Word docx; at maaari itong magsulat ng plain text, Markdown, CommonMark, PHP Markdown
Extra, GitHub-Flavored Markdown, reStructuredText, XHTML, HTML5, LaTeX (kabilang ang beamer
mga slide show), ConTeXt, RTF, OPML, DocBook, OpenDocument, ODT, Word docx, GNU Texinfo,
MediaWiki markup, DokuWiki markup, Haddock markup, EPUB (v2 o v3), FictionBook2, Textile,
groff man page, Emacs Org mode, AsciiDoc, InDesign ICML, at Slidy, Slideous, DZSlides,
reveal.js o S5 HTML slide show. Maaari rin itong gumawa ng PDF output sa mga system kung saan ang LaTeX,
Naka-install ang ConTeXt, o wkhtmltopdf.

Ang pinahusay na bersyon ng Markdown ng Pandoc ay may kasamang syntax para sa mga footnote, talahanayan, flexible
mga nakaayos na listahan, mga listahan ng kahulugan, nabakuran na mga bloke ng code, mga superscript at subscript,
strikeout, metadata blocks, awtomatikong talahanayan ng mga nilalaman, naka-embed na LaTeX math, mga pagsipi,
at Markdown sa loob ng HTML block elements. (Ang mga pagpapahusay na ito, na inilarawan sa ibaba sa ilalim ng
Pandoc's Markdown, maaaring i-disable gamit ang markdown_strict input o output format.)

Kabaligtaran sa karamihan ng mga kasalukuyang tool para sa pag-convert ng Markdown sa HTML, na gumagamit ng regex
mga pagpapalit, ang pandoc ay may modular na disenyo: binubuo ito ng isang hanay ng mga mambabasa, na nag-parse
teksto sa isang ibinigay na format at gumawa ng isang katutubong representasyon ng dokumento, at isang set ng
mga manunulat, na nagko-convert sa katutubong representasyong ito sa isang target na format. Kaya, ang pagdaragdag ng isang
input o output format ay nangangailangan lamang ng pagdaragdag ng isang mambabasa o manunulat.

Dahil ang intermediate na representasyon ng pandoc ng isang dokumento ay hindi gaanong nagpapahayag kaysa sa marami sa
ang mga format na kino-convert nito, hindi dapat umasa ng perpektong conversion sa pagitan ng bawat isa
format at bawat iba pa. Tinangka ni Pandoc na pangalagaan ang mga elemento ng istruktura ng a
dokumento, ngunit hindi pag-format ng mga detalye tulad ng laki ng margin. At ilang elemento ng dokumento,
tulad ng mga kumplikadong talahanayan, maaaring hindi magkasya sa simpleng modelo ng dokumento ng pandoc. Habang
ang mga conversion mula sa Markdown ng pandoc sa lahat ng mga format ay naghahangad na maging perpekto, mga conversion mula sa
ang mga format na mas nagpapahayag kaysa sa Markdown ng pandoc ay maaaring asahan na lossy.

paggamit pandoc
Kung hindi input-file ay tinukoy, ang input ay binabasa mula sa si stdin. Kung hindi man, ang mga input-file ay
pinagsama-sama (na may blangkong linya sa pagitan ng bawat isa) at ginamit bilang input. Pupunta ang output sa stdout by
default (bagaman ang output sa stdout ay hindi pinagana para sa odt, docx, epub, at epub3 na output
mga format). Para sa output sa isang file, gamitin ang -o na opsyon:

pandoc -o output.html input.txt

Bilang default, ang pandoc ay gumagawa ng isang fragment ng dokumento, hindi isang standalone na dokumento na may wastong
header at footer. Upang makagawa ng isang standalone na dokumento, gamitin ang -s o --standalone na flag:

pandoc -s -o output.html input.txt

Para sa higit pang impormasyon kung paano ginagawa ang mga standalone na dokumento, tingnan ang Mga Template, sa ibaba.

Sa halip na isang file, maaaring magbigay ng ganap na URI. Sa kasong ito, kukunin ni pandoc ang
nilalaman gamit ang HTTP:

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

Kung maraming input file ang ibinigay, pagsasamahin ng pandoc ang lahat ng ito (na may mga blangkong linya
sa pagitan nila) bago i-parse. Ang feature na ito ay hindi pinagana para sa binary input format gaya ng
EPUB, odt, at docx.

Ang format ng input at output ay maaaring tahasang tukuyin gamit ang mga opsyon sa command-line.
Maaaring tukuyin ang format ng pag-input gamit ang -r/--read o -f/--mula sa mga opsyon, ang output
format gamit ang -w/--write o -t/--to na mga opsyon. Kaya, upang i-convert ang hello.txt mula sa Markdown
sa LaTeX, maaari mong i-type ang:

pandoc -f markdown -t latex hello.txt

Upang i-convert ang hello.html mula sa HTML patungo sa Markdown:

pandoc -f html -t markdown hello.html

Ang mga sinusuportahang format ng output ay nakalista sa ibaba sa ilalim ng opsyong -t/--to. Sinusuportahang input
nakalista sa ibaba ang mga format sa ilalim ng opsyong -f/--from. Tandaan na ang una, tela, latex,
at html readers ay hindi kumpleto; may ilang mga construct na hindi nila na-parse.

Kung ang format ng input o output ay hindi tahasang tinukoy, susubukan ng pandoc na hulaan ito
mula sa mga extension ng input at output filename. Kaya, halimbawa,

pandoc -o hello.tex hello.txt

ay magko-convert ng hello.txt mula sa Markdown patungong LaTeX. Kung walang output file na tinukoy (kaya
napupunta ang output sa stdout), o kung hindi alam ang extension ng output file, ang format ng output
ay magiging default sa HTML. Kung walang tinukoy na input file (upang nagmumula ang input si stdin), o
kung ang mga extension ng input file ay hindi alam, ang input format ay ipapalagay na
Markdown maliban kung tahasang tinukoy.

Ginagamit ng Pandoc ang UTF-8 character encoding para sa parehong input at output. Kung ang iyong lokal
ang pag-encode ng character ay hindi UTF-8, dapat mong i-pipe ang input at output sa pamamagitan ng iconv:

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

Tandaan na sa ilang mga format ng output (tulad ng HTML, LaTeX, ConTeXt, RTF, OPML, DocBook, at
Texinfo), ang impormasyon tungkol sa pag-encode ng character ay kasama sa header ng dokumento,
na isasama lang kung gagamitin mo ang -s/--standalone na opsyon.

Paglikha a PDF
Para makagawa ng PDF, tumukoy ng output file na may extension na .pdf. Bilang default, gagawin ng pandoc
gamitin ang LaTeX upang i-convert ito sa PDF:

pandoc test.txt -o test.pdf

Ang paggawa ng isang PDF ay nangangailangan na ang isang LaTeX engine ay naka-install (tingnan ang --latex-engine, sa ibaba),
at ipinapalagay na ang mga sumusunod na pakete ng LaTeX ay magagamit: amsfonts, amsmath, lm,
ifxetex, ifluatex, eurosym, mga listahan (kung ginagamit ang --listings na opsyon), fancyvrb,
longtable, booktabs, graphicx at grffile (kung naglalaman ang dokumento ng mga larawan), hyperref,
ulem, geometry (na may geometry variable set), setspace (may linestretch), at babel
(with lang). Ang paggamit ng xelatex o lualatex bilang LaTeX engine ay nangangailangan ng fontspec;
Ang xelatex ay gumagamit ng mathspec, polyglossia (na may lang), xecjk, at bidi (na may dir variable
itakda). Ang mga upquote at microtype na pakete ay ginagamit kung magagamit, at csquotes ang gagamitin
para sa matalinong bantas kung idinagdag sa template o kasama sa anumang file ng header. Ang
Ang natbib, biblatex, bibtex, at biber na pakete ay maaaring opsyonal na gamitin para sa pagsipi
rendering. Kasama ang mga ito sa lahat ng kamakailang bersyon ng TeX Live.

Bilang kahalili, maaaring gamitin ng pandoc ang ConTeXt o wkhtmltopdf para gumawa ng PDF. Upang gawin ito, tukuyin
isang output file na may extension na .pdf, tulad ng dati, ngunit magdagdag ng -t context o -t html5 sa
command line.

Maaaring kontrolin ang output ng PDF gamit ang mga variable para sa LaTeX (kung LaTeX ang ginagamit) at mga variable
para sa ConTeXt (kung ConTeXt ang ginagamit). Kung wkhtmltopdf ang ginamit, pagkatapos ay ang mga variable na margin-left,
margin-right, margin-top, margin-bottom, at papersize ay makakaapekto sa output, gaya ng gagawin
--css.

Opsyon

Pangkalahatan pagpipilian
-f FORMAT, -r FORMAT, --mula sa=FORMAT, --basahin=FORMAT
Tukuyin ang format ng pag-input. FORMAT maaaring native (native Haskell), json (JSON version of
katutubong AST), markdown (pinalawak na Markdown ng pandoc), markdown_strict (orihinal
unextended Markdown), markdown_phpextra (PHP Markdown Extra), markdown_github
(GitHub-Flavored Markdown), commonmark (CommonMark Markdown), textile (Textile),
una (reStructuredText), html (HTML), docbook (DocBook), t2t (txt2tags), docx
(docx), odt (ODT), epub (EPUB), opml (OPML), org (Emacs Org mode), mediawiki
(MediaWiki markup), twiki (TWiki markup), haddock (Haddock markup), o latex
(LaTeX). Kung ang +lhs ay idinagdag sa markdown, una, latex, o html, ang magiging input ay
itinuturing bilang literate Haskell source: tingnan ang Literate Haskell support, sa ibaba. Markdown
ang mga extension ng syntax ay maaaring indibidwal na paganahin o hindi paganahin sa pamamagitan ng pagdaragdag ng +EXTENSION
o -EXTENSION sa pangalan ng format. Kaya, halimbawa,
Ang markdown_strict+footnotes+definition_lists ay mahigpit na Markdown na may mga footnote at
pinagana ang mga listahan ng kahulugan, at ang markdown-pipe_tables+hard_line_breaks ay kay pandoc
Markdown nang walang pipe table at may mga hard line break. Tingnan ang Markdown ng Pandoc,
sa ibaba, para sa isang listahan ng mga extension at kanilang mga pangalan.

-t FORMAT, -w FORMAT, --sa=FORMAT, --isulat=FORMAT
Tukuyin ang format ng output. FORMAT maaaring native (native Haskell), json (JSON version
ng katutubong AST), plain (plain text), markdown (pandoc's extended Markdown),
markdown_strict (orihinal unextended Markdown), markdown_phpextra (PHP Markdown
Extra), markdown_github (GitHub-Flavored Markdown), commonmark (CommonMark
Markdown), una (reStructuredText), html (XHTML), html5 (HTML5), latex (LaTeX),
beamer (LaTeX beamer slide show), konteksto (ConTeXt), tao (groff man), mediawiki
(MediaWiki markup), dokuwiki (DokuWiki markup), textile (Textile), org (Emacs Org
mode), texinfo (GNU Texinfo), opml (OPML), docbook (DocBook), opendocument
(OpenDocument), odt (OpenOffice text document), docx (Word docx), haddock (Haddock
markup), rtf (rich text format), epub (EPUB v2 book), epub3 (EPUB v3), fb2
(FictionBook2 e-book), asciidoc (AsciiDoc), icml (InDesign ICML), slidy (Slidy HTML
at javascript slide show), slideous (Slideous HTML at javascript slide show),
dzslides (DZSlides HTML5 + javascript slide show), revealjs (reveal.js HTML5 +
javascript slide show), s5 (S5 HTML at javascript slide show), o ang landas ng a
custom na lua writer (tingnan ang Custom na manunulat, sa ibaba). Tandaan na ang odt, epub, at epub3
hindi ididirekta ang output sa stdout; dapat tukuyin ang isang output filename gamit
ang -o/--output na opsyon. Kung ang +lhs ay idinagdag sa markdown, una, latex, beamer, html,
o html5, ang output ay ire-render bilang literate Haskell source: tingnan ang Literate
Haskell support, sa ibaba. Ang mga markdown syntax extension ay maaaring indibidwal na paganahin o
hindi pinagana sa pamamagitan ng pagdaragdag ng +EXTENSION o -EXTENSION sa pangalan ng format, gaya ng inilarawan
itaas sa ilalim -f.

-o FILE, --output=FILE
Isulat ang output sa FILE sa halip ng stdout. Kung FILE ay -, ang output ay mapupunta sa stdout.
(Exception: kung ang output format ay odt, docx, epub, o epub3, ang output sa stdout ay
may kapansanan.)

--data-dir=DIRECTORY
Tukuyin ang direktoryo ng data ng user upang maghanap ng mga pandoc data file. Kung ang pagpipiliang ito ay
hindi tinukoy, ang default na direktoryo ng data ng gumagamit ay gagamitin. Ito ay, sa Unix:

$HOME/.pandoc

sa Windows XP:

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

at sa Windows Vista o mas bago:

C:\Users\USERNAME\AppData\Roaming\pandoc

Maaari mong mahanap ang default na direktoryo ng data ng user sa iyong system sa pamamagitan ng pagtingin sa
output ng pandoc --version. Isang reference.odt, reference.docx, epub.css, mga template,
Ang slidy, slideous, o s5 na direktoryo na inilagay sa direktoryo na ito ay mag-o-override sa pandoc's
normal na mga default.

--bash-completion
Bumuo ng script ng pagkumpleto ng bash. Upang paganahin ang pagkumpleto ng bash sa pandoc, idagdag ito
sa iyong .bashrc:

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

--verbose
Magbigay ng verbose debugging output. Sa kasalukuyan, mayroon lamang itong epekto sa PDF output.

-sa, --bersyon
I-print na bersyon.

-h, - Tumulong
Ipakita ang mensahe ng paggamit.

mambabasa pagpipilian
-R, --parse-raw
I-parse ang mga hindi maisasalin na HTML code at LaTeX environment bilang raw HTML o LaTeX,
sa halip na balewalain sila. Nakakaapekto lamang sa input ng HTML at LaTeX. Ang Raw HTML ay maaaring
naka-print sa Markdown, reStructuredText, HTML, Slidy, Slideous, DZSlides, reveal.js,
at S5 output; maaaring i-print ang raw LaTeX sa Markdown, reStructuredText, LaTeX, at
Output ng ConTeXt. Ang default ay para sa mga mambabasa na alisin ang mga hindi maisasalin na HTML code
at mga kapaligiran ng LaTeX. (Ang LaTeX reader ay dumadaan sa hindi maisasalin na LaTeX
utos, kahit na -R ay hindi tinukoy.)

-S, --matalino
Gumawa ng typographically correct output, pag-convert ng mga straight quotes sa curly quotes,
--- sa em-dashes, -- sa en-dashes, at ... sa ellipses. Nonbreaking space ay
ipinasok pagkatapos ng ilang partikular na pagdadaglat, gaya ng "Mr." (Tandaan: Ang opsyong ito ay pinili
awtomatikong kapag ang output format ay latex o konteksto, maliban kung --no-tex-ligatures
Ginagamit. Ito ay walang epekto para sa latex input.)

--mga lumang gitling
Pinipili ang pandoc <= 1.8.2.1 na gawi para sa pag-parse ng mga matalinong gitling: - bago ang isang numeral
ay isang en-dash, at -- ay isang em-dash. Awtomatikong pinipili ang opsyong ito para sa
input ng tela.

--base-header-level=NUMBER
Tukuyin ang batayang antas para sa mga header (mga default sa 1).

--indented-code-classes=KLASE
Tukuyin ang mga klase na gagamitin para sa mga naka-indent na bloke ng code--halimbawa, perl,numberLines o
haskell. Maaaring paghiwalayin ang maraming klase ng mga puwang o kuwit.

--default-image-extension=EXTENSION
Tumukoy ng default na extension na gagamitin kapag walang extension ang mga path ng larawan/URL. Ito
nagbibigay-daan sa iyo na gumamit ng parehong pinagmulan para sa mga format na nangangailangan ng iba't ibang uri ng
mga larawan. Sa kasalukuyan, ang pagpipiliang ito ay nakakaapekto lamang sa Markdown at LaTeX na mga mambabasa.

--filter=MAAABOT
Tukuyin ang isang executable na gagamitin bilang isang filter na nagbabago ng pandoc AST pagkatapos ng
ang input ay na-parse at bago isulat ang output. Dapat basahin ng executable ang JSON
mula sa stdin at isulat ang JSON hanggang stdout. Ang JSON ay dapat na naka-format tulad ng sariling pandoc
JSON input at output. Ang pangalan ng format ng output ay ipapasa sa filter
bilang unang argumento. Kaya naman,

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

ay katumbas ng

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

Ang huling form ay maaaring maging kapaki-pakinabang para sa pag-debug ng mga filter.

Maaaring isulat ang mga filter sa anumang wika. Text.Pandoc.JSON exports toJSONFilter to
mapadali ang pagsusulat ng mga filter sa Haskell. Ang mga mas gustong magsulat ng mga filter
Maaaring gamitin ng python ang module pandocfilters, mai-install mula sa PyPI. Meron din
pandoc filter library sa PHP, perl, at javascript/node.js.

Tandaan na ang MAAABOT ay hahanapin sa PATH ng gumagamit, at hindi sa gumagana
direktoryo, kung walang ibinigay na direktoryo. Kung nais mong magpatakbo ng isang script sa pagtatrabaho
direktoryo, paunang salita ang filename na may ./.

-M KEY[=Val], --metadata=KEY[:Val]
Itakda ang field ng metadata KEY sa halaga Val. Isang value na tinukoy sa command line
overrides isang halaga na tinukoy sa dokumento. Ipapa-parse ang mga value bilang YAML boolean
o mga halaga ng string. Kung walang tinukoy na halaga, ituturing ang halaga bilang Boolean
totoo. Tulad ng --variable, ang --metadata ay nagiging sanhi ng mga variable ng template na itakda. Pero unlike
--variable, --metadata ay nakakaapekto sa metadata ng pinagbabatayan na dokumento (na
naa-access mula sa mga filter at maaaring i-print sa ilang mga format ng output).

--normalize
I-normalize ang dokumento pagkatapos basahin: pagsamahin ang mga katabing elemento ng Str o Emph, para sa
halimbawa, at alisin ang paulit-ulit na mga Space.

-p, --preserve-tabs
Panatilihin ang mga tab sa halip na i-convert ang mga ito sa mga puwang (ang default). Tandaan na ito
makakaapekto lamang sa mga tab sa literal na mga saklaw ng code at mga bloke ng code; mga tab sa regular na teksto
ay ituturing bilang mga puwang.

--tab-stop=NUMBER
Tukuyin ang bilang ng mga puwang sa bawat tab (ang default ay 4).

--track-changes=accept|reject|lahat
Tinutukoy kung ano ang gagawin sa mga pagpapasok at pagtanggal na ginawa ng MS Word na "Track
Mga Pagbabago" na tampok. tanggapin (ang default), ipinapasok ang lahat ng mga pagpapasok, at binabalewala ang lahat
mga pagtanggal. Ang pagtanggi ay naglalagay ng lahat ng mga pagtanggal at hindi pinapansin ang mga pagsingit. lahat ay naglalagay sa pareho
mga pagsingit at pagtanggal, na nakabalot sa mga span na may mga klase ng pagpapasok at pagtanggal,
ayon sa pagkakabanggit. Kasama ang may-akda at oras ng pagbabago. lahat ay kapaki-pakinabang para sa
scripting: pagtanggap lamang ng mga pagbabago mula sa isang partikular na tagasuri, sabihin, o bago ang isang tiyak
petsa. Ang pagpipiliang ito ay nakakaapekto lamang sa docx reader.

--extract-media=DIR
I-extract ang mga larawan at iba pang media na nasa isang docx o epub container patungo sa path
DIR, ginagawa ito kung kinakailangan, at ayusin ang mga larawang reference sa dokumento upang
itinuro nila ang mga na-extract na file. Ang pagpipiliang ito ay nakakaapekto lamang sa docx at epub
mga mambabasa.

Pangkalahatan manunulat pagpipilian
-oo, --nag-iisa
Gumawa ng output na may naaangkop na header at footer (hal. isang standalone na HTML,
LaTeX, o RTF file, hindi isang fragment). Ang pagpipiliang ito ay awtomatikong itinakda para sa pdf,
epub, epub3, fb2, docx, at odt na output.

--template=FILE
paggamit FILE bilang custom na template para sa nabuong dokumento. Nagpapahiwatig --nakapag-iisa.
Tingnan ang Mga Template, sa ibaba, para sa isang paglalarawan ng syntax ng template. Kung walang extension ay
tinukoy, isang extension na naaayon sa manunulat ay idadagdag, upang
--template=special look for special.html para sa HTML na output. Kung ang template ay hindi
natagpuan, hahanapin ito ng pandoc sa subdirectory ng mga template ng data ng user
direktoryo (tingnan ang --data-dir). Kung hindi ginagamit ang opsyong ito, isang default na template
angkop para sa format ng output ang gagamitin (tingnan ang -D/--print-default-template).

-V KEY[=Val], --variable=KEY[:Val]
Itakda ang variable ng template KEY sa halaga Val kapag ni-render ang dokumento sa
standalone mode. Ito ay karaniwang kapaki-pakinabang lamang kapag ang --template na opsyon ay ginamit
upang tumukoy ng custom na template, dahil awtomatikong itinatakda ng pandoc ang mga variable na ginamit sa
ang mga default na template. Kung hindi Val ay tinukoy, ang susi ay bibigyan ng halaga
totoo.

-D FORMAT, --print-default-template=FORMAT
I-print ang default na template ng system para sa isang output FORMAT. (Tingnan -t para sa isang listahan ng
maaari FORMATs.) Binabalewala ang mga template sa direktoryo ng data ng user.

--print-default-data-file=FILE
Mag-print ng file ng data ng default ng system. Binabalewala ang mga file sa direktoryo ng data ng user.

--dpi=NUMBER
Tukuyin ang halaga ng dpi (mga tuldok sa bawat pulgada) para sa conversion mula sa mga pixel hanggang
pulgada/sentimetro at vice versa. Ang default ay 96dpi. Sa teknikal, ang tama
Ang termino ay magiging ppi (mga pixel bawat pulgada).

--wrap=[auto|none|preserve]
Tukuyin kung paano nakabalot ang text sa output (ang source code, hindi ang na-render
bersyon). Gamit ang auto (ang default), susubukan ni pandoc na balutin ang mga linya sa column
lapad na tinukoy ng --columns (default 80). Kung wala, hindi magbalot ng mga linya ang pandoc
sa lahat. Sa preserve, susubukan ni pandoc na i-preserve ang wrapping mula sa
pinagmumulan ng dokumento (iyon ay, kung saan may mga nonsemantic na bagong linya sa pinagmulan, doon
magiging nonsemantic newlines din sa output).

--no-wrap
Hindi na ginagamit ang kasingkahulugan ng --wrap=none.

--columns=NUMBER
Tukuyin ang haba ng mga linya sa mga character (para sa text wrapping). Ito ay nakakaapekto lamang sa
nabuong source code, hindi ang layout sa na-render na page.

--toc, --talaan ng nilalaman
Isama ang isang awtomatikong nabuong talaan ng mga nilalaman (o, sa kaso ng latex,
konteksto, at una, isang tagubilin upang lumikha ng isa) sa dokumento ng output. Ito
walang epekto ang opsyon sa man, docbook, slidy, slideous, s5, docx, o odt na output.

--toc-depth=NUMBER
Tukuyin ang bilang ng mga antas ng seksyon na isasama sa talaan ng mga nilalaman. Ang
default ay 3 (na nangangahulugan na ang antas 1, 2, at 3 na mga header ay ililista sa
nilalaman).

--walang-highlight
Hindi pinapagana ang pag-highlight ng syntax para sa mga block at inline ng code, kahit na isang wika
ibinigay ang katangian.

--highlight-style=Estilo
Tinutukoy ang istilo ng pangkulay na gagamitin sa naka-highlight na source code. Ang mga pagpipilian ay
pygments (ang default), kate, monochrome, espresso, zenburn, haddock, at tango.
Para sa higit pang impormasyon sa pag-highlight ng syntax sa pandoc, tingnan ang pag-highlight ng Syntax,
sa ibaba.

-H FILE, --include-in-header=FILE
Isama ang mga nilalaman ng FILE, verbatim, sa dulo ng header. Ito ay maaaring gamitin,
halimbawa, upang isama ang espesyal na CSS o javascript sa mga HTML na dokumento. Ang pagpipiliang ito
maaaring gamitin nang paulit-ulit upang magsama ng maraming file sa header. Magiging sila
kasama sa tinukoy na order. Nagpapahiwatig --nakapag-iisa.

-B FILE, --include-before-body=FILE
Isama ang mga nilalaman ng FILE, verbatim, sa simula ng katawan ng dokumento (hal
pagkatapos ng tag sa HTML, o ang \begin{document} command sa LaTeX). Maaari itong
gamitin upang isama ang mga navigation bar o banner sa mga HTML na dokumento. Ang pagpipiliang ito ay maaaring
gamitin nang paulit-ulit upang magsama ng maramihang mga file. Isasama sila sa order
tinukoy. Nagpapahiwatig --nakapag-iisa.

-A FILE, --include-after-body=FILE
Isama ang mga nilalaman ng FILE, verbatim, sa dulo ng katawan ng dokumento (bago ang
tag sa HTML, o ang command na \end{document} sa LaTeX). Ang pagpipiliang ito ay maaaring
gamitin nang paulit-ulit upang magsama ng maramihang mga file. Isasama sila sa order
tinukoy. Nagpapahiwatig --nakapag-iisa.

Options nakakaapekto tiyak manunulat
--self-contained
Gumawa ng standalone na HTML file na walang mga external na dependency, gamit ang data: URIs to
isama ang mga nilalaman ng mga naka-link na script, stylesheet, larawan, at video. Ang
Ang resultang file ay dapat na "self-contained," sa kahulugan na hindi ito nangangailangan ng panlabas
file at walang net access na maipapakita nang maayos ng isang browser. Gumagana ang pagpipiliang ito
lamang sa mga format ng output ng HTML, kabilang ang html, html5, html+lhs, html5+lhs, s5,
slidy, slideous, dzslides, at revealjs. Mga script, larawan, at stylesheet sa
ang mga ganap na URL ay mada-download; ang mga nasa mga kaugnay na URL ay hahanapin na may kaugnayan sa
ang gumaganang direktoryo (kung ang unang source file ay lokal) o may kaugnayan sa base
URL (kung malayo ang unang source file). Limitasyon: mga mapagkukunan na na-load
dynamically sa pamamagitan ng JavaScript ay hindi maaaring isama; ang resulta,
--self-contained ay hindi gumagana sa --mathjax, at ilang advanced na feature (hal
zoom o speaker notes) ay maaaring hindi gumana sa isang offline na "self-contained" reveal.js slide
ipakita.

--html-q-tags
Gumamit ng mga tag para sa mga quote sa HTML.

--ascii
Gumamit lamang ng mga ascii character sa output. Kasalukuyang sinusuportahan lamang para sa HTML na output
(na gumagamit ng mga numerical entity sa halip na UTF-8 kapag napili ang opsyong ito).

--reference-links
Gumamit ng mga link sa istilo ng sanggunian, sa halip na mga inline na link, sa pagsulat ng Markdown o
reStructuredText. Bilang default, ginagamit ang mga inline na link.

--atx-headers
Gumamit ng ATX-style na mga header sa Markdown at asciidoc output. Ang default ay ang gamitin
setext-style na mga header para sa mga antas 1-2, at pagkatapos ay mga header ng ATX.

--mga kabanata
Ituring ang mga nangungunang antas ng header bilang mga kabanata sa LaTeX, ConTeXt, at DocBook na output. Kailan
ang klase ng dokumento ng LaTeX ay nakatakdang mag-ulat, mag-book, o memoir, ang opsyong ito ay ipinahiwatig.
Kung beamer ang format ng output, ang mga top-level na header ay magiging \part{..}.

-N, --number-seksyon
Mga heading ng seksyon ng numero sa output ng LaTeX, ConTeXt, HTML, o EPUB. Bilang default,
ang mga seksyon ay hindi binibilang. Ang mga seksyon na may klase na walang numero ay hindi kailanman mabibilang,
kahit na tinukoy ang --number-sections.

--number-offset=NUMBER[,NUMBER,...]
Offset para sa mga heading ng seksyon sa HTML na output (hindi pinansin sa ibang mga format ng output). Ang
ang unang numero ay idinaragdag sa numero ng seksyon para sa mga nangungunang antas ng header, ang pangalawa para sa
pangalawang antas na mga header, at iba pa. Kaya, halimbawa, kung gusto mo ang unang pinakamataas na antas
header sa iyong dokumento na may bilang na "6", tukuyin --number-offset=5. Kung ang iyong
Ang dokumento ay nagsisimula sa isang level-2 na header na gusto mong mabilang na "1.5", tukuyin
--number-offset=1,4. Ang mga offset ay 0 bilang default. Nagpapahiwatig --number-sections.

--walang-tex-ligatures
Huwag gamitin ang TeX ligatures para sa mga panipi, apostrophe, at gitling (`...',
``..'', --, ---) kapag nagsusulat o nagbabasa ng LaTeX o ConTeXt. Sa pagbabasa ng LaTeX, i-parse
ang mga character na `, ', at - literal, sa halip na mag-parse ng mga ligature para sa quotation
mga marka at gitling. Sa pagsulat ng LaTeX o ConTeXt, mag-print ng unicode quotation mark at
literal na mga dash character, sa halip na i-convert ang mga ito sa karaniwang ASCII TeX
ligatures. Tandaan: karaniwang --smart ay awtomatikong pinipili para sa LaTeX at ConTeXt
output, ngunit dapat itong tahasang tukuyin kung napili ang --no-tex-ligatures. Kung
gumamit ka ng mga literal na kulot na panipi, gitling, at ellipse sa iyong pinagmulan, pagkatapos ay maaari mo
gustong gumamit ng --no-tex-ligatures nang walang --smart.

--mga listahan
Gamitin ang listing package para sa LaTeX code blocks

-ako, --incremental
Gawing unti-unting ipinapakita ang mga listahan ng mga item sa mga slide show (isa-isa). Ang default ay
para sa mga listahan na maipakita nang sabay-sabay.

--slide-level=NUMBER
Tinutukoy na ang mga header na may tinukoy na antas ay gumagawa ng mga slide (para sa beamer, s5,
madulas, madulas, dzslide). Nakasanayan na ang mga header sa itaas ng antas na ito sa hierarchy
hatiin ang slide show sa mga seksyon; Ang mga header sa ibaba ng antas na ito ay gumagawa ng mga subhead
sa loob ng isang slide. Ang default ay upang itakda ang antas ng slide batay sa mga nilalaman ng
dokumento; tingnan ang Pag-istruktura ng slide show.

--section-divs
I-wrap ang mga seksyon mga tag (o tag sa HTML5), at mag-attach ng mga identifier sa
ang nakapaloob (o ) kaysa sa mismong header. Tingnan ang Header
mga identifier, sa ibaba.

--email-obfuscation=none|javascript|mga sanggunian
Tumukoy ng paraan para sa pag-obfuscating ng mailto: mga link sa mga HTML na dokumento. walang umalis
mailto: mga link tulad ng mga ito. javascript obfuscates ang mga ito gamit ang javascript.
pinalalabo sila ng mga sanggunian sa pamamagitan ng pag-print ng kanilang mga titik bilang decimal o hexadecimal
mga sanggunian ng karakter. Ang default ay javascript.

--id-prefix=STRING
Tumukoy ng prefix na idaragdag sa lahat ng awtomatikong nabuong identifier sa HTML at
Output ng DocBook, at sa mga numero ng footnote sa Markdown na output. Ito ay kapaki-pakinabang para sa
pinipigilan ang mga duplicate na identifier kapag bumubuo ng mga fragment na isasama sa iba pa
pahina.

-T STRING, --title-prefix=STRING
Tukuyin STRING bilang prefix sa simula ng pamagat na lumalabas sa HTML
header (ngunit hindi sa pamagat na lumalabas sa simula ng HTML body).
Nagpapahiwatig --nakapag-iisa.

-c URL, --css=URL
Mag-link sa isang CSS style sheet. Ang pagpipiliang ito ay maaaring gamitin nang paulit-ulit upang isama
maramihang mga file. Isasama sila sa tinukoy na order.

--reference-odt=FILE
Gamitin ang tinukoy na file bilang isang sanggunian ng istilo sa paggawa ng isang ODT. Para sa pinakamahusay na mga resulta,
ang reference na ODT ay dapat na isang binagong bersyon ng isang ODT na ginawa gamit ang pandoc.
Ang mga nilalaman ng reference na ODT ay binabalewala, ngunit ang mga stylesheet nito ay ginagamit sa
bagong ODT. Kung walang tinukoy na reference na ODT sa command line, titingnan ang pandoc
para sa isang file reference.odt sa direktoryo ng data ng user (tingnan ang --data-dir). Kung ito ay
hindi rin nakita, gagamit ng mga matinong default.

--reference-docx=FILE
Gamitin ang tinukoy na file bilang sanggunian ng istilo sa paggawa ng docx file. Para sa pinakamahusay
mga resulta, ang reference na docx ay dapat na isang binagong bersyon ng isang docx file na ginawa
gamit ang pandoc. Ang mga nilalaman ng reference na docx ay binabalewala, ngunit ang mga stylesheet nito
at mga katangian ng dokumento (kabilang ang mga margin, laki ng pahina, header, at footer) ay ginagamit
sa bagong docx. Kung walang reference docx na tinukoy sa command line, pandoc
ay maghahanap ng file reference.docx sa user data directory (tingnan ang --data-dir).
Kung hindi rin ito matagpuan, gagamitin ang mga matinong default. Ang mga sumusunod na istilo
ay ginagamit ng pandoc: [paragraph] Normal, Body Text, First Paragraph, Compact, Title,
Subtitle, Author, Petsa, Abstract, Bibliography, Heading 1, Heading 2, Heading 3,
Heading 4, Heading 5, Heading 6, Block Text, Footnote Text, Definition Term,
Kahulugan, Caption, Table Caption, Image Caption, Figure, Figure na May Caption, TOC
Pamagat; [character] Default na Font ng Paragraph, Body Text Char, Verbatim Char,
Sanggunian sa Footnote, Hyperlink; [talahanayan] Karaniwang Talahanayan.

--epub-stylesheet=FILE
Gamitin ang tinukoy na CSS file upang i-istilo ang EPUB. Kung walang tinukoy na stylesheet,
Ang pandoc ay maghahanap ng isang file na epub.css sa direktoryo ng data ng gumagamit (tingnan ang --data-dir).
Kung hindi ito matatagpuan doon, gagamitin ang mga matinong default.

--epub-cover-image=FILE
Gamitin ang tinukoy na larawan bilang pabalat ng EPUB. Inirerekomenda na ang imahe ay
mas mababa sa 1000px ang lapad at taas. Tandaan na sa isang Markdown source na dokumento ikaw
maaari ding tumukoy ng cover-image sa isang YAML metadata block (tingnan ang EPUB Metadata, sa ibaba).

--epub-metadata=FILE
Hanapin sa tinukoy na XML file para sa metadata para sa EPUB. Ang file ay dapat maglaman
isang serye ng mga elemento ng Dublin Core. Halimbawa:

Creative Commons
es-AR

Bilang default, isasama ng pandoc ang mga sumusunod na elemento ng metadata: (mula sa
pamagat ng dokumento), (mula sa mga may-akda ng dokumento), (galing sa
petsa ng dokumento, na dapat nasa format na ISO 8601), (mula sa lang
variable, o, kung hindi nakatakda, ang locale), at (a
random na nabuong UUID). Anuman sa mga ito ay maaaring ma-override ng mga elemento sa
metadata file.

Tandaan: kung Markdown ang pinagmumulan ng dokumento, maaari ang isang YAML metadata block sa dokumento
gamitin sa halip. Tingnan sa ibaba sa ilalim ng Metadata ng EPUB.

--epub-embed-font=FILE
I-embed ang tinukoy na font sa EPUB. Ang pagpipiliang ito ay maaaring ulitin upang i-embed
maramihang mga font. Maaari ding gamitin ang mga wildcard: halimbawa, DejaVuSans-*.ttf.
Gayunpaman, kung gumagamit ka ng mga wildcard sa command line, tiyaking takasan ang mga ito o ilagay
ang buong filename sa iisang quote, upang maiwasan ang mga ito na bigyang-kahulugan ng
kabibi. Upang magamit ang mga naka-embed na font, kakailanganin mong magdagdag ng mga deklarasyon tulad ng
sumusunod sa iyong CSS (tingnan ang --epub-stylesheet):

@ font-face {
font-family: DejaVuSans;
style ng font: normal;
bigat ng font: normal;
src:url("DejaVuSans-Regular.ttf");
}
@ font-face {
font-family: DejaVuSans;
style ng font: normal;
font-weight: bold;
src:url("DejaVuSans-Bold.ttf");
}
@ font-face {
font-family: DejaVuSans;
font-style: italic;
bigat ng font: normal;
src:url("DejaVuSans-Oblique.ttf");
}
@ font-face {
font-family: DejaVuSans;
font-style: italic;
font-weight: bold;
src:url("DejaVuSans-BoldOblique.ttf");
}
body { font-family: "DejaVuSans"; }

--epub-chapter-level=NUMBER
Tukuyin ang antas ng header kung saan hahatiin ang EPUB sa magkahiwalay na "kabanata" na mga file.
Ang default ay hatiin sa mga kabanata sa antas 1 na mga header. Ang pagpipiliang ito ay nakakaapekto lamang
ang panloob na komposisyon ng EPUB, hindi ang paraan ng mga kabanata at seksyon
ipinapakita sa mga gumagamit. Maaaring mabagal ang ilang mambabasa kung masyadong malaki ang mga file ng kabanata,
kaya para sa malalaking dokumento na may kaunting level 1 na mga header, maaaring gusto ng isa na gumamit ng isang kabanata
antas ng 2 o 3.

--latex-engine=pdflatex|lualatex|xelatex
Gamitin ang tinukoy na LaTeX engine kapag gumagawa ng PDF output. Ang default ay pdflatex.
Kung wala ang makina sa iyong PATH, maaaring tukuyin ang buong landas ng makina
dito.

--latex-engine-opt=STRING
Gamitin ang ibinigay na string bilang isang command-line argument sa latex-engine. Kung ginamit
maraming beses, ang mga argumento ay binibigyan ng mga puwang sa pagitan nila. Tandaan na hindi
suriin para sa mga duplicate na opsyon ay tapos na.

Banggit pagsasalin
--bibliograpiya=FILE
Itakda ang field ng bibliography sa metadata ng dokumento sa FILE, override sa anumang halaga
itinakda sa metadata, at iproseso ang mga pagsipi gamit ang pandoc-citeproc. (Ito ay
katumbas ng --metadata bibliography=FILE --filter pandoc-citeproc.) Kung --natbib
o --biblatex ay ibinibigay din, hindi ginagamit ang pandoc-citeproc, ginagawa itong katumbas
sa --metadata bibliography=FILE. Kung ibibigay mo ang argumentong ito nang maraming beses, bawat isa
FILE idadagdag sa bibliograpiya.

--csl=FILE
Itakda ang csl field sa metadata ng dokumento sa FILE, override sa anumang value na nakatakda
ang metadata. (Ito ay katumbas ng --metadata csl=FILE.) Ang pagpipiliang ito ay lamang
may kaugnayan sa pandoc-citeproc.

--citation-abbreviations=FILE
Itakda ang field ng mga pagsipi-mga pagdadaglat sa metadata ng dokumento sa FILE, override
anumang halaga na itinakda sa metadata. (Ito ay katumbas ng
--metadata citation-abbreviations=FILE.) Ang pagpipiliang ito ay may kaugnayan lamang sa
pandoc-citeproc.

--natbib
Gumamit ng natbib para sa mga pagsipi sa LaTeX na output. Ang pagpipiliang ito ay hindi para gamitin sa
pandoc-citeproc filter o may PDF na output. Ito ay inilaan para gamitin sa paggawa ng a
LaTeX file na maaaring iproseso gamit ang bibtex.

--biblatex
Gumamit ng biblatex para sa mga pagsipi sa LaTeX na output. Ang pagpipiliang ito ay hindi para gamitin sa
pandoc-citeproc filter o may PDF na output. Ito ay inilaan para gamitin sa paggawa ng a
LaTeX file na maaaring iproseso gamit ang bibtex o biber.

Math pagsasalin in HTML
-m [URL], --latexmathml[=URL]
Gamitin ang LaTeXMathML upang ipakita ang naka-embed na TeX math sa HTML na output. Ang URL dapat ituro
sa LaTeXMathML.js load script. Kung ang URL ay hindi ibinigay, isang link sa
Ang LaTeXMathML.js sa Homepage ng LaTeXMathML ay ipapasok.

--mathm[=URL]
I-convert ang TeX math sa MathML (sa docbook pati na rin sa html at html5). Sa standalone
html output, isang maliit na javascript (o isang link sa naturang script kung a URL ay ibinibigay)
ay ilalagay na nagpapahintulot sa MathML na matingnan sa ilang mga browser.

--jsmath[=URL]
Gamitin ang jsMath para ipakita ang naka-embed na TeX math sa HTML na output. Ang URL dapat ituro sa
ang jsMath load script (eg jsMath/easy/load.js); kung ibinigay, ito ay mai-link
sa header ng mga standalone na HTML na dokumento. Kung ang URL ay hindi ibinigay, walang link
sa jsMath load script ay ipapasok; ito ay pagkatapos ay hanggang sa may-akda upang magbigay
tulad ng isang link sa template ng HTML.

--mathjax[=URL]
Gamitin ang MathJax para ipakita ang naka-embed na TeX math sa HTML na output. Ang URL dapat ituro sa
ang MathJax.js load script. Kung ang URL ay hindi ibinigay, isang link sa MathJax CDN
ipapasok.

--gladtex
Ilakip ang TeX math mga tag sa HTML na output. Ang mga ito ay maaaring iproseso ng
gladTeX upang makagawa ng mga link sa mga larawan ng mga formula ng typeset.

--mimetex[=URL]
I-render ang TeX math gamit ang mimeTeX CGI script. Kung URL ay hindi tinukoy, ito ay
ipinapalagay na ang script ay nasa /cgi-bin/mimetex.cgi.

--webtex[=URL]
I-render ang mga formula ng TeX gamit ang isang panlabas na script na nagko-convert ng mga formula ng TeX sa mga imahe.
Ang formula ay isasama sa ibinigay na URL. Kung URL ay hindi tinukoy,
gagamitin ang Google Chart API.

--katex[=URL]
Gamitin ang KaTeX para ipakita ang naka-embed na TeX math sa HTML na output. Ang URL dapat ituro ang
katex.js load script. Kung ang URL ay hindi ibinigay, magkakaroon ng isang link sa KaTeX CDN
ipinasok

--katex-stylesheet=URL
Ang URL dapat tumuro sa katex.css stylesheet. Kung hindi tinukoy ang opsyong ito,
maglalagay ng link sa KaTeX CDN. Tandaan na ang pagpipiliang ito ay hindi nagpapahiwatig
--katex.

Options para wrapper script
--dump-args
Mag-print ng impormasyon tungkol sa mga argumento ng command-line sa stdout, pagkatapos ay lumabas. Ang pagpipiliang ito
ay pangunahing inilaan para sa paggamit sa mga script ng wrapper. Ang unang linya ng output
naglalaman ng pangalan ng output file na tinukoy sa opsyong -o, o - (para sa
stdout) kung walang output file na tinukoy. Ang natitirang mga linya ay naglalaman ng
mga argumento ng command-line, isa bawat linya, sa pagkakasunud-sunod ng paglitaw ng mga ito. Ang mga ito ay hindi
isama ang mga regular na opsyon sa pandoc at ang kanilang mga argumento, ngunit isama ang anumang mga opsyon
lumilitaw pagkatapos ng isang -- separator sa dulo ng linya.

--ignore-args
Huwag pansinin ang mga argumento ng command-line (para magamit sa mga script ng wrapper). Mga regular na pagpipilian sa pandoc
ay hindi pinapansin. Kaya, halimbawa,

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

ay katumbas ng

pandoc -o foo.html -s

TEMPLATES

Kapag ginamit ang -s/--standalone na opsyon, gumagamit ang pandoc ng template upang magdagdag ng header at footer
materyal na kailangan para sa isang self-standing na dokumento. Upang makita ang default na template na
ginamit, type lang

pandoc -D *FORMAT*

saan FORMAT ay ang pangalan ng format ng output. Maaaring tukuyin ang isang custom na template gamit ang
ang --template na opsyon. Maaari mo ring i-override ang mga default na template ng system para sa isang naibigay
format ng output FORMAT sa pamamagitan ng paglalagay ng file templates/default.*FORMAT* sa data ng user
direktoryo (tingnan ang --data-dir, sa itaas). Mga Pagbubukod: Para sa odt output, i-customize ang
default.opendocument template. Para sa pdf na output, i-customize ang default.latex na template.

Naglalaman ang mga template mga variable, na nagpapahintulot sa pagsasama ng di-makatwirang impormasyon sa alinman
ituro ang file. Maaaring itakda ang mga variable sa loob ng dokumento gamit ang YAML metadata blocks.
Maaari ding itakda ang mga ito sa command line gamit ang -V/--variable na opsyon: mga variable na nakatakda
sa ganitong paraan, i-override ang mga field ng metadata na may parehong pangalan.

Variable itakda by pandoc
Ang ilang mga variable ay awtomatikong itinakda ng pandoc. Ang mga ito ay medyo nag-iiba depende sa
format ng output, ngunit isama ang mga patlang ng metadata pati na rin ang sumusunod:

pamagat, may-akda, petsa
payagan ang pagkakakilanlan ng mga pangunahing aspeto ng dokumento. Kasama sa PDF metadata
sa pamamagitan ng LaTeX at ConTeXt. Ang mga ito ay maaaring itakda sa pamamagitan ng pandoc title block, na
nagbibigay-daan para sa maraming may-akda, o sa pamamagitan ng YAML metadata block:

---
may-akda:
- Aristotle
- Peter Abelard
...

pangalawang pamagat
subtitle ng dokumento, kasama sa HTML, EPUB, LaTeX, ConTeXt, at Word docx; nag-render
sa LaTeX lamang kapag gumagamit ng klase ng dokumento na sumusuporta sa \subtitle, gaya ng beamer
o ang serye ng KOMA-Script (scrartcl, scrreprt, scrbook).

abstract
buod ng dokumento, kasama sa LaTeX, ConTeXt, AsciiDoc, at Word docx

mga keyword
listahan ng mga keyword na isasama sa HTML, PDF, at AsciiDoc metadata; maaaring
paulit-ulit tulad ng para sa may-akda, sa itaas

header-kabilang
mga nilalaman na tinukoy ng -H/--include-in-header (maaaring magkaroon ng maraming halaga)

toc non-null value kung --toc/--table-of-contents ang tinukoy

toc-title
pamagat ng talaan ng mga nilalaman (gumagana lamang sa EPUB at docx)

isama-bago
mga nilalaman na tinukoy ng -B/--include-before-body (maaaring magkaroon ng maraming halaga)

isama-pagkatapos
mga nilalaman na tinukoy ng -A/--include-after-body (maaaring magkaroon ng maraming halaga)

katawan katawan ng dokumento

meta-json
JSON na representasyon ng lahat ng metadata ng dokumento

Wika mga variable
lang kinikilala ang pangunahing wika ng dokumento, gamit ang isang code ayon sa BCP 47
(hal. en o en-GB). Para sa ilang mga format ng output, iko-convert ito ng pandoc sa isang
naaangkop na format na nakaimbak sa mga karagdagang variable na babel-lang, polyglossia-lang
(LaTeX) at context-lang (ConTeXt).

Maaaring gamitin ang mga native na pandoc span at div na may attribute na lang (value sa BCP 47).
upang ilipat ang wika sa hanay na iyon.

ibanglang
isang listahan ng iba pang mga wika na ginamit sa dokumento sa YAML metadata, ayon sa
BCP 47. Halimbawa: otherlangs: [en-GB, fr]. Ito ay awtomatikong nabuo
mula sa lang attributes sa lahat ng span at divs ngunit maaaring ma-override. Kasalukuyan
ginagamit lamang ng LaTeX sa pamamagitan ng nabuong babel-otherlangs at
polyglossia-otherlangs variable. Ang manunulat ng LaTeX ay naglalabas ng mga utos ng polyglossia
ang teksto ngunit ang babel-newcommands variable ay naglalaman ng mga pagmamapa para sa kanila sa
kaukulang babel.

dir ang base na direksyon ng dokumento, alinman sa rtl (kanan-pakaliwa) o ltr
(kaliwa-pakanan).

Para sa mga bidirectional na dokumento, ang katutubong pandoc ay sumasaklaw at mga div na may dir attribute
(value rtl o ltr) ay maaaring gamitin upang i-override ang base na direksyon sa ilang output
mga format. Maaaring hindi ito palaging kinakailangan kung ang panghuling tagapag-render (hal
browser, kapag bumubuo ng HTML) ay sumusuporta sa Unicode Bidirectional Algorithm.

Kapag gumagamit ng LaTeX para sa mga bidirectional na dokumento, ang xelatex engine lang ang ganap
suportado (gamitin ang --latex-engine=xelatex).

Variable para slide
Available ang mga variable para sa paggawa ng mga slide show na may pandoc, kasama ang lahat ng reveal.js
mga pagpipilian sa pagsasaayos.

madulas na url
base URL para sa mga Slidy na dokumento (default sa http://www.w3.org/Talks/Tools/Slidy2)

slideous-url
base URL para sa Slideous na mga dokumento (default sa slideous)

s5-url base URL para sa mga dokumento ng S5 (mga default sa s5/default)

revealjs-url
base URL para sa mga dokumento ng reveal.js (mga default sa reveal.js)

tema, colortheme, fonttheme, panloob na tema, panlabas na tema
mga tema para sa mga dokumento ng LaTeX beamer

nabigasyon
kinokontrol ang mga simbolo ng nabigasyon sa mga dokumento ng beamer (walang laman ang default para sa walang nabigasyon
mga simbolo; ang iba pang wastong halaga ay frame, patayo, at pahalang).

mga pamagat ng seksyon
pinapagana sa "mga pahina ng pamagat" para sa mga bagong seksyon sa mga dokumento ng beamer (default = true).

Variable para LaTeX
Ginagamit ang mga variable ng LaTeX kapag gumagawa ng PDF.

laki ng papel
laki ng papel, hal. letra, A4

laki ng font
laki ng font para sa body text (hal. 10pt, 12pt)

klase ng dokumento
klase ng dokumento, hal. artikulo, ulat, aklat, memoir

classoption
opsyon para sa klase ng dokumento, hal oneside; maaaring ulitin para sa maraming mga pagpipilian

heometrya
opsyon para sa geometry package, hal. margin=1in; maaaring ulitin para sa maraming mga pagpipilian

margin-kaliwa, margin-right, margin-top, margin-ibaba
nagtatakda ng mga margin, kung hindi ginagamit ang geometry (kung hindi man ay na-override ito ng geometry)

linestretch
inaayos ang line spacing gamit ang setspace package, hal 1.25, 1.5

fontfamily
font package para gamitin sa pdflatex: Ang TeX Live ay may kasamang maraming opsyon, na nakadokumento sa
ang LaTeX Font Catalogue. Ang default ay Latin Modern.

fontfamilyoptions
mga opsyon para sa package na ginamit bilang fontfamily: hal osf,sc na may fontfamily na nakatakda sa
Ang mathpazo ay nagbibigay kay Palatino ng mga lumang-style na figure at totoong maliliit na cap; maaaring
paulit-ulit para sa maraming mga pagpipilian

pangunahing impormasyon, sansfont, monofont, mathfont, CJKmainfont
mga pamilya ng font para gamitin sa xelatex o lualatex: kunin ang pangalan ng anumang font ng system,
gamit ang fontspec package. Tandaan na kung CJKmainfont ang ginagamit, ang xecjk package
dapat available.

mainfontoptions, sansfontoptions, monofontoptions, mathfontoptions, CJKoptions
mga opsyon na gagamitin sa mainfont, sansfont, monofont, mathfont, CJKmainfont sa xelatex
at lualatex. Payagan ang anumang mga pagpipilian na magagamit sa pamamagitan ng fontspec, tulad ng
Mga tampok ng OpenType Numbers=OldStyle,Numbers=Proportional. Maaaring ulitin para sa
maramihang mga pagpipilian.

fontenc
nagbibigay-daan sa pag-encode ng font na matukoy sa pamamagitan ng fontenc package (na may pdflatex);
default ay T1 (tingnan ang gabay sa LaTeX font encodings)

mga colorlink
magdagdag ng kulay sa link ng teksto; awtomatikong pinagana kung alinman sa linkcolor, citecolor,
nakatakda ang urlcolor, o toccolor

linkcolor, citecolor, urlcolor, toccolor
kulay para sa mga panloob na link, mga link sa pagsipi, mga panlabas na link, at mga link sa talahanayan ng
mga nilalaman: gumagamit ng alinman sa mga paunang natukoy na kulay ng LaTeX

links-as-notes
nagiging sanhi ng pag-print ng mga link bilang mga footnote

indent gumagamit ng mga setting ng klase ng dokumento para sa indentation (ang default na template ng LaTeX kung hindi man
nag-aalis ng indentation at nagdaragdag ng espasyo sa pagitan ng mga talata)

subparagraph
hindi pinapagana ang default na gawi ng template ng LaTeX na muling tumutukoy sa (sub) mga talata bilang
mga seksyon, binabago ang hitsura ng mga nested na heading sa ilang mga klase

salamat Tinutukoy ang mga nilalaman ng footnote ng mga pagkilala pagkatapos ng pamagat ng dokumento.

toc isama ang talaan ng mga nilalaman (maaari ding itakda gamit ang --toc/--table-of-contents)

toc-depth
antas ng seksyon na isasama sa talaan ng mga nilalaman

lof, marami
isama ang listahan ng mga numero, listahan ng mga talahanayan

biblyograpya
bibliograpiya na gagamitin para sa paglutas ng mga sanggunian

istilong biblio
istilo ng bibliograpiya, kapag ginamit sa --natbib at --biblatex.

biblatexoptions
listahan ng mga opsyon para sa biblatex.

Variable para ConTeXt
laki ng papel
laki ng papel, hal. letra, A4, landscape (tingnan ang ConTeXt Paper Setup); maaaring maulit
para sa maramihang mga pagpipilian

kaayusan mga opsyon para sa mga margin ng pahina at pag-aayos ng teksto (tingnan ang ConTeXt Layout); maaaring maulit
para sa maramihang mga pagpipilian

margin-kaliwa, margin-right, margin-top, margin-ibaba
nagtatakda ng mga margin, kung ang layout ay hindi ginagamit (kung hindi, ang layout ay na-override ang mga ito)

laki ng font
laki ng font para sa body text (hal. 10pt, 12pt)

pangunahing impormasyon, sansfont, monofont, mathfont
mga pamilya ng font: kunin ang pangalan ng anumang font ng system (tingnan ang ConTeXt Font Switching)

linkcolor, contrastcolor
kulay para sa mga link sa labas at loob ng isang pahina, hal. pula, asul (tingnan ang ConTeXt Color)

linkstyle
estilo ng typeface para sa mga link, hal. normal, bold, slanted, boldslanted, type, cap,
maliit

pag-indent
kinokontrol ang indentation ng mga talata, hal. oo, maliit, susunod (tingnan ang ConTeXt Indentation);
maaaring ulitin para sa maraming mga pagpipilian

whitespace
spacing sa pagitan ng mga talata, hal. wala, maliit (gamit ang setupwhitespace)

interlinespace
inaayos ang line spacing, hal 4ex (gamit ang setupinterlinespace); maaaring ulitin para sa
maramihang mga pagpipilian

header text, footertext
tekstong ilalagay sa tumatakbong header o footer (tingnan ang ConTeXt Header at Footer);
maaaring ulitin hanggang apat na beses para sa iba't ibang pagkakalagay

pagenumbering
estilo at lokasyon ng numero ng pahina (gamit ang setuppagenumbering); maaaring ulitin para sa
maramihang mga pagpipilian

toc isama ang talaan ng mga nilalaman (maaari ding itakda gamit ang --toc/--table-of-contents)

lof, marami
isama ang listahan ng mga numero, listahan ng mga talahanayan

Variable para lalaki mga pahina
seksyon
numero ng seksyon sa mga pahina ng tao

header header sa mga man page

pampaa footer sa mga man page

pagsasaayos
inaayos ang teksto sa kaliwa (l), kanan (r), gitna (c), o pareho (b) na mga margin

gitling
kung totoo (ang default), gagamitin ang hyphenation

paggamit mga variable in template
Ang mga variable na pangalan ay mga pagkakasunud-sunod ng mga alphanumeric, -, at _, na nagsisimula sa isang titik. A
Ang variable na pangalan na napapalibutan ng $ sign ay papalitan ng halaga nito. Halimbawa, ang
string $title$ in

$title$

ay papalitan ng pamagat ng dokumento.

Upang magsulat ng literal na $ sa isang template, gumamit ng $$.

Maaaring naglalaman ang mga template ng mga kondisyon. Ang syntax ay ang mga sumusunod:

$if(variable)$
X
$ibang$
Y
$endif$

Isasama nito ang X sa template kung ang variable ay may hindi null na halaga; kung hindi, ito ay
isama ang Y. Ang X at Y ay mga placeholder para sa anumang wastong teksto ng template, at maaaring kasama
interpolated variable o iba pang kondisyon. Maaaring tanggalin ang $else$ na seksyon.

Kapag ang mga variable ay maaaring magkaroon ng maraming halaga (halimbawa, may-akda sa isang dokumento na may maraming may-akda),
maaari mong gamitin ang keyword na $for$:

$para kay(may-akda)$

$endfor$

Maaari mong opsyonal na tukuyin ang isang separator na gagamitin sa pagitan ng magkakasunod na item:

$for(author)$$author$$sep$, $endfor$

Maaaring gamitin ang isang tuldok upang pumili ng field ng isang variable na kumukuha ng isang bagay bilang halaga nito. Kaya,
halimbawa:

$author.name$ ($author.affiliation$)

Kung gumagamit ka ng mga custom na template, maaaring kailanganin mong baguhin ang mga ito bilang mga pagbabago sa pandoc. Inirerekomenda namin
pagsubaybay sa mga pagbabago sa mga default na template, at pagbabago sa iyong mga custom na template
naaayon. Ang isang madaling paraan upang gawin ito ay ang pag-fork ng pandoc-templates repository at pagsamahin
sa mga pagbabago pagkatapos ng bawat paglabas ng pandoc.

PANDOC'S MARKDOWN

Naiintindihan ni Pandoc ang pinalawig at bahagyang binagong bersyon ng Markdown ni John Gruber
syntax. Ipinapaliwanag ng dokumentong ito ang syntax, na nagpapansin ng mga pagkakaiba mula sa karaniwang Markdown.
Maliban kung nabanggit, ang mga pagkakaibang ito ay maaaring sugpuin sa pamamagitan ng paggamit ng markdown_strict
format sa halip na markdown. Maaaring paganahin ang isang extension sa pamamagitan ng pagdaragdag ng +EXTENSION sa
pangalan ng format at hindi pinagana sa pamamagitan ng pagdaragdag ng -EXTENSION. Halimbawa, ang markdown_strict+footnotes ay
mahigpit na Markdown na pinagana ang mga footnote, habang ang markdown-footnotes-pipe_tables ay pandoc's
Markdown na walang footnote o pipe table.

Pilosopya
Ang Markdown ay idinisenyo upang maging madaling isulat, at, mas mahalaga, madaling basahin:

Ang isang Markdown-formatted na dokumento ay dapat na mai-publish kung ano man, bilang plain text, nang wala
mukhang namarkahan ito ng mga tag o mga tagubilin sa pag-format. -- Juan
Gruber

Ginabayan ng prinsipyong ito ang mga desisyon ni pandoc sa paghahanap ng syntax para sa mga talahanayan, footnote, at
iba pang mga extension.

Gayunpaman, mayroong isang paggalang kung saan ang mga layunin ng pandoc ay naiiba sa orihinal na mga layunin
ng Markdown. Samantalang ang Markdown ay orihinal na idinisenyo na nasa isip ang pagbuo ng HTML,
Ang pandoc ay idinisenyo para sa maramihang mga format ng output. Kaya, habang pinapayagan ng pandoc ang pag-embed
ng hilaw na HTML, pinipigilan nito ito, at nagbibigay ng iba, hindi HTMLish na paraan ng pagkatawan
mahahalagang elemento ng dokumento tulad ng mga listahan ng kahulugan, talahanayan, matematika, at footnote.

Talata
Ang talata ay isa o higit pang mga linya ng teksto na sinusundan ng isa o higit pang mga blangkong linya. Mga bagong linya
ay itinuturing bilang mga puwang, kaya maaari mong i-reflow ang iyong mga talata hangga't gusto mo. Kung kailangan mo ng mahirap
line break, maglagay ng dalawa o higit pang mga puwang sa dulo ng isang linya.

Extension: escaped_line_breaks
Ang backslash na sinusundan ng isang bagong linya ay isa ring hard line break. Tandaan: sa multiline at grid
mga cell ng talahanayan, ito ang tanging paraan upang lumikha ng isang hard line break, dahil may mga sumusunod na puwang
ang mga cell ay hindi pinapansin.

Header
Mayroong dalawang uri ng mga header: Setext at ATX.

Setext-style header
Ang isang setext-style na header ay isang linya ng text na "nakasalungguhit" na may hilera ng = sign (para sa isang antas
isang header) o - mga palatandaan (para sa isang antas ng dalawang header):

Isang antas-isang header
==================

Isang antas-dalawang header
------------------

Ang teksto ng header ay maaaring maglaman ng inline na pag-format, tulad ng diin (tingnan ang Inline na pag-format,
sa ibaba).

ATX-style header
Ang isang ATX-style na header ay binubuo ng isa hanggang anim na # sign at isang linya ng text, opsyonal na sinusundan
sa pamamagitan ng anumang bilang ng # na palatandaan. Ang bilang ng # na palatandaan sa simula ng linya ay ang
antas ng header:

## Isang antas-dalawang header

### Isang antas-tatlong header ###

Tulad ng sa mga header na istilo ng setext, maaaring maglaman ng pag-format ang teksto ng header:

# Isang level-one na header na may [link](/url) at *emphasis*

Extension: blank_before_header
Ang karaniwang Markdown syntax ay hindi nangangailangan ng isang blangkong linya bago ang isang header. Ginagawa ni Pandoc
kailangan ito (maliban, siyempre, sa simula ng dokumento). Ang dahilan para sa
ang kinakailangan ay napakadali para sa isang # na mapunta sa simula ng isang linya
aksidente (marahil sa pamamagitan ng line wrapping). Isaalang-alang, halimbawa:

Gusto ko ang ilan sa kanilang mga lasa ng ice cream:
#22, halimbawa, at #5.

Ulo mga nagpapakilala
Extension: header_attributes
Ang mga header ay maaaring magtalaga ng mga katangian gamit ang syntax na ito sa dulo ng linyang naglalaman ng
header text:

{#identifier .class .class key=value key=value}

Kaya, halimbawa, ang mga sumusunod na header ay itatalaga lahat ng identifier foo:

# Aking header {#foo}

## Aking header ## {#foo}

Ang isa ko pang header {#foo}
---------------

(Ang syntax na ito ay katugma sa PHP Markdown Extra.)

Tandaan na bagama't pinapayagan ng syntax na ito ang pagtatalaga ng mga klase at mga katangian ng susi/halaga,
karaniwang hindi ginagamit ng mga manunulat ang lahat ng impormasyong ito. Mga identifier, klase, at susi/halaga
ginagamit ang mga attribute sa HTML at HTML-based na mga format gaya ng EPUB at slidy. Mga Identifier
ay ginagamit para sa mga label at link anchor sa LaTeX, ConTeXt, Textile, at AsciiDoc na mga manunulat.

Hindi mabibilang ang mga header na walang numero ang klase, kahit na ang --number-sections ay
tinukoy. Ang isang gitling (-) sa isang konteksto ng katangian ay katumbas ng .unnumbered, at
mas mainam sa mga dokumentong hindi Ingles. Kaya,

# Aking header {-}

ay pareho lang ng

# Aking header {.unnumbered}

Extension: auto_identifiers
Ang isang header na walang tahasang tinukoy na identifier ay awtomatikong itatalaga a
natatanging identifier batay sa teksto ng header. Upang kunin ang identifier mula sa header
teksto,

· Alisin ang lahat ng pag-format, mga link, atbp.

· Alisin ang lahat ng footnote.

· Alisin ang lahat ng bantas, maliban sa mga underscore, gitling, at tuldok.

· Palitan ang lahat ng mga puwang at bagong linya ng mga gitling.

· I-convert ang lahat ng alphabetic na character sa lowercase.

· Alisin ang lahat hanggang sa unang titik (maaaring hindi nagsisimula ang mga identifier sa isang numero o
bantas).

· Kung walang natitira pagkatapos nito, gamitin ang seksyon ng identifier.

Kaya, halimbawa,

Tagatukoy ng Header
────────────────────────────────────────────────── ──────
Mga identifier ng header sa HTML header-identifiers-in-html
*Mga aso*?--sa *aking* bahay? mga aso--sa-aking-bahay
[HTML], [S5], o [RTF]? html-s5-o-rtf
3. Mga aplikasyon ng aplikasyon
33 seksyon

Ang mga panuntunang ito ay dapat, sa karamihan ng mga kaso, payagan ang isa na matukoy ang identifier mula sa header
text. Ang pagbubukod ay kapag ang ilang mga header ay may parehong teksto; sa kasong ito, ang una
ay makakakuha ng isang identifier tulad ng inilarawan sa itaas; ang pangalawa ay makakakuha ng parehong identifier na may -1
idinagdag; ang pangatlo ay may -2; at iba pa.

Ang mga identifier na ito ay ginagamit upang magbigay ng mga target ng link sa talaan ng mga nilalaman na binuo ni
ang --toc|--table-of-contents na opsyon. Pinapadali din nila ang pagbibigay ng mga link mula sa isa
seksyon ng isang dokumento sa isa pa. Ang isang link sa seksyong ito, halimbawa, ay maaaring magmukhang
ito:

Tingnan ang seksyon sa
[header identifiers](#header-identifiers-in-html-latex-and-context).

Tandaan, gayunpaman, na ang paraan ng pagbibigay ng mga link sa mga seksyon ay gumagana lamang sa HTML, LaTeX,
at mga format ng ConTeXt.

Kung ang --section-divs na opsyon ay tinukoy, ang bawat seksyon ay ibalot sa isang div (o
isang seksyon, kung ang --html5 ay tinukoy), at ang identifier ay ikakabit sa kalakip
(o ) na tag sa halip na ang mismong header. Ito ay nagpapahintulot sa buong mga seksyon na maging
manipulahin gamit ang javascript o tratuhin nang iba sa CSS.

Extension: implicit_header_references
Ang Pandoc ay kumikilos na parang tinukoy ang mga reference na link para sa bawat header. Kaya, sa halip na

[header identifiers](#header-identifiers-in-html)

magsulat ka lang

[mga identifier ng header]

or

[mga identifier ng header][]

or

[ang seksyon sa mga identifier ng header][mga identifier ng header]

Kung maraming mga header na may magkaparehong teksto, magli-link ang kaukulang sanggunian
sa una lang, at kakailanganin mong gumamit ng mga tahasang link para mag-link sa iba, bilang
inilarawan sa itaas.

Tulad ng mga regular na reference na link, ang mga reference na ito ay case-insensitive.

Palaging binibigyang-priyoridad ang mga malinaw na kahulugan ng reference ng link kaysa sa mga implicit na reference ng header.
Kaya, sa sumusunod na halimbawa, ang link ay ituturo sa bar, hindi sa #foo:

# Foo

[foo]: bar

Tingnan ang [foo]

Harangan ang kasabihan
Gumagamit ang Markdown ng mga email convention para sa pag-quote ng mga bloke ng text. Ang isang block quotation ay isa o
higit pang mga talata o iba pang elemento ng block (tulad ng mga listahan o header), sa bawat linya
pinangungunahan ng isang > character at isang opsyonal na espasyo. (Ang > ay hindi kailangang magsimula sa kaliwa
margin, ngunit hindi ito dapat naka-indent ng higit sa tatlong puwang.)

> Ito ay isang block quote. Ito
> ang talata ay may dalawang linya.
>
> 1. Ito ay isang listahan sa loob ng isang block quote.
> 2. Pangalawang aytem.

Ang isang "tamad" na form, na nangangailangan ng > character lamang sa unang linya ng bawat bloke, ay
pinapayagan din:

> Ito ay isang block quote. Ito
ang talata ay may dalawang linya.

> 1. Ito ay isang listahan sa loob ng isang block quote.
2. Pangalawang aytem.

Kabilang sa mga elemento ng block na maaaring mapaloob sa isang block quote ay ang iba pang mga block quote.
Iyon ay, maaaring ma-nest ang mga block quotes:

> Ito ay isang block quote.
>
> > Isang block quote sa loob ng isang block quote.

Kung ang > character ay sinusundan ng isang opsyonal na espasyo, ang espasyong iyon ay ituturing na bahagi ng
ang block quote marker at hindi bahagi ng indentation ng mga nilalaman. Kaya, upang ilagay ang isang
naka-indent na code block sa isang block quote, kailangan mo ng limang puwang pagkatapos ng >:

> code

Extension: blank_before_blockquote
Ang karaniwang Markdown syntax ay hindi nangangailangan ng isang blangkong linya bago ang isang block quote. Ginagawa ni Pandoc
kailangan ito (maliban, siyempre, sa simula ng dokumento). Ang dahilan para sa
ang kinakailangan ay napakadali para sa isang > na mapunta sa simula ng isang linya
aksidente (marahil sa pamamagitan ng line wrapping). Kaya, maliban kung ginamit ang markdown_strict na format,
ang sumusunod ay hindi gumagawa ng nested block quote sa pandoc:

> Ito ay isang block quote.
>> Nested.

walang kulang ang pangungusap (code) bloke
Kinilala code bloke
Ang isang bloke ng text na naka-indent ng apat na puwang (o isang tab) ay itinuturing bilang verbatim text: ibig sabihin,
ang mga espesyal na character ay hindi nagti-trigger ng espesyal na pag-format, at lahat ng mga puwang at line break ay
iniingatan. Halimbawa,

kung (a > 3) {
moveShip(5 * gravity, DOWN);
}

Ang inisyal (apat na espasyo o isang tab) na indentation ay hindi itinuturing na bahagi ng verbatim
text, at inalis sa output.

Tandaan: ang mga blangkong linya sa verbatim na teksto ay hindi kailangang magsimula sa apat na puwang.

Nakulong code bloke
Extension: fenced_code_blocks
Bilang karagdagan sa mga karaniwang naka-indent na bloke ng code, sinusuportahan ng pandoc nabakuran mga bloke ng code. Ang mga ito
magsimula sa isang hilera ng tatlo o higit pang mga tilde (~) at nagtatapos sa isang hilera ng mga tilde na dapat ay nasa
hindi bababa sa kasinghaba ng panimulang hilera. Lahat ng nasa pagitan ng mga linyang ito ay itinuturing bilang code. Hindi
kailangan ang indentation:

~~~~~~~
kung (a > 3) {
moveShip(5 * gravity, DOWN);
}
~~~~~~~

Tulad ng mga regular na bloke ng code, ang mga nabakuran na bloke ng code ay dapat na ihiwalay mula sa nakapalibot na teksto sa pamamagitan ng
mga blangkong linya.

Kung ang code mismo ay naglalaman ng isang hilera ng mga tilde o backtick, gumamit lamang ng mas mahabang hanay ng mga tilde
o mga backtick sa simula at pagtatapos:

~~~~~~~~~~~~~~~~
~~~~~~~~~~
code kasama ang tildes
~~~~~~~~~~
~~~~~~~~~~~~~~~~

Extension: backtick_code_blocks
Pareho sa fenced_code_blocks, ngunit gumagamit ng backtick (`) sa halip na tildes (~).

Extension: fenced_code_attributes
Opsyonal, maaari kang mag-attach ng mga attribute sa nabakuran o backtick na code block gamit ang syntax na ito:

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

Narito ang mycode ay isang identifier, haskell at numberLines ay mga klase, at ang startFrom ay isang
attribute na may value na 100. Maaaring gamitin ng ilang format ng output ang impormasyong ito para gawin ang syntax
pag-highlight. Sa kasalukuyan, ang tanging mga format ng output na gumagamit ng impormasyong ito ay HTML at
LaTeX. Kung sinusuportahan ang pag-highlight para sa iyong format ng output at wika, pagkatapos ay ang code
bloke sa itaas ay lilitaw na naka-highlight, na may mga numerong linya. (Upang makita kung aling mga wika ang
suportado, gawin pandoc --version.) Kung hindi, lalabas ang code block sa itaas tulad ng sumusunod:



...



Ang isang shortcut form ay maaari ding gamitin para sa pagtukoy ng wika ng code block:

```haskell
qsort [] = []
```

Ito ay katumbas ng:

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

Kung ang extension ng fenced_code_attributes ay hindi pinagana, ngunit naglalaman ang input ng (mga) attribute ng klase
para sa codeblock, ang first class attribute ay ipi-print pagkatapos ng opening fence bilang a
hubad na salita.

Upang maiwasan ang lahat ng pag-highlight, gamitin ang --no-highlight na flag. Upang itakda ang istilo ng pag-highlight,
gumamit ng --highlight-style. Para sa higit pang impormasyon sa pag-highlight, tingnan ang Syntax highlighting,
sa ibaba.

Linya bloke
Extension: line_blocks
Ang line block ay isang sequence ng mga linya na nagsisimula sa vertical bar (|) na sinusundan ng space.
Ang paghahati sa mga linya ay pananatilihin sa output, pati na rin ang anumang nangungunang mga puwang;
kung hindi, ang mga linya ay ipo-format bilang Markdown. Ito ay kapaki-pakinabang para sa taludtod at
mga address:

| Ang mga limerick pack ay tumatawa ng anatomical
| Sa espasyo na medyo matipid.
| Pero ang mga magagaling na nakita ko
| Kaya bihira ang malinis
| At ang mga malinis kaya bihira ay nakakatawa

| 200 Main St.
| Berkeley, CA 94718

Ang mga linya ay maaaring maging hard-wrapped kung kinakailangan, ngunit ang pagpapatuloy na linya ay dapat magsimula sa a
espasyo.

| Ang Karapat-dapat na Kagalang-galang na Pinaka-kagalang-galang at Matuwid na si Samuel L.
Constable, Jr.
| 200 Main St.
| Berkeley, CA 94718

Ang syntax na ito ay hiniram mula sa reStructuredText.

Mga Listahan
Bala mga listahan
Ang bullet list ay isang listahan ng mga bullet na item sa listahan. Ang isang bullet na item sa listahan ay nagsisimula sa isang bullet
(*, +, o -). Narito ang isang simpleng halimbawa:

*isa
* dalawa
* tatlo

Magbubunga ito ng isang "compact" na listahan. Kung gusto mo ng isang "maluwag" na listahan, kung saan ang bawat item ay
naka-format bilang isang talata, maglagay ng mga puwang sa pagitan ng mga item:

*isa

* dalawa

* tatlo

Ang mga bala ay hindi kailangang mapantayan sa kaliwang margin; maaari silang naka-indent ng isa, dalawa, o
tatlong puwang. Ang bala ay dapat na sinundan ng whitespace.

Ang mga item sa listahan ay mas maganda kung ang mga kasunod na linya ay kapantay ng unang linya (pagkatapos ng bullet):

* eto ang una ko
listahan ng item.
* at ang pangalawa ko.

Ngunit pinapayagan din ng Markdown ang isang "tamad" na format:

* eto ang una ko
listahan ng item.
* at ang pangalawa ko.

Ang apat na espasyo mamuno
Ang isang item sa listahan ay maaaring maglaman ng maraming talata at iba pang nilalaman sa antas ng block. gayunpaman,
ang mga kasunod na talata ay dapat na unahan ng isang blangkong linya at naka-indent ng apat na puwang o isang tab.
Magiging mas maganda ang listahan kung ang unang talata ay nakahanay sa iba pa:

* Unang talata.

Patuloy.

* Pangalawang talata. Gamit ang isang bloke ng code, na dapat na naka-indent
walong puwang:

{ code }

Ang mga item sa listahan ay maaaring may kasamang iba pang mga listahan. Sa kasong ito, ang naunang blangko na linya ay opsyonal.
Dapat na naka-indent ang nested list ng apat na puwang o isang tab:

* mga prutas
+ mansanas
- macintosh
- pulang masarap
+ peras
+ mga milokoton
* gulay
+ brokuli
+ chard

Gaya ng nabanggit sa itaas, pinapayagan ka ng Markdown na magsulat ng mga item sa listahan na "tamad," sa halip na mag-indent
mga linya ng pagpapatuloy. Gayunpaman, kung mayroong maraming mga talata o iba pang mga bloke sa isang listahan
item, ang unang linya ng bawat isa ay dapat na naka-indent.

+ Isang tamad, tamad, listahan
item.

+ Isa pa; ang hitsura nito
masama pero legal.

Pangalawang talata ng pangalawa
listahan ng item.

tandaan: Bagama't ang tuntuning may apat na espasyo para sa mga talata ng pagpapatuloy ay nagmula sa opisyal
Markdown syntax guide, ang reference na pagpapatupad, Markdown.pl, ay hindi sumusunod dito. Kaya
pandoc ay magbibigay ng iba't ibang mga resulta kaysa sa Markdown.pl kapag ang mga may-akda ay nag-indent
mga talata ng pagpapatuloy na mas kaunti sa apat na puwang.

Ang gabay sa syntax ng Markdown ay hindi tahasan kung nalalapat ang panuntunang may apat na espasyo lahat
block-level na nilalaman sa isang listahan ng item; binabanggit lamang nito ang mga talata at mga bloke ng code. Ngunit ito
nagpapahiwatig na nalalapat ang panuntunan sa lahat ng nilalaman sa antas ng block (kabilang ang mga naka-nest na listahan), at
ganyan ang interpretasyon ni pandoc.

Pinag-utos mga listahan
Ang mga order na listahan ay gumagana tulad ng mga bullet na listahan, maliban na ang mga item ay nagsisimula sa mga enumerator
sa halip na mga bala.

Sa karaniwang Markdown, ang mga enumerator ay mga decimal na numero na sinusundan ng isang tuldok at isang puwang.
Ang mga numero mismo ay hindi pinapansin, kaya walang pagkakaiba sa pagitan ng listahang ito:

1. isa
2. dalawa
3. tatlo

at ito:

5. isa
7. dalawa
1. tatlo

Extension: fancy_lists
Hindi tulad ng karaniwang Markdown, pinapayagan ng pandoc ang mga ordered list item na mamarkahan ng uppercase at
maliliit na titik at roman numeral, bilang karagdagan sa mga arabic numeral. Ang mga marker ng listahan ay maaaring
nakapaloob sa panaklong o sinusundan ng iisang kanang panaklong o tuldok. Sila ay dapat na
pinaghihiwalay mula sa text na sinusundan ng kahit isang puwang, at, kung ang list marker ay a
malaking titik na may tuldok, ng hindi bababa sa dalawang puwang.

Ang extension ng fancy_lists ay nagpapahintulot din sa '#' na gamitin bilang isang ordered list marker bilang kapalit ng
isang numeral:

#. isa
#. dalawa

Extension: startnum
Binibigyang-pansin din ni Pandoc ang uri ng list marker na ginamit, at ang panimulang numero,
at pareho sa mga ito ay pinapanatili kung saan posible sa output format. Kaya, ang mga sumusunod
nagbubunga ng isang listahan na may mga numero na sinusundan ng isang solong panaklong, simula sa 9, at a
sublist na may maliliit na roman numeral:

9) Ikasiyam
10) Ikasampu
11) Ika-labing-isa
i. subone
ii. subtwo
iii. subthree

Magsisimula ang Pandoc ng bagong listahan sa tuwing gagamit ng ibang uri ng list marker. Kaya ang
ang sumusunod ay lilikha ng tatlong listahan:

(2) Dalawa
(5) Tatlo
1. Apat
* Lima

Kung ang mga default na marker ng listahan ay nais, gamitin ang #.:

#. isa
#. dalawa
#. tatlo

Depinisyon mga listahan
Extension: definition_lists
Sinusuportahan ng Pandoc ang mga listahan ng kahulugan, gamit ang syntax ng PHP Markdown Extra kasama ang ilan
mga extension.

Kataga 1

: Kahulugan 1

Term 2 na may *inline markup*

: Kahulugan 2

{ ilang code, bahagi ng Definition 2 }

Pangatlong talata ng kahulugan 2.

Ang bawat termino ay dapat magkasya sa isang linya, na maaaring opsyonal na sundan ng isang blangkong linya, at dapat
susundan ng isa o higit pang mga kahulugan. Ang isang kahulugan ay nagsisimula sa isang tutuldok o tilde, na
maaaring naka-indent ng isa o dalawang puwang.

Ang isang termino ay maaaring magkaroon ng maraming kahulugan, at ang bawat kahulugan ay maaaring binubuo ng isa o higit pang bloke
mga elemento (talata, block ng code, listahan, atbp.), bawat isa ay nag-indent ng apat na puwang o isang tab stop.
Ang katawan ng kahulugan (kabilang ang unang linya, bukod sa colon o tilde)
dapat na naka-indent ng apat na puwang. Gayunpaman, tulad ng iba pang mga listahan ng Markdown, maaari kang "tamad"
alisin ang indentation maliban sa simula ng isang talata o iba pang elemento ng block:

Kataga 1

: Kahulugan
may tamad na pagpapatuloy.

Pangalawang talata ng kahulugan.

Kung mag-iiwan ka ng espasyo bago ang kahulugan (tulad ng sa halimbawa sa itaas), ang teksto ng
ang kahulugan ay ituturing bilang isang talata. Sa ilang mga format ng output, ito ay nangangahulugan na mas malaki
pagitan ng mga pares ng termino/kahulugan. Para sa isang mas compact na listahan ng kahulugan, alisin ang espasyo
bago ang kahulugan:

Kataga 1
~ Kahulugan 1

Kataga 2
~ Kahulugan 2a
~ Kahulugan 2b

Tandaan na ang espasyo sa pagitan ng mga item sa isang listahan ng kahulugan ay kinakailangan. (Isang variant na lumuwag
ang kinakailangang ito, ngunit hindi pinapayagan ang "tamad" na matigas na pambalot, ay maaaring i-activate gamit ang
compact_definition_lists: tingnan ang mga Non-pandoc na extension, sa ibaba.)

Napakunot halimbawa mga listahan
Extension: example_lists
Ang espesyal na list marker @ ay maaaring gamitin para sa mga sunud-sunod na bilang ng mga halimbawa. Ang unang listahan
ang item na may @ marker ay bibigyan ng bilang na '1', ang susunod na '2', at iba pa, sa buong
dokumento. Ang mga may bilang na halimbawa ay hindi kailangang mangyari sa isang listahan; bawat bagong listahan gamit ang @
aabot sa kung saan ang huling tumigil. Kaya, halimbawa:

(@) Ang aking unang halimbawa ay bibigyan ng bilang (1).
(@) Ang aking pangalawang halimbawa ay bibigyan ng bilang (2).

Pagpapaliwanag ng mga halimbawa.

(@) Ang aking pangatlong halimbawa ay bibigyan ng bilang (3).

Ang mga may bilang na halimbawa ay maaaring lagyan ng label at i-refer sa ibang lugar sa dokumento:

(@good) Isa itong magandang halimbawa.

Gaya ng inilalarawan ni (@good), ...

Ang label ay maaaring maging anumang string ng mga alphanumeric na character, underscore, o gitling.

Siksik at hindi kabit-kabit mga listahan
Iba ang pag-uugali ni Pandoc mula sa Markdown.pl sa ilang "edge cases" na kinasasangkutan ng mga listahan.
Isaalang-alang ang pinagmulang ito:

+ Una
+ Pangalawa:
- Bayad
- Fie
- Kalaban

+ Pangatlo

Ginagawa ito ng Pandoc bilang isang "compact list" (na may no mga tag sa paligid ng "Una", "Ikalawa",
o "Pangatlo"), habang naglalagay ang Markdown mga tag sa paligid ng "Ikalawa" at "Ikatlo" (ngunit hindi "Una"),
dahil sa blankong espasyo sa paligid ng "Third". Ang Pandoc ay sumusunod sa isang simpleng tuntunin: kung ang teksto ay
na sinusundan ng isang blangkong linya, ito ay itinuturing bilang isang talata. Dahil ang "Second" ay sinusundan ng a
listahan, at hindi isang blangkong linya, hindi ito itinuturing bilang isang talata. Ang katotohanan na ang listahan ay
na sinusundan ng isang blangkong linya ay hindi nauugnay. (Tandaan: Gumagana ang Pandoc sa ganitong paraan kahit na ang
markdown_strict na format ay tinukoy. Ang pag-uugali na ito ay pare-pareho sa opisyal
Markdown syntax na paglalarawan, kahit na ito ay naiiba sa Markdown.pl.)

Wakas a listahan
Paano kung gusto mong maglagay ng naka-indent na bloke ng code pagkatapos ng isang listahan?

- unang item
- dalawang item

{ my code block }

Gulo! Dito ituturing ng pandoc (tulad ng ibang mga pagpapatupad ng Markdown) ang { my code block } bilang
ang pangalawang talata ng dalawang item, at hindi bilang isang bloke ng code.

Upang "putulin" ang listahan pagkatapos ng dalawang item, maaari kang magpasok ng ilang hindi naka-indent na nilalaman, tulad ng isang
HTML na komento, na hindi gagawa ng nakikitang output sa anumang format:

- unang item
- dalawang item



{ my code block }

Maaari mong gamitin ang parehong trick kung gusto mo ng dalawang magkasunod na listahan sa halip na isang malaking listahan:

1. isa
2. dalawa
3. tatlo



1. isa
2. dos
3. tres

Pahalang patakaran
Isang linyang naglalaman ng row ng tatlo o higit pang *, -, o _ character (opsyonal na pinaghihiwalay ng
spaces) ay gumagawa ng isang pahalang na panuntunan:

* * * *

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

Mga Table
Apat na uri ng mesa ang maaaring gamitin. Ipinapalagay ng unang tatlong uri ang paggamit ng a
fixed-width na font, gaya ng Courier. Ang ikaapat na uri ay maaaring gamitin nang may proporsyonal na espasyo
mga font, dahil hindi ito nangangailangan ng linya ng mga column.

Extension: table_captions
Ang isang caption ay maaaring opsyonal na ibigay sa lahat ng 4 na uri ng mga talahanayan (tulad ng inilalarawan sa
mga halimbawa sa ibaba). Ang caption ay isang talata na nagsisimula sa string na Table: (o :),
na huhubaran. Maaaring lumitaw ito bago o pagkatapos ng talahanayan.

Extension: simple_tables
Ang mga simpleng talahanayan ay ganito ang hitsura:

Kanan Kaliwa Gitna Default
------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1

Talahanayan: Pagpapakita ng simpleng syntax ng talahanayan.

Ang mga header at mga hilera ng talahanayan ay dapat magkasya sa isang linya. Ang mga alignment ng column ay tinutukoy ng
ang posisyon ng teksto ng header na nauugnay sa dashed na linya sa ibaba nito:

· Kung ang putol-putol na linya ay kapantay ng teksto ng header sa kanang bahagi ngunit lampas pa rito
sa kaliwa, ang column ay naka-align sa kanan.

· Kung ang putol-putol na linya ay kapantay ng teksto ng header sa kaliwang bahagi ngunit lumalampas ito
sa kanan, naka-left-align ang column.

· Kung ang putol-putol na linya ay lumampas sa teksto ng header sa magkabilang panig, ang column ay nasa gitna.

· Kung ang putol-putol na linya ay kapantay ng teksto ng header sa magkabilang panig, ang default na pagkakahanay ay
ginamit (sa karamihan ng mga kaso, ito ay maiiwan).

Ang talahanayan ay dapat magtapos sa isang blangkong linya, o isang linya ng mga gitling na sinusundan ng isang blangkong linya.

Maaaring tanggalin ang mga header ng column, sa kondisyon na gumamit ng dashed line upang tapusin ang talahanayan. Para sa
halimbawa:

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

Kapag ang mga header ay tinanggal, ang mga alignment ng column ay tinutukoy batay sa unang linya
ng katawan ng mesa. Kaya, sa mga talahanayan sa itaas, ang mga column ay nasa kanan, kaliwa, gitna, at
naka-align sa kanan, ayon sa pagkakabanggit.

Extension: multiline_tables
Pinapayagan ng mga multiline na talahanayan ang mga header at mga hilera ng talahanayan na sumasaklaw sa maraming linya ng teksto (ngunit ang mga cell
na sumasaklaw sa maraming column o row ng table ay hindi suportado). Narito ang isang halimbawa:

-------------------------------------------------- -----------
Nakasentro Default Kanan Kaliwa
Header Aligned Aligned Aligned
------------------------- ------- -------------- ----------------- --------
Unang hilera 12.0 Halimbawa ng isang hilera na
sumasaklaw sa maraming linya.

Pangalawang hilera 5.0 Narito ang isa pa. Tandaan
ang blangkong linya sa pagitan
mga hilera.
-------------------------------------------------- -----------

Table: Narito ang caption. Ito, masyadong, ay maaaring sumasaklaw
maraming linya.

Gumagana ang mga ito tulad ng mga simpleng talahanayan, ngunit may mga sumusunod na pagkakaiba:

· Dapat silang magsimula sa isang hilera ng mga gitling, bago ang teksto ng header (maliban kung ang mga header ay
tinanggal).

· Dapat silang magtapos sa isang hilera ng mga gitling, pagkatapos ay isang blangkong linya.

· Ang mga hilera ay dapat na pinaghihiwalay ng mga blangkong linya.

Sa mga multiline na talahanayan, binibigyang-pansin ng table parser ang mga lapad ng mga column, at ang
sinusubukan ng mga manunulat na kopyahin ang mga kamag-anak na lapad na ito sa output. Kaya, kung nahanap mo ang isa sa
masyadong makitid ang mga column sa output, subukang palawakin ito sa Markdown source.

Maaaring tanggalin ang mga header sa mga multiline na talahanayan gayundin sa mga simpleng talahanayan:

------------------------- ------- -------------- ----------------- --------
Unang hilera 12.0 Halimbawa ng isang hilera na
sumasaklaw sa maraming linya.

Pangalawang hilera 5.0 Narito ang isa pa. Tandaan
ang blangkong linya sa pagitan
mga hilera.
------------------------- ------- -------------- ----------------- --------

: Narito ang isang multiline table na walang mga header.

Posible para sa isang multiline table na magkaroon lamang ng isang row, ngunit dapat sundin ang row
sa pamamagitan ng isang blangkong linya (at pagkatapos ay ang hilera ng mga gitling na nagtatapos sa talahanayan), o ang talahanayan ay maaaring
binibigyang kahulugan bilang isang simpleng talahanayan.

Extension: grid_tables
Ganito ang hitsura ng mga grid table:

: Halimbawang grid table.

+--------------+-----------------+----------------- ---+
| Prutas | Presyo | Mga kalamangan |
+===============+=================+== ===+
| Mga saging | $1.34 | - built-in na wrapper |
| | | - maliwanag na kulay |
+--------------+-----------------+----------------- ---+
| Mga dalandan | $2.10 | - nagpapagaling ng scurvy |
| | | - masarap |
+--------------+-----------------+----------------- ---+

Ang row ng =s ay naghihiwalay sa header mula sa table body, at maaaring tanggalin para sa a
mesa na walang ulo. Ang mga cell ng grid table ay maaaring maglaman ng mga di-makatwirang elemento ng block (multiple
mga talata, mga bloke ng code, mga listahan, atbp.). Hindi sinusuportahan ang mga alignment, at hindi rin sinusuportahan ang mga cell
sumasaklaw sa maraming column o row. Madaling magawa ang mga grid table gamit ang Emacs table mode.

Extension: pipe_tables
Ang mga talahanayan ng tubo ay ganito ang hitsura:

| Kanan | Kaliwa | Default | Gitna |
|------:|:-----|---------|:------:|
| 12 | 12 | 12 | 12 |
| 123 | 123 | 123 | 123 |
| 1 | 1 | 1 | 1 |

: Pagpapakita ng pipe table syntax.

Ang syntax ay kapareho ng PHP Markdown Extra table. Ang simula at pagtatapos ng tubo
opsyonal ang mga character, ngunit kailangan ang mga pipe sa pagitan ng lahat ng column. Ang mga tutuldok ay nagpapahiwatig
alignment ng column gaya ng ipinapakita. Hindi maaaring tanggalin ang header. Upang gayahin ang isang table na walang header,
magsama ng header na may mga blangkong cell.

Dahil ang mga tubo ay nagpapahiwatig ng mga hangganan ng haligi, ang mga haligi ay hindi kailangang patayo na nakahanay, bilang
sila ay nasa halimbawa sa itaas. Kaya, ito ay isang perpektong legal (bagaman pangit) pipe table:

prutas| presyo
-----|-----:
mansanas|2.05
peras|1.37
orange|3.09

Ang mga cell ng pipe table ay hindi maaaring maglaman ng mga elemento ng block tulad ng mga talata at listahan, at
hindi maaaring sumaklaw ng maraming linya. Kung ang isang pipe table ay naglalaman ng isang hilera na ang napi-print na nilalaman ay
mas malawak kaysa sa lapad ng column (tingnan ang --columns), pagkatapos ay ibalot ang mga nilalaman ng cell, na may
mga kamag-anak na lapad ng cell na tinutukoy ng mga lapad ng mga linya ng separator.

Tandaan: kinikilala din ng pandoc ang mga pipe table ng sumusunod na anyo, gaya ng maaaring gawin ng
orgtbl-mode ng Emacs:

| Isa | Dalawa |
|-----+-------|
| aking | talahanayan |
| ay | maganda |

Ang pagkakaiba ay ang + ay ginagamit sa halip na |. Hindi sinusuportahan ang iba pang feature ng orgtbl.
Sa partikular, upang makakuha ng hindi default na pag-align ng column, kakailanganin mong magdagdag ng mga colon tulad ng nasa itaas.

metadata bloke
Extension: pandoc_title_block
Kung ang file ay nagsisimula sa isang title block

% pamagat
% (mga) may-akda (na pinaghihiwalay ng mga semicolon)
% petsa

ito ay i-parse bilang bibliographic na impormasyon, hindi regular na teksto. (Gagamitin ito, para sa
halimbawa, sa pamagat ng standalone na LaTeX o HTML na output.) Ang block ay maaaring maglaman lamang ng a
pamagat, pamagat at may-akda, o lahat ng tatlong elemento. Kung gusto mong magsama ng author pero
walang pamagat, o pamagat at petsa ngunit walang may-akda, kailangan mo ng blangkong linya:

%
% May-akda

% Ang aking pamagat
%
% Hunyo 15, 2006

Maaaring sumakop ang pamagat ng maraming linya, ngunit ang mga linya ng pagpapatuloy ay dapat magsimula sa nangungunang espasyo,
kaya:

% Ang aking pamagat
sa maraming linya

Kung ang isang dokumento ay maraming may-akda, ang mga may-akda ay maaaring ilagay sa magkahiwalay na linya na may nangunguna
space, o pinaghihiwalay ng semicolon, o pareho. Kaya, ang lahat ng sumusunod ay katumbas:

% Isang May-akda
Dalawang May-akda

% Isang May-akda; Dalawang May-akda

% Isang May-akda;
Dalawang May-akda

Ang petsa ay dapat magkasya sa isang linya.

Ang lahat ng tatlong metadata field ay maaaring maglaman ng karaniwang inline na pag-format (mga italiko, mga link,
mga talababa, atbp.).

Palaging ma-parse ang mga block ng pamagat, ngunit makakaapekto lamang ang mga ito sa output kapag ang
--standalone (-s) na opsyon ang pinili. Sa HTML na output, dalawang beses na lalabas ang mga pamagat: isang beses sa
document head -- ito ang pamagat na lalabas sa tuktok ng window sa isang browser
-- at isang beses sa simula ng katawan ng dokumento. Ang pamagat sa ulo ng dokumento ay maaaring
may nakalakip na opsyonal na prefix (--title-prefix o -T na opsyon). Ang pamagat sa katawan
lilitaw bilang isang H1 na elemento na may klase na "pamagat", kaya maaari itong pigilan o i-reformat gamit ang
CSS. Kung ang isang prefix ng pamagat ay tinukoy na may -T at walang lalabas na block ng pamagat sa dokumento,
ang prefix ng pamagat ay gagamitin mismo bilang pamagat ng HTML.

Kinukuha ng manunulat ng man page ang isang pamagat, numero ng seksyon ng man page, at iba pang header at footer
impormasyon mula sa linya ng pamagat. Ang pamagat ay ipinapalagay na ang unang salita sa pamagat
linya, na maaaring opsyonal na magtatapos sa isang (isang-digit) na numero ng seksyon sa mga panaklong.
(Dapat walang puwang sa pagitan ng pamagat at mga panaklong.) Anuman pagkatapos nito ay
ipinapalagay na karagdagang teksto ng footer at header. Dapat ay isang solong pipe character (|).
ginagamit upang paghiwalayin ang teksto ng footer mula sa teksto ng header. kaya,

% PANDOC(1)

ay magbubunga ng man page na may pamagat na PANDOC at seksyon 1.

% PANDOC(1) Mga Manwal ng Gumagamit ng Pandoc

magkakaroon din ng "Pandoc User Manuals" sa footer.

% PANDOC(1) Pandoc User Manuals | Bersyon 4.0

magkakaroon din ng "Bersyon 4.0" sa header.

Extension: yaml_metadata_block
Ang YAML metadata block ay isang wastong YAML object, na nililimitahan ng isang linya ng tatlong gitling (---)
sa itaas at isang linya ng tatlong gitling (---) o tatlong tuldok (...) sa ibaba. Isang YAML
Maaaring mangyari ang metadata block saanman sa dokumento, ngunit kung wala ito sa simula, ito
dapat unahan ng isang blangkong linya. (Tandaan na, dahil sa paraan ng pagsasama-sama ng pandoc
input file kapag marami ang ibinigay, maaari mo ring panatilihin ang metadata sa isang hiwalay na YAML
file at ipasa ito sa pandoc bilang argumento, kasama ang iyong Markdown files:

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

Siguraduhin lamang na ang YAML file ay nagsisimula sa --- at nagtatapos sa --- o ....)

Ang metadata ay kukunin mula sa mga field ng YAML object at idaragdag sa anumang umiiral na
metadata ng dokumento. Ang metadata ay maaaring maglaman ng mga listahan at bagay (naka-nest nang arbitraryo), ngunit lahat
Ang mga string scalar ay bibigyang-kahulugan bilang Markdown. Mga field na may mga pangalan na nagtatapos sa underscore
hindi papansinin ni pandoc. (Maaaring bigyan sila ng papel ng mga panlabas na processor.)

Ang isang dokumento ay maaaring maglaman ng maramihang mga bloke ng metadata. Ang mga patlang ng metadata ay pagsasama-samahin
sa pamamagitan ng may kinikilingan sa kaliwa unyon: kung sinubukan ng dalawang bloke ng metadata na itakda ang parehong field, ang
kukunin ang halaga mula sa unang bloke.

Kapag ginamit ang pandoc na may -t markdown upang lumikha ng isang Markdown na dokumento, isang YAML metadata block
ay gagawin lamang kung ang -s/--standalone na opsyon ay ginamit. Lahat ng metadata ay
lalabas sa isang bloke sa simula ng dokumento.

Tandaan na ang YAML escaping rules ay dapat sundin. Kaya, halimbawa, kung ang isang pamagat ay naglalaman ng a
colon, dapat itong sipi. Ang pipe character (|) ay maaaring gamitin upang simulan ang isang naka-indent na bloke
iyon ay literal na bibigyang kahulugan, nang hindi nangangailangan ng pagtakas. Ang form na ito ay kinakailangan
kapag ang field ay naglalaman ng mga blangkong linya:

---
pamagat: 'Ito ang pamagat: naglalaman ito ng tutuldok'
may-akda:
- pangalan: Isang May-akda
kaakibat: Unibersidad ng Somewhere
- pangalan: Dalawang May-akda
kaakibat: University of Nowhere
tags: [wala, wala]
abstract: |
Ito ang abstract.

Ito ay binubuo ng dalawang talata.
...

Awtomatikong itatakda ang mga variable ng template mula sa metadata. Kaya, halimbawa, sa
pagsulat ng HTML, ang variable abstract ay itatakda sa HTML na katumbas ng Markdown in
ang abstract na patlang:

Ito ang abstract.
Binubuo ito ng dalawang talata.

Tandaan: Ang variable ng may-akda sa mga default na template ay umaasa ng isang simpleng listahan o string. Upang
gamitin ang mga structured na may-akda sa halimbawa, kakailanganin mo ng custom na template. Halimbawa:

$para kay(may-akda)$
$if(author.name)$
$author.name$$if(author.affiliation)$ ($author.affiliation$)$endif$
$ibang$
$autor$
$endif$
$endfor$

backslash escapes
Extension: all_symbols_escapable
Maliban sa loob ng block ng code o inline na code, anumang bantas o space character na nauuna
literal na ituturing ang isang backslash, kahit na karaniwang nagpapahiwatig ito ng pag-format.
Kaya, halimbawa, kung ang isa ay nagsusulat

*\*Kamusta\**

makukuha ng isa

*Kamusta*

sa halip ng

Kamusta

Mas madaling matandaan ang panuntunang ito kaysa sa karaniwang panuntunan ng Markdown, na nagpapahintulot lamang sa
sumusunod na mga character na i-backslash-escaped:

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

(Gayunpaman, kung gagamitin ang markdown_strict na format, gagamitin ang karaniwang Markdown rule.)

Ang isang backslash-escaped space ay na-parse bilang isang nonbreaking space. Lalabas ito sa output ng TeX
bilang ~ at sa HTML at XML bilang \ o \ .

Ang isang backslash-escaped na bagong linya (ibig sabihin, isang backslash na nagaganap sa dulo ng isang linya) ay na-parse
bilang isang hard line break. Ito ay lilitaw sa TeX output bilang \\ at sa HTML bilang . Ito ay
isang magandang alternatibo sa "invisible" na paraan ng Markdown ng pagpahiwatig ng mga hard line break gamit ang dalawa
sumusunod na mga puwang sa isang linya.

Ang mga backslash escape ay hindi gumagana sa verbatim na konteksto.

Matalino bantas
Karugtong
Kung ang --smart na opsyon ay tinukoy, ang pandoc ay gagawa ng typographically correct na output,
pag-convert ng mga tuwid na quote sa mga kulot na quote, --- sa em-dashes, -- sa en-dashes, at ... sa
mga ellipse. Ang mga nonbreaking space ay ipinapasok pagkatapos ng ilang partikular na pagdadaglat, gaya ng "Mr."

Tandaan: kung ang iyong LaTeX na template o anumang kasamang header file ay tumawag para sa csquotes package,
Awtomatiko itong makikita ng pandoc at gagamitin ang \enquote{...} para sa sinipi na teksto.

Nasa linya -format
Bigyang diin
Upang bigyang-diin ilang text, palibutan ito ng *s o _, tulad nito:

Ang tekstong ito ay _binigyang-diin na may mga salungguhit_, at ito
ay *binigyang-diin na may mga asterisk*.

Double * o _ produces malakas diin:

Ito ay **malakas na diin** at __na may mga salungguhit__.

Ang isang * o _ character na napapalibutan ng mga puwang, o backslash-escaped, ay hindi magpapalitaw ng diin:

Ito ay * hindi binibigyang-diin *, at \*hindi rin ito\*.

Extension: intraword_underscore
Dahil minsan ay ginagamit ang _ sa loob ng mga salita at pantukoy, hindi binibigyang-kahulugan ng pandoc ang isang _
napapaligiran ng mga alphanumeric na character bilang marker ng diin. Kung gusto mong bigyang-diin
bahagi lamang ng isang salita, gamitin ang *:

feas*ible*, hindi feas*able*.

Strikeout
Extension: welga
Upang alisin ang isang seksyon ng teksto na may pahalang na linya, simulan at tapusin ito ng ~~. kaya,
Halimbawa,

Ito ~~ay tinanggal na teksto.~~

Mga Superscript at mga subscript
Extension: superscript, subskrip
Ang mga superscript ay maaaring isulat sa pamamagitan ng nakapalibot sa superscript na teksto ng ^ character;
ang mga subscript ay maaaring isulat sa pamamagitan ng nakapalibot sa naka-subscript na teksto ng ~ character. Kaya, para sa
Halimbawa,

Ang H~2~O ay isang likido. Ang 2^10^ ay 1024.

Kung ang naka-superscript o naka-subscript na text ay naglalaman ng mga puwang, dapat na i-escape ang mga puwang na ito
na may mga backslash. (Ito ay upang maiwasan ang aksidenteng pag-superscript at pag-subscribe sa pamamagitan ng
ang karaniwang paggamit ng ~ at ^.) Kaya, kung gusto mo ang titik P na may 'pusa' sa mga subscript,
gumamit ng P~a\ pusa~, hindi P~a pusa~.

walang kulang ang pangungusap
Upang gumawa ng maikling span ng text verbatim, ilagay ito sa loob ng backticks:

Ano ang pagkakaiba ng `>>=` at `>>`?

Kung ang verbatim text ay may kasamang backtick, gumamit ng double backtick:

Narito ang isang literal na backtick `` ` ``.

(Ang mga puwang pagkatapos ng pambungad na backtick at bago ang pagsasara ng backtick ay hindi papansinin.)

Ang pangkalahatang tuntunin ay ang isang verbatim span ay nagsisimula sa isang string ng magkakasunod na backtick
(opsyonal na sinusundan ng isang puwang) at nagtatapos sa isang string ng parehong bilang ng mga backtick
(opsyonal na pinangungunahan ng isang puwang).

Tandaan na ang mga backslash-escape (at iba pang Markdown construct) ay hindi gumagana sa verbatim
mga konteksto:

Ito ay isang backslash na sinusundan ng isang asterisk: `\*`.

Extension: inline_code_attributes
Maaaring i-attach ang mga katangian sa verbatim text, tulad ng sa mga nabakuran na mga bloke ng code:

`<$>`{.haskell}

maliit caps
Para magsulat ng maliliit na cap, maaari kang gumamit ng HTML span tag:

Mga maliliit na takip

(Ang semicolon ay opsyonal at maaaring may puwang pagkatapos ng colon.) Ito ay gagana sa lahat
mga format ng output na sumusuporta sa maliliit na takip.

Math
Extension: tex_math_dollars
Anumang bagay sa pagitan ng dalawang $ character ay ituturing bilang TeX math. Ang pambungad na $ ay dapat na may a
non-space na character kaagad sa kanan nito, habang ang pagsasara ng $ ay dapat may non-space
character kaagad sa kaliwa nito, at hindi dapat sundan kaagad ng isang digit. kaya,
Ang $20,000 at $30,000 ay hindi mai-parse bilang matematika. Kung sa ilang kadahilanan kailangan mong ilakip ang teksto
literal na $ character, backslash-escape ang mga ito at hindi sila ituring bilang mga math delimiter.

Ang TeX math ay ipi-print sa lahat ng mga format ng output. Kung paano ito nai-render ay depende sa output
format:

markdown, LaTeX, Emacs org fashion, ConTeXt
Ito ay lilitaw sa verbatim sa pagitan ng $ character.

mulingStracturedText
Ire-render ito gamit ang isang interpreted text role :math:.

AsciiDoc
Ire-render ito bilang latexmath:[...].

Texinfo
Ire-render ito sa loob ng @math command.

ungol lalaki
Ire-render ito ng verbatim nang walang $'s.

MediaWiki, DokuWiki
Ire-render ito sa loob mga tag.

Ukol sa paghabi
Ire-render ito sa loob ng mga tag.

RTF, OpenDocument, Odt
Ire-render ito, kung maaari, gamit ang mga unicode na character, at gagawin kung hindi
lumabas sa verbatim.

DocBook
Kung ang --mathm flag ay ginamit, ito ay ire-render gamit ang MathML sa isang inlineequation
o informalequation tag. Kung hindi, ire-render ito, kung maaari, gamit ang unicode
character.

Docx Ire-render ito gamit ang OMML math markup.

Aklat ng Fiction2
Kung gagamitin ang --webtex na opsyon, ang mga formula ay ire-render bilang mga larawan gamit ang Google Charts
o iba pang katugmang serbisyo sa web, na-download at naka-embed sa e-book. kung hindi,
lalabas ang mga ito sa verbatim.

HTML, madulas, DZSlides, S5, EPUB
Ang paraan ng pag-render ng matematika sa HTML ay depende sa mga napiling opsyon sa command-line:

1. Ang default ay i-render ang TeX math hangga't maaari gamit ang mga unicode na character,
tulad ng output ng RTF, DocBook, at OpenDocument. Ang mga formula ay inilalagay sa loob ng isang span
na may class="math", upang ang mga ito ay mai-istilo nang iba sa nakapaligid
text kung kailangan.

2. Kung ang --latexmathml na opsyon ay ginamit, ang TeX math ay ipapakita sa pagitan ng $ o $$
mga character at ilagay sa mga tag na may klase ng LaTeX. Ang LaTeXMathML script ay
gamitin upang i-render ito bilang mga formula. (Hindi gumagana ang trick na ito sa lahat ng browser,
ngunit ito ay gumagana sa Firefox. Sa mga browser na hindi sumusuporta sa LaTeXMathML, TeX math
lilitaw ang verbatim sa pagitan ng $ character.)

3. Kung ang --jsmath na opsyon ay ginamit, ang TeX math ay ilalagay sa loob ng mga tag (para sa
inline na matematika) o mga tag (para sa display math) na may class math. Ang jsMath
script ang gagamitin para i-render ito.

4. Kung ang --mimetex na opsyon ay ginamit, ang mimeTeX CGI script ay tatawagan
bumuo ng mga larawan para sa bawat formula ng TeX. Dapat itong gumana sa lahat ng mga browser. Ang
--mimetex na opsyon ay kumukuha ng opsyonal na URL bilang argumento. Kung walang tinukoy na URL, ito
ay ipagpalagay na ang mimeTeX CGI script ay nasa /cgi-bin/mimetex.cgi.

5. Kung gagamitin ang --gladtex na opsyon, ang mga formula ng TeX ay isasama mga tag sa
ang HTML na output. Ang resultang htex file ay maaaring maproseso ng gladTeX,
na gagawa ng mga file ng imahe para sa bawat formula at isang HTML file na may mga link sa
ang mga larawang ito. Kaya, ang pamamaraan ay:

pandoc -s --gladtex myfile.txt -o myfile.htex
gladtex -d myfile-images myfile.htex
# gumagawa ng myfile.html at mga larawan sa myfile-images

6. Kung ang --webtex na opsyon ay ginamit, ang TeX formula ay mako-convert sa mga tag
link na iyon sa isang panlabas na script na nagko-convert ng mga formula sa mga imahe. Ang formula
ay URL-encoded at magkakaugnay sa ibinigay na URL. Kung walang URL
tinukoy, gagamitin ang Google Chart API
(http://chart.apis.google.com/chart?cht=tx&chl=).

7. Kung ang --mathjax na opsyon ay ginamit, ang TeX math ay ipapakita sa pagitan ng \(...\) (para sa
inline math) o \[...\] (para sa display math) at ilagay sa mga tag na may klase
matematika. Ang MathJax script ay gagamitin upang i-render ito bilang mga formula.

Hilaw HTML
Extension: raw_html
Binibigyang-daan ka ng Markdown na magpasok ng raw HTML (o DocBook) kahit saan sa isang dokumento (maliban
verbatim contexts, kung saan ang <, >, at & ay literal na binibigyang kahulugan). (Sa teknikal na paraan, hindi ito
isang extension, dahil pinapayagan ito ng karaniwang Markdown, ngunit ginawa itong extension upang iyon
maaari itong hindi paganahin kung ninanais.)

Ang raw HTML ay ipinapasa nang hindi nagbabago sa HTML, S5, Slidy, Slideous, DZSlides, EPUB,
Markdown, at Textile output, at pinigilan sa iba pang mga format.

Extension: markdown_in_html_blocks
Pinapayagan ka ng Standard Markdown na isama ang "mga bloke" ng HTML: mga bloke ng HTML sa pagitan ng balanse
mga tag na nakahiwalay sa nakapalibot na teksto na may mga blangkong linya, at nagsisimula at nagtatapos sa
ang kaliwang margin. Sa loob ng mga bloke na ito, ang lahat ay binibigyang-kahulugan bilang HTML, hindi Markdown; kaya
(halimbawa), * ay hindi nagpapahiwatig ng diin.

Ganito ang pagkilos ng Pandoc kapag ginamit ang markdown_strict na format; pero by default, pandoc
binibigyang-kahulugan ang materyal sa pagitan ng mga HTML block tag bilang Markdown. Kaya, halimbawa, gagawin ni pandoc
maging



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



sa



isa
<a href="/http://google.com">isang link



samantalang ang Markdown.pl ay pananatilihin ito bilang ay.

May isang pagbubukod sa panuntunang ito: text between and tags is not
binibigyang kahulugan bilang Markdown.

Ang pag-alis na ito mula sa karaniwang Markdown ay dapat gawing mas madali ang paghaluin ang Markdown sa HTML
mga elemento ng block. Halimbawa, maaaring palibutan ng isa ang isang bloke ng Markdown text na may mga tag
nang hindi pinipigilan itong ma-interpret bilang Markdown.

Extension: native_divs
Gumamit ng katutubong pandoc Div block para sa nilalaman sa loob mga tag. Para sa karamihan, ito ay dapat
magbigay ng parehong output bilang markdown_in_html_blocks, ngunit ginagawang mas madali ang pagsulat ng pandoc
mga filter upang manipulahin ang mga grupo ng mga bloke.

Extension: native_spans
Gumamit ng mga native na pandoc Span block para sa nilalaman sa loob ng mga tag. Para sa karamihan, ito
ay dapat magbigay ng parehong output bilang raw_html, ngunit ginagawang mas madali ang pagsulat ng mga pandoc na filter
manipulahin ang mga pangkat ng mga inline.

Hilaw TeX
Extension: raw_tex
Bilang karagdagan sa raw HTML, pinapayagan ng pandoc ang raw LaTeX, TeX, at ConTeXt na maisama sa a
dokumento. Ang mga inline na TeX na utos ay pananatilihin at ipapasa nang hindi nababago sa LaTeX at
Mga manunulat ng ConTeXt. Kaya, halimbawa, maaari mong gamitin ang LaTeX upang isama ang mga pagsipi ng BibTeX:

Ang resultang ito ay napatunayan sa \cite{jones.1967}.

Tandaan na sa mga kapaligiran ng LaTeX, tulad ng

\begin{tabular}{|l|l|}\hline
Edad at Dalas \\ \hline
18--25 at 15 \\
26--35 at 33 \\
36--45 & 22 \\ \hline
\end{tabular}

ang materyal sa pagitan ng simula at pagtatapos na mga tag ay bibigyang-kahulugan bilang raw LaTeX, hindi bilang
Markdown.

Ang inline na LaTeX ay hindi pinapansin sa mga format ng output maliban sa Markdown, LaTeX, at ConTeXt.

LaTeX macros
Extension: latex_macros
Para sa mga format ng output maliban sa LaTeX, i-parse ng pandoc ang LaTeX \newcommand at \renewcommand
mga kahulugan at ilapat ang mga resultang macro sa lahat ng LaTeX math. Kaya, halimbawa, ang
ang sumusunod ay gagana sa lahat ng mga format ng output, hindi lamang sa LaTeX:

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

$\tuple{a, b, c}$

Sa LaTeX na output, ang \newcommand definition ay ipapasa lang nang hindi mababago sa output.

Links
Binibigyang-daan ng Markdown na tukuyin ang mga link sa ilang paraan.

Awtomatik mga link
Kung isasama mo ang isang URL o email address sa mga pointy bracket, ito ay magiging isang link:

<http://google.com>
<[protektado ng email]>

Nasa linya mga link
Ang isang inline na link ay binubuo ng teksto ng link sa mga square bracket, na sinusundan ng URL sa
panaklong. (Opsyonal, ang URL ay maaaring sundan ng isang pamagat ng link, sa mga panipi.)

Ito ay isang [inline na link](/url), at narito ang [isa na may
ang titulo](http://fsf.org "Mag-click dito para sa isang magandang oras!").

Maaaring walang puwang sa pagitan ng naka-bracket na bahagi at ng nakakulong na bahagi. Ang link
ang teksto ay maaaring maglaman ng pag-format (tulad ng diin), ngunit hindi maaaring ang pamagat.

Ang mga email address sa mga inline na link ay hindi na-autodetected, kaya kailangang may prefix ang mga ito
mailto:

[Isulat mo ako!](mailto:[protektado ng email])

Sanggunian mga link
An malinaw reference link ay may dalawang bahagi, ang link mismo at ang link kahulugan, na kung saan
maaaring mangyari sa ibang lugar sa dokumento (maaaring bago o pagkatapos ng link).

Ang link ay binubuo ng teksto ng link sa mga square bracket, na sinusundan ng isang label sa square bracket.
(Maaaring magkaroon ng espasyo sa pagitan ng dalawa.) Ang kahulugan ng link ay binubuo ng naka-bracket na label,
sinusundan ng isang tutuldok at isang puwang, na sinusundan ng URL, at opsyonal (pagkatapos ng isang puwang) a
pamagat ng link alinman sa mga quote o sa panaklong. Ang label ay hindi dapat ma-parseable bilang a
pagsipi (ipagpalagay na ang extension ng mga pagsipi ay pinagana): ang mga pagsipi ay mauuna
mga label ng link.

Narito ang ilang mga halimbawa:

[aking label 1]: /foo/bar.html "Aking pamagat, opsyonal"
[aking label 2]: /foo
[aking label 3]: http://fsf.org (Ang libreng software foundation)
[aking label 4]: /bar#special 'Isang pamagat sa mga solong panipi'

Ang URL ay maaaring opsyonal na napapalibutan ng mga anggulong bracket:

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

Ang pamagat ay maaaring pumunta sa susunod na linya:

[aking label 3]: http://fsf.org
"Ang libreng software foundation"

Tandaan na ang mga label ng link ay hindi case sensitive. Kaya, ito ay gagana:

Narito ang [aking link][FOO]

[Foo]: /bar/baz

Sa isang pahiwatig reference na link, ang pangalawang pares ng mga bracket ay walang laman:

Tingnan ang [aking website][].

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

Tandaan: Sa Markdown.pl at karamihan sa iba pang mga pagpapatupad ng Markdown, reference ang mga kahulugan ng link
hindi maaaring mangyari sa mga nested construction gaya ng mga list item o block quotes. Nag-angat si Pandoc
ang arbitrary na tila paghihigpit na ito. Kaya't ang mga sumusunod ay maayos sa pandoc, kahit na hindi sa
karamihan sa iba pang mga pagpapatupad:

> Aking block [quote].
>
> [quote]: /foo

Extension: shortcut_reference_links
Sa isang shortcut reference na link, ang pangalawang pares ng mga bracket ay maaaring ganap na tanggalin:

Tingnan ang [aking website].

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

Panloob mga link
Upang mag-link sa isa pang seksyon ng parehong dokumento, gamitin ang awtomatikong nabuo
identifier (tingnan ang Header identifiers). Halimbawa:

Tingnan ang [Introduction](#introduction).

or

Tingnan ang [Introduction].

[Introduction]: #introduction

Ang mga panloob na link ay kasalukuyang sinusuportahan para sa mga format ng HTML (kabilang ang mga HTML slide show at
EPUB), LaTeX, at ConTeXt.

Images
Isang link na agad na pinangungunahan ng isang ! ituturing na isang imahe. Ang teksto ng link ay magiging
ginamit bilang alt text ng imahe:


![reel ng pelikula]

[movie reel]: movie.gif

Extension: implicit_figures
Ang isang larawang nagaganap nang mag-isa sa isang talata ay ire-render bilang isang figure na may caption.
(Sa LaTeX, isang figure environment ang gagamitin; sa HTML, ang imahe ay ilalagay sa isang div
may class figure, kasama ang caption sa ap na may class caption.) Ang alt ng larawan
text ang gagamitin bilang caption.


Kung gusto mo lang ng regular na inline na imahe, siguraduhin lang na hindi lang ito ang nasa
talata. Ang isang paraan upang gawin ito ay ang pagpasok ng isang hindi nasisira na espasyo pagkatapos ng larawan:

\

Extension: link_attributes
Maaaring itakda ang mga katangian sa mga link at larawan:

Isang inline {#id .class width=30 height=20px}
at isang sanggunian ![image][ref] na may mga katangian.

[ref]: foo.jpg "opsyonal na pamagat" {#id .class key=val key2="val 2"}

(Ang syntax na ito ay tugma sa PHP Markdown Extra kapag #id at .class lang ang ginagamit.)

Para sa HTML at EPUB, lahat ng attribute maliban sa lapad at taas (ngunit kasama ang srcset at laki)
ay dumaan sa kung ano. Binabalewala ng ibang mga manunulat ang mga katangiang hindi sinusuportahan ng
kanilang output format.

Espesyal na tinatrato ang mga katangian ng lapad at taas sa mga larawan. Kapag ginamit nang walang a
unit, ang unit ay ipinapalagay na mga pixel. Gayunpaman, alinman sa mga sumusunod na unit identifier
maaaring gamitin: px, cm, mm, in, pulgada at %. Dapat ay walang anumang puwang sa pagitan ng numero
at ang unit. Halimbawa:

{ width=50% }

· Ang mga sukat ay kino-convert sa pulgada para sa output sa mga format na nakabatay sa pahina tulad ng LaTeX.
Kino-convert ang mga sukat sa mga pixel para sa output sa mga format na tulad ng HTML. Gamitin ang --dpi
opsyon upang tukuyin ang bilang ng mga pixel bawat pulgada. Ang default ay 96dpi.

· Ang % unit ay karaniwang nauugnay sa ilang available na espasyo. Halimbawa ang halimbawa sa itaas
ay magre-render sa (HTML),
\includegraphics[width=0.5\textwidth]{file.jpg} (LaTeX), o
\externalfigure[file.jpg][width=0.5\textwidth] (ConTeXt).

· Ang ilang mga format ng output ay may ideya ng isang klase (ConTeXt) o isang natatanging identifier (LaTeX
\caption), o pareho (HTML).

· Kapag walang tinukoy na mga katangian ng lapad o taas, ang fallback ay tingnan ang larawan
resolution at ang dpi metadata na naka-embed sa image file.

Mga talababa
Extension: footnote
Ang Pandoc's Markdown ay nagbibigay-daan sa mga footnote, gamit ang sumusunod na syntax:

Narito ang isang sanggunian sa talababa,[^1] at isa pa.[^longnote]

[^1]: Narito ang talababa.

[^longnote]: Narito ang isa na may maraming block.

Ang mga kasunod na talata ay naka-indent upang ipakita na sila
nabibilang sa nakaraang talababa.

{ some.code }

Maaaring naka-indent ang buong talata, o ang una lang
linya. Sa ganitong paraan, gumagana ang mga multi-paragraph footnote
mga item sa listahan ng maraming talata.

Ang talatang ito ay hindi magiging bahagi ng tala, dahil ito
ay hindi naka-indent.

Ang mga identifier sa mga sanggunian sa footnote ay maaaring hindi naglalaman ng mga puwang, tab, o bagong linya. Ang mga ito
ang mga identifier ay ginagamit lamang upang iugnay ang sanggunian sa talababa sa mismong tala; nasa
output, ang mga footnote ay bibigyan ng bilang nang sunud-sunod.

Ang mga footnote mismo ay hindi kailangang ilagay sa dulo ng dokumento. Maaaring lumitaw ang mga ito
kahit saan maliban sa loob ng iba pang mga elemento ng block (mga listahan, block quotes, mga talahanayan, atbp.).

Extension: inline_notes
Pinapayagan din ang mga inline na footnote (bagama't, hindi tulad ng mga regular na tala, hindi sila maaaring maglaman
maramihang talata). Ang syntax ay ang mga sumusunod:

Narito ang isang inline na tala.^[Ang mga tala ng inline ay mas madaling isulat, dahil
hindi mo na kailangang pumili ng isang identifier at ilipat pababa upang i-type ang
tandaan.]

Ang mga inline at regular na footnote ay maaaring malayang ihalo.

Mga Pagsipi
Extension: pagsipi
Gamit ang isang panlabas na filter, pandoc-citeproc, pandoc ay maaaring awtomatikong bumuo ng mga pagsipi at
isang bibliograpiya sa maraming istilo. Ang pangunahing paggamit ay

pandoc --filter pandoc-citeproc myinput.txt

Upang magamit ang feature na ito, kakailanganin mong tumukoy ng file ng bibliograpiya gamit ang
Bibliography metadata field sa isang YAML metadata section, o --bibliography command line
argumento. Maaari kang magbigay ng maramihang --bibliography na argumento o magtakda ng metadata ng bibliography
field sa YAML array, kung gusto mong gumamit ng maramihang bibliography file. Ang bibliograpiya ay maaaring
magkaroon ng alinman sa mga format na ito:

I-format ang extension ng file
─────────────────────────────
BibLaTeX .bib
BibTeX .bibtex
Copac .copac

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

Tandaan na ang .bib ay maaaring gamitin sa parehong BibTeX at BibLaTeX file; gumamit ng .bibtex para pilitin
BibTeX.

Tandaan na ang pandoc-citeproc --bib2json at pandoc-citeproc --bib2yaml ay maaaring gumawa ng .json at
Mga .yaml na file mula sa alinman sa mga sinusuportahang format.

In-field markup: Sa mga database ng BibTeX at BibLaTeX, ang pandoc-citeproc ay nag-parse ng isang subset ng
Markup ng LaTeX; sa mga database ng CSL YAML, pandoc Markdown; at sa mga database ng CSL JSON, isang
HTML-like markup:


italiko

...
matapang

style="font-variant:small-caps;">... or ...
maliliit na kapital

...
subskrip

...
superscript

class="nocase">...
pigilan ang isang parirala na ma-capitalize bilang title case

pandoc-citeproc -j at -y interconvert ang CSL JSON at CSL YAML na mga format hanggang sa
maaari.

Bilang alternatibo sa pagtukoy ng bibliography file gamit ang --bibliography o ang YAML
metadata field bibliography, maaari mong direktang isama ang data ng pagsipi sa mga sanggunian
field ng YAML metadata ng dokumento. Ang field ay dapat maglaman ng array ng YAML-encoded
mga sanggunian, halimbawa:

---
mga sanggunian:
- uri: artikulo-journal
id: WatsonCrick1953
may-akda:
- pamilya: Watson
ibinigay: JD
- pamilya: Crick
ibinigay: FHC
inisyu:
mga bahagi ng petsa:
- - 1953
- 4
- 25
pamagat: 'Molekular na istraktura ng mga nucleic acid: isang istraktura para sa deoxyribose
nucleic acid'
title-short: Molecular structure ng mga nucleic acid
container-title: Kalikasan
dami: 171
isyu: 4356
pahina: 737-738
DOI: 10.1038/171737a0
URL: http://www.nature.com/nature/journal/v171/n4356/abs/171737a0.html
wika: en-GB
...

(pandoc-citeproc --bib2yaml ay maaaring gumawa ng mga ito mula sa isang bibliography file sa isa sa
mga suportadong format.)

Maaaring ma-format ang mga pagsipi at sanggunian gamit ang anumang istilong sinusuportahan ng Estilo ng Pagsipi
Wika, na nakalista sa Zotero Style Repository. Ang mga file na ito ay tinukoy gamit ang
--csl na opsyon o ang csl metadata field. Bilang default, gagamitin ng pandoc-citeproc ang Chicago
Manual of Style author-date na format. Ang proyekto ng CSL ay nagbibigay ng karagdagang impormasyon sa
paghahanap at pag-edit ng mga istilo.

Upang gawing hyperlink ang iyong mga pagsipi sa kaukulang mga entry sa bibliograpiya, magdagdag
link-citation: totoo sa iyong YAML metadata.

Ang mga pagsipi ay nasa loob ng mga square bracket at pinaghihiwalay ng mga semicolon. Ang bawat pagsipi ay dapat
magkaroon ng key, na binubuo ng '@' + ang citation identifier mula sa database, at maaaring
opsyonal na mayroong prefix, locator, at suffix. Ang susi ng pagsipi ay dapat magsimula sa a
titik, digit, o _, at maaaring naglalaman ng mga alphanumeric, _, at panloob na mga bantas na character
(:.#$%&-+?<>~/). Narito ang ilang halimbawa:

Blah blah [tingnan ang @doe99, pp. 33-35; din @smith04, chap. 1].

Blah blah [@doe99, pp. 33-35, 38-39 at *passim*].

Blah blah [@smith04; @doe99].

Nakikita ng pandoc-citeproc ang mga termino ng tagahanap sa mga file ng lokal na CSL. Alinman sa dinaglat o
tinatanggap ang mga hindi pinaikling anyo. Sa en-US na lokal, maaaring isulat ang mga termino ng tagahanap
alinman sa isahan o pangmaramihang anyo, bilang aklat, bk./bks.; kabanata, chap./chaps.; hanay,
col./cols.; figure, fig./figs.; folio, fol./fols.; numero, no./nos.; linya, l./ll.; tandaan,
n./nn.; opus, op./opp.; pahina, p./pp.; talata, talata/paras.; bahagi, pt./pts.; seksyon,
sec./secs.; sub verbo, sv/s.vv.; taludtod, v./vv.; dami, vol./vols.; ¶/¶¶; §/§§. Kung hindi
locator term ay ginamit, "pahina" ay ipinapalagay.

Ang isang minus sign (-) bago ang @ ay pipigilan ang pagbanggit ng may-akda sa sipi. Ito
maaaring maging kapaki-pakinabang kapag nabanggit na ang may-akda sa teksto:

Sabi ni Smith blah [-@smith04].

Maaari ka ring magsulat ng in-text na pagsipi, tulad ng sumusunod:

Sabi ni @smith04 blah.

@smith04 [p. 33] sabi ni blah.

Kung ang istilo ay nangangailangan ng isang listahan ng mga gawang binanggit, ito ay ilalagay sa dulo ng
dokumento. Karaniwan, gugustuhin mong tapusin ang iyong dokumento gamit ang naaangkop na header:

huling talata...

# Mga Sanggunian

Ang bibliograpiya ay ilalagay pagkatapos ng header na ito. Tandaan na gagawin ng unnumbered class
idagdag sa header na ito, upang ang seksyon ay hindi mabilang.

Kung gusto mong isama ang mga bagay sa bibliograpiya nang hindi aktwal na binabanggit ang mga ito sa katawan
text, maaari mong tukuyin ang isang dummy nocite metadata field at ilagay ang mga pagsipi doon:

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

@item3

Sa halimbawang ito, ang dokumento ay maglalaman ng isang pagsipi para sa item3 lamang, ngunit ang bibliograpiya
ay maglalaman ng mga entry para sa item1, item2, at item3.

Para sa LaTeX o PDF na output, maaari mo ring gamitin ang natbib o biblatex upang mag-render ng bibliography. Sa
upang gawin ito, tukuyin ang mga file ng bibliograpiya tulad ng nakabalangkas sa itaas, at idagdag ang --natbib o
--biblatex argument sa pandoc invocation. Tandaan na ang mga file ng bibliograpiya ay dapat
sa kani-kanilang format (alinman sa BibTeX o BibLaTeX).

Para sa karagdagang impormasyon, tingnan ang pandoc-citeproc man page.

Hindi pandoc mga extension
Ang mga sumusunod na Markdown syntax extension ay hindi pinagana bilang default sa pandoc, ngunit maaaring
pinagana sa pamamagitan ng pagdaragdag ng +EXTENSION sa pangalan ng format, kung saan ang EXTENSION ay ang pangalan ng
extension. Kaya, halimbawa, ang markdown+hard_line_breaks ay Markdown na may hard line
masira

Extension: lists_without_preceding_blankline
Pahintulutan ang isang listahan na maganap pagkatapos ng isang talata, nang walang intervening na blangko na espasyo.

Extension: mga hard_line_break
Nagiging sanhi ng lahat ng mga bagong linya sa loob ng isang talata upang bigyang-kahulugan bilang mga hard line break sa halip na
mga puwang.

Extension: ignore_line_breaks
Nagiging sanhi ng pagbabalewala ng mga bagong linya sa loob ng isang talata, sa halip na ituring bilang mga puwang o
habang naputol ang matigas na linya. Ang opsyong ito ay inilaan para sa paggamit sa mga wika ng Silangang Asya kung saan
ang mga puwang ay hindi ginagamit sa pagitan ng mga salita, ngunit ang teksto ay nahahati sa mga linya para madaling mabasa.

Extension: east_asian_line_breaks
Nagiging sanhi ng pagbabalewala ng mga bagong linya sa loob ng isang talata, sa halip na ituring bilang mga puwang o
bilang matigas na linya break, kapag sila ay nangyari sa pagitan ng dalawang East Asian malawak na mga character. Ito ay
mas mahusay na pagpipilian kaysa sa ignore_line_breaks para sa mga text na may kasamang halo ng East Asian wide
mga tauhan at iba pang tauhan.

Extension: emoji
Pino-parse ang mga textual na emoji tulad ng :smile: bilang Unicode emoticon.

Extension: tex_math_single_backslash
Nagiging sanhi ng anumang bagay sa pagitan ng \( at \) na bigyang-kahulugan bilang inline na TeX math, at anuman
sa pagitan ng \[ at \] na bibigyang-kahulugan bilang display TeX math. Tandaan: isang sagabal nito
extension ay pinipigilan nito ang pagtakas ( at [.

Extension: tex_math_double_backslash
Nagiging sanhi ng anumang bagay sa pagitan ng \\( at \\) na bigyang-kahulugan bilang inline na TeX math, at anuman
sa pagitan ng \\[ at \\] na ituturing bilang display TeX math.

Extension: markdown_attribute
Bilang default, binibigyang-kahulugan ng pandoc ang materyal sa loob ng mga block-level na tag bilang Markdown. Ito
Binabago ng extension ang gawi upang ang Markdown ay na-parse lang sa loob ng mga block-level na tag kung
ang mga tag ay may attribute markdown=1.

Extension: mmd_title_block
Pinapagana ang isang bloke ng pamagat na istilo ng MultiMarkdown sa tuktok ng dokumento, halimbawa:

Pamagat: Pamagat ko
May-akda: John Doe
Petsa: Setyembre 1, 2008
Komento: Ito ay isang sample na mmd title block, na may
isang field na sumasaklaw sa maraming linya.

Tingnan ang dokumentasyon ng MultiMarkdown para sa mga detalye. Kung pandoc_title_block o
Ang yaml_metadata_block ay pinagana, ito ay mauuna kaysa sa mmd_title_block.

Extension: mga pagdadaglat
Pina-parse ang PHP Markdown Mga karagdagang abbreviation key, tulad ng

*[HTML]: Hypertext Markup Language

Tandaan na ang pandoc document model ay hindi sumusuporta sa mga pagdadaglat, kaya kung ang extension na ito
ay pinagana, ang mga abbreviation key ay nilalaktawan lamang (kumpara sa pag-parse bilang
mga talata).

Extension: autolink_bare_uris
Ginagawang mga link ang lahat ng ganap na URI, kahit na hindi napapalibutan ng mga pointy brace <...>.

Extension: ascii_identifiers
Nagiging purong ASCII ang mga identifier na ginawa ng mga auto_identifier. Ang mga accent ay
inalis ang mga titik na latin, at ang mga hindi latin na titik ay tinanggal.

Extension: mmd_link_attributes
Pino-parse ang mga katangian ng key-value ng istilong multimarkdown sa link at mga sanggunian ng larawan. Ito
hindi dapat malito ang extension sa link_attributes extension.

Isa itong sanggunian ![image][ref] na may mga katangiang multimarkdown.

[ref]: http://path.to/image "Pamagat ng larawan" width=20px height=30px
id=myId class="myClass1 myClass2"

Extension: mmd_header_identifiers
Pino-parse ang mga multimarkdown style header identifier (sa mga square bracket, pagkatapos ng header ngunit
bago ang anumang trailing #s sa isang ATX header).

Extension: compact_definition_lists
Ina-activate ang syntax ng listahan ng kahulugan ng pandoc 1.12.x at mas maaga. Magkaiba ang syntax na ito
mula sa inilarawan sa itaas sa ilalim ng mga listahan ng Depinisyon sa ilang aspeto:

· Walang blangko na linya ang kinakailangan sa pagitan ng magkakasunod na item ng listahan ng kahulugan.

· Upang makakuha ng "masikip" o "compact" na listahan, alisin ang espasyo sa pagitan ng magkakasunod na item; ang puwang
sa pagitan ng isang termino at kahulugan nito ay hindi nakakaapekto sa anuman.

· Ang tamad na pagbabalot ng mga talata ay hindi pinapayagan: ang buong kahulugan ay dapat na naka-indent sa apat
mga puwang.

Markdown variant
Bilang karagdagan sa pinahabang Markdown ng pandoc, sinusuportahan ang mga sumusunod na variant ng Markdown:

markdown_phpextra (PHP Markdown Dagdag)
footnote, pipe_tables, raw_html, markdown_attribute, fenced_code_blocks,
definition_lists, intraword_underscore, header_attributes, link_attributes,
mga pagdadaglat, shortcut_reference_links.

markdown_github (GitHub-Flavored Markdown)
pipe_tables, raw_html, tex_math_single_backslash, fenced_code_blocks,
auto_identifiers, ascii_identifiers, backtick_code_blocks, autolink_bare_uris,
intraword_underscore, strikeout, hard_line_breaks, emoji,
shortcut_reference_links.

markdown_mmd (MultiMarkdown)
pipe_tables raw_html, markdown_attribute, mmd_link_attributes, raw_tex,
tex_math_double_backslash, intraword_underscores, mmd_title_block, footnote,
definition_lists, all_symbols_escapable, implicit_header_references,
auto_identifiers, mmd_header_identifiers, shortcut_reference_links.

markdown_strict (Markdown.pl)
raw_html

Extension sa format iba kaysa Markdown
Ang ilan sa mga extension na tinalakay sa itaas ay maaaring gamitin sa mga format maliban sa Markdown:

· Ang mga auto_identifier ay maaaring gamitin sa latex, una, mediawiki, at textile input (at ginagamit
bilang default).

· Maaaring gamitin ang tex_math_dollars, tex_math_single_backslash, at tex_math_double_backslash
gamit ang html input. (Ito ay madaling gamitin para sa pagbabasa ng mga web page na naka-format gamit ang MathJax, para sa
halimbawa.)

PAGGAWA Padausdusin IPAKITA SA PANDOC

Maaari mong gamitin ang pandoc upang makagawa ng HTML + javascript slide presentation na maaaring matingnan
sa pamamagitan ng isang web browser. Mayroong limang paraan para gawin ito, gamit ang S5, DZSlides, Slidy, Slideous,
o ihayag.js. Maaari ka ring gumawa ng PDF slide show gamit ang LaTeX beamer.

Narito ang Markdown source para sa isang simpleng slide show, habits.txt:

% Mga gawi
% John Doe
% Marso 22, 2005

# Sa umaga

## Pagbangon

- I-off ang alarm
- Bumangon ka na

## Almusal

- Kumain ng itlog
- Uminom ng kape

# Sa gabi

## Hapunan

- Kumain ng spaghetti
- Uminom ng alak

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


## Matutulog na

- Humiga ka sa kama
- Magbilang ng mga tupa

Para makagawa ng HTML/javascript slide show, i-type lang

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

kung saan ang FORMAT ay alinman sa s5, slidy, slideous, dzslides, o revealjs.

Para sa Slidy, Slideous, reveal.js, at S5, ang file na ginawa ng pandoc na may
-s/--standalone na opsyon ay nag-embed ng isang link sa mga javascript at CSS file, na ipinapalagay na
available sa relative path na s5/default (para sa S5), slideous (para sa Slideous), reveal.js
(para sa reveal.js), o sa Slidy website sa w3.org (para sa Slidy). (Ang mga landas na ito ay maaaring
binago sa pamamagitan ng pagtatakda ng mga variable na slidy-url, slideous-url, revealjs-url, o s5-url; tingnan mo
Mga variable para sa mga slide, sa itaas.) Para sa DZSlides, ang (medyo maikli) javascript at css ay
kasama sa file bilang default.

Sa lahat ng mga format ng HTML slide, ang --self-contained na opsyon ay maaaring gamitin upang makagawa ng isang solong
file na naglalaman ng lahat ng data na kinakailangan upang ipakita ang slide show, kabilang ang naka-link
mga script, stylesheet, larawan, at video.

Para makagawa ng PDF slide show gamit ang beamer, i-type

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

Tandaan na ang isang reveal.js slide show ay maaari ding i-convert sa isang PDF sa pamamagitan ng pag-print nito sa isang file
mula sa browser.

Pag-istruktura ang padausdusin Ipakita
Sa pamamagitan ng default, ang padausdusin antas ay ang pinakamataas na antas ng header sa hierarchy na sinusunod
kaagad ayon sa nilalaman, at hindi isa pang header, sa isang lugar sa dokumento. Sa halimbawa
sa itaas, ang mga header ng level 1 ay palaging sinusundan ng mga header ng level 2, na sinusundan ng
nilalaman, kaya 2 ang antas ng slide. Maaaring ma-override ang default na ito gamit ang --slide-level
pagpipilian.

Ang dokumento ay inukit sa mga slide ayon sa mga sumusunod na patakaran:

· Ang isang pahalang na panuntunan ay palaging nagsisimula ng isang bagong slide.

· Ang isang header sa antas ng slide ay palaging nagsisimula ng isang bagong slide.

· Mga header sa ibaba ang antas ng slide sa hierarchy ay lumikha ng mga header sa loob ng isang slide.

· Mga header sa itaas ang antas ng slide sa hierarchy ay lumikha ng "mga slide ng pamagat," na naglalaman lang
ang pamagat ng seksyon at tulong na hatiin ang slide show sa mga seksyon.

· Ang isang pahina ng pamagat ay awtomatikong binuo mula sa bloke ng pamagat ng dokumento, kung mayroon.
(Sa kaso ng beamer, maaari itong i-disable sa pamamagitan ng pagkomento ng ilang linya sa default
template.)

Idinisenyo ang mga panuntunang ito upang suportahan ang maraming iba't ibang istilo ng slide show. Kung hindi mo gagawin
pag-aalaga tungkol sa pagbuo ng iyong mga slide sa mga seksyon at subsection, maaari mo lamang gamitin ang antas 1
mga header para sa lahat ng bawat slide. (Kung ganoon, ang level 1 ang magiging antas ng slide.) Ngunit magagawa mo
buuin din ang slide show sa mga seksyon, tulad ng sa halimbawa sa itaas.

Tandaan: sa mga slide show ng reveal.js, kung 2 ang antas ng slide, magkakaroon ng two-dimensional na layout
ginawa, na may antas 1 na mga header na ginagawa nang pahalang at antas 2 na mga header na gusali
patayo. Hindi inirerekomenda na gumamit ka ng mas malalim na pagpupugad ng mga antas ng seksyon na may
reveal.js.

Incremental mga listahan
Bilang default, ang mga manunulat na ito ay gumagawa ng mga listahan na nagpapakita ng "sabay-sabay." Kung gusto mo ang iyong mga listahan
upang ipakita ang incrementally (isang item sa isang pagkakataon), gamitin ang -i na opsyon. Kung gusto mo a
partikular na listahan na aalis mula sa default (iyon ay, upang ipakita nang paunti-unti nang walang
-i na opsyon at sabay-sabay sa -i na opsyon), ilagay ito sa isang block quote:

> - Kumain ng spaghetti
> - Uminom ng alak

Sa ganitong paraan, ang mga incremental at nonincremental na listahan ay maaaring ihalo sa isang dokumento.

Pagpasok break
Maaari kang magdagdag ng "pause" sa loob ng isang slide sa pamamagitan ng pagsasama ng isang talata na naglalaman ng tatlong tuldok,
pinaghihiwalay ng mga puwang:

# I-slide nang may pause

nilalaman bago ang paghinto

. . .

nilalaman pagkatapos ng pag-pause

Styling ang slide
Maaari mong baguhin ang istilo ng mga HTML slide sa pamamagitan ng paglalagay ng mga customized na CSS file
$DATADIR/s5/default (para sa S5), $DATADIR/slidy (para sa Slidy), o $DATADIR/slideous (para sa
Slideous), kung saan ang $DATADIR ay ang direktoryo ng data ng user (tingnan ang --data-dir, sa itaas). Ang
ang mga orihinal ay maaaring matagpuan sa direktoryo ng data ng system ng pandoc (sa pangkalahatan
$CABALDIR/pandoc-VERSION/s5/default). Hahanapin ng Pandoc doon ang anumang mga file na hindi nito
hanapin sa direktoryo ng data ng gumagamit.

Para sa mga dzslide, ang CSS ay kasama sa HTML file mismo, at maaaring mabago doon.

Ang lahat ng mga opsyon sa configuration ng reveal.js ay maaaring itakda sa pamamagitan ng mga variable. Halimbawa, maaari ang mga tema
gamitin sa pamamagitan ng pagtatakda ng variable ng tema:

-V theme=buwan

O maaari kang tumukoy ng custom na stylesheet gamit ang --css na opsyon.

Upang mag-istilo ng mga slide ng beamer, maaari kang tumukoy ng tema, colortheme, fonttheme, innertheme, at
panlabas na tema, gamit ang -V na opsyon:

pandoc -t beamer habits.txt -V theme:Warsaw -o habits.pdf

Tandaan na ang mga katangian ng header ay magiging mga katangian ng slide (sa a o ) sa
Mga format ng HTML slide, na nagbibigay-daan sa iyong mag-istilo ng mga indibidwal na slide. Sa beamer, ang tanging header
attribute na nakakaapekto sa mga slide ay ang allowframebreaks class, na nagtatakda ng
allowframebreaks opsyon, na nagiging sanhi ng maraming mga slide na malikha kung ang nilalaman ay napuno
ang kwadro. Inirerekomenda ito lalo na para sa mga bibliograpiya:

# Mga Sanggunian {.allowframebreaks}

Nagsasalita mga tala
Ang reveal.js ay may magandang suporta para sa mga tala ng tagapagsalita. Maaari kang magdagdag ng mga tala sa iyong Markdown na dokumento
kaya:


Ito ang aking tala.

- Maaari itong maglaman ng Markdown
- tulad ng listahang ito



Upang ipakita ang window ng mga tala, pindutin ang s habang tinitingnan ang presentasyon. Ang mga tala ay wala pa
suportado para sa iba pang mga format ng slide, ngunit ang mga tala ay hindi lalabas sa mga slide mismo.

Balangkas mga katangian in projector
Minsan kinakailangan na idagdag ang LaTeX [fragile] na opsyon sa isang frame sa beamer (para sa
halimbawa, kapag ginagamit ang minted na kapaligiran). Ito ay maaaring pilitin sa pamamagitan ng pagdaragdag ng marupok
klase sa header na nagpapakilala sa slide:

# Fragile slide {.fragile}

Ang lahat ng iba pang mga katangian ng frame na inilarawan sa Seksyon 8.1 ng Gabay sa Gumagamit ng Beamer ay maaaring
magagamit din: allowdisplaybreaks, allowframebreaks, b, c, t, environment, label, plain,
pag-urong

PAGLIKHA EPUBS SA PANDOC

EPUB metadata
Maaaring tukuyin ang metadata ng EPUB gamit ang --epub-metadata na opsyon, ngunit kung ang pinagmulan
Ang dokumento ay Markdown, mas mainam na gumamit ng YAML metadata block. Narito ang isang halimbawa:

---
pamagat:
- uri: pangunahing
teksto: Aking Aklat
- uri: subtitle
text: Isang pagsisiyasat ng metadata
tagalikha:
- tungkulin: may-akda
teksto: John Smith
- tungkulin: editor
teksto: Sarah Jones
identifier:
- scheme: DOI
teksto: doi:10.234234.234/33
publisher: My Press
mga karapatan: © 2007 John Smith, CC BY-NC
...

Ang mga sumusunod na field ay kinikilala:

pantukoy
Alinman sa isang string value o isang object na may mga field na text at scheme. Mga wastong halaga para sa
ang scheme ay ISBN-10, GTIN-13, UPC, ISMN-10, DOI, LCCN, GTIN-14, ISBN-13,
Numero ng legal na deposito, URN, OCLC, ISMN-13, ISBN-A, JP, OLCC.

pamagat Alinman sa isang string na halaga, o isang bagay na may mga field na file-as at uri, o isang listahan ng ganoon
mga bagay. Ang mga wastong halaga para sa uri ay pangunahin, subtitle, maikli, koleksyon, edisyon,
pinahaba

lumikha
Alinman sa isang string value, o isang object na may mga field na papel, file-as, at text, o isang listahan
ng naturang mga bagay. Ang mga wastong halaga para sa tungkulin ay mga relator ng MARC, ngunit susubukan ng pandoc
upang isalin ang mga bersyon na nababasa ng tao (tulad ng "may-akda" at "editor") sa
angkop na marc relators.

contributor
Parehong format ng creator.

petsa Isang string value sa YYYY-MM-DD na format. (Taon lang ang kailangan.) Pandoc will
subukang i-convert ang iba pang karaniwang mga format ng petsa.

lang (O pamana: wika)
Isang string value sa BCP 47 na format. Magde-default ang Pandoc sa lokal na wika kung
walang tinukoy.

paksa
Isang string value o isang listahan ng mga ganoong value.

paglalarawan
Isang string na halaga.

uri Isang string na halaga.

format Isang string na halaga.

kaugnayan
Isang string na halaga.

coverage
Isang string na halaga.

karapatan Isang string na halaga.

cover-image
Isang string value (path to cover image).

stylesheet
Isang string value (path sa CSS stylesheet).

page-progression-direction
Alinman sa ltr o rtl. Tinutukoy ang katangian ng page-progression-direction para sa
elemento ng gulugod.

Linked media
Bilang default, magda-download ang pandoc ng naka-link na media (kabilang ang audio at video) at isasama ito
sa lalagyan ng EPUB, na nagbubunga ng ganap na self-contained na EPUB. Kung gusto mong mag-link sa
sa halip, gumamit ng raw HTML sa iyong source at magdagdag ng data-external="1" sa
ang tag na may katangiang src. Halimbawa:


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

LITERATE HASKELL SUPORTA

Kung idaragdag mo ang +lhs (o +literate_haskell) sa isang naaangkop na format ng input o output
(markdown, markdown_strict, una, o latex para sa input o output; beamer, html o html5 para sa
output lang), ituturing ng pandoc ang dokumento bilang literate na Haskell source. Ibig sabihin nito

· Sa Markdown input, ang mga seksyong "track ng ibon" ay i-parse bilang Haskell code sa halip na
harangan ang mga sipi. Ang teksto sa pagitan ng \begin{code} at \end{code} ay ituturing din bilang
Haskell code. Para sa ATX-style na mga header ang character na '=' ay gagamitin sa halip na '#'.

· Sa Markdown na output, ang mga bloke ng code na may mga klase na haskell at literate ay ire-render gamit
Ang mga track ng ibon, at ang mga block quotation ay ilalagay sa isang puwang, kaya hindi ito magiging
itinuturing bilang Haskell code. Bilang karagdagan, ang mga header ay ire-render na setext-style (na may
salungguhit) sa halip na ATX-style (na may '#' na mga character). (Ito ay dahil ang ghc treats
'#' na mga character sa column 1 bilang nagpapakilala sa mga numero ng linya.)

· Sa restructured text input, ang mga seksyong "track ng ibon" ay i-parse bilang Haskell code.

· Sa restructured text output, ang mga bloke ng code na may class haskell ay ire-render gamit ang bird
mga track.

· Sa input ng LaTeX, ang text sa mga environment ng code ay mapapa-parse bilang Haskell code.

· Sa LaTeX output, ang mga bloke ng code na may class haskell ay ire-render sa loob ng code
mga kapaligiran.

· Sa HTML na output, ang mga bloke ng code na may class haskell ay ire-render kasama ng klase
literatehaskell at mga track ng ibon.

Halimbawa:

pandoc -f markdown+lhs -t html

nagbabasa ng literate na Haskell source na naka-format sa Markdown convention at nagsusulat ng ordinaryong HTML
(walang mga track ng ibon).

pandoc -f markdown+lhs -t html+lhs

nagsusulat ng HTML gamit ang Haskell code sa mga track ng ibon, upang maaari itong kopyahin at i-paste bilang
literate Haskell source.

SINTAX NAPAPALAKASAN

Awtomatikong iha-highlight ng Pandoc ang syntax sa nabakuran na mga bloke ng code na minarkahan ng a
pangalan ng wika. Ang Haskell library highlighting-kate ay ginagamit para sa pag-highlight, na
gumagana sa HTML, Docx, at LaTeX/PDF na output. Maaaring piliin ang scheme ng kulay gamit ang
--highlight-style na opsyon. Ang default na scheme ng kulay ay mga pygment, na ginagaya ang
default na scheme ng kulay na ginagamit ng mga pygment sa library ng Python, ngunit hindi talaga ang mga pygment
ginagamit upang gawin ang pag-highlight.

Upang makakita ng listahan ng mga pangalan ng wika na makikilala ng pandoc, i-type ang pandoc --version.

Upang huwag paganahin ang pag-highlight, gamitin ang --no-highlight na opsyon.

CUSTOM MGA MANUNULAT

Maaaring palawigin ang Pandoc gamit ang mga custom na manunulat na nakasulat sa lua. (Kasama ng Pandoc ang lua
interpreter, kaya hindi kailangang i-install nang hiwalay ang lua.)

Para gumamit ng custom na manunulat, tukuyin lang ang path sa lua script bilang kapalit ng output
pormat. Halimbawa:

pandoc -t data/sample.lua

Ang paglikha ng isang custom na manunulat ay nangangailangan ng pagsulat ng isang function na lua para sa bawat posibleng elemento sa a
pandoc na dokumento. Upang makakuha ng isang dokumentadong halimbawa na maaari mong baguhin ayon sa iyong
kailangan, gawin

pandoc --print-default-data-file sample.lua

MGA AUTHORS

© 2006-2015 John MacFarlane ([protektado ng email]). Inilabas sa ilalim ng GPL, bersyon 2 o
mas malaki. Ang software na ito ay walang anumang uri ng warranty. (Tingnan ang COPYRIGHT para sa buo
copyright at warranty notice.)

Kasama sa mga nag-ambag sina 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, infinity0x,
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, at Xavier Olive.

Ang Pandoc source code at lahat ng dokumentasyon ay maaaring ma-download mula sahttp://pandoc.org>.

Gumamit ng pandoc online gamit ang mga serbisyo ng onworks.net