pandoc(1) Pandoc pandoc(1) (NAME) pandoc - (SYNOPSIS) pandoc [options] [input-file]... (DESCRIPTION) Pandoc Haskell . Pandoc Markdown HTML LaTeX Word docx. --from --to . Pandoc PDF : << PDF>> . Markdown Pandoc . < Pandoc>> . Pandoc : (readers) ( abstract syntax tree AST) (writers) . reader writer . pandoc AST . pandoc . Pandoc . pandoc . Markdown pandoc Markdown pandoc (lossy) . pandoc input-files stdin . stdout . -o/--output : pandoc -o output.html input.txt pandoc (fragment) . ( HTML ) -s --standalone : pandoc -s -o output.html input.txt << (Templates)>> . pandoc ( ) . ( --file-scope .) . -f/--from -t/--to . hello.txt Markdown LaTeX : pandoc -f markdown -t latex hello.txt hello.html HTML Markdown: pandoc -f html -t markdown hello.html <<>> ( -f -t ). pandoc --list-input-formats pandoc --list-output-formats . pandoc . pandoc -o hello.tex hello.txt hello.txt Markdown LaTeX . ( stdout ) HTML . ( stdin ) Markdown . Pandoc UTF-8 . UTF-8 iconv : iconv -t utf-8 input.txt | pandoc | iconv -f utf-8 ( HTML LaTeX ConTeXt RTF OPML DocBook Texinfo) -s/--standalone . PDF PDF .pdf : pandoc test.txt -o test.pdf pandoc LaTeX PDF LaTeX ( --pdf-engine ). pandoc ConTeXt roff ms HTML . .pdf --pdf-engine -t context -t html -t ms . PDF --pdf-engine . PDF : LaTeX ConTeXt wkhtmltopdf ms . HTML --css . PDF : -o test.pdf -s -o test.tex LaTeX . pdflatex test.tex . LaTeX ( TeX Live ): amsfonts amsmath lm unicode-math iftex listings ( --listings ) fancyvrb longtable caption booktabs multirow ( ) graphicx ( ) bookmark xcolor soul geometry ( geometry) setspace ( linestretch) babel ( lang). CJKmainfont xelatex xeCJK lualatex luatexja . framed . xelatex lualatex PDF fontspec . lualatex selnolig lua-ul . xelatex bidi ( dir) . mathspec xelatex unicode-math mathspec . csquotes (true) csquotes . natbib biblatex bibtex biber . \cancel \bcancel \xcancel cancel . pandoc : upquote ( verbatim) microtype ( ) parskip ( ) xurl ( ) footnotehyper footnote ( )..SS (Reading from the Web) URI . pandoc HTTP : pandoc -f html -t markdown https://www.fsf.org URL User-Agent : pandoc -f html -t markdown --request-header User-Agent:"Mozilla/5.0" \ https://www.fsf.org (OPTIONS) (General options) -f FORMAT, -r FORMAT, --from=FORMAT, --read=FORMAT . FORMAT : o asciidoc ( AsciiDoc) o bibtex ( BibTeX) o biblatex ( BibLaTeX) o bits (BITS XML jats) o commonmark ( CommonMark) o commonmark_x ( CommonMark ) o creole (Creole 1.0) o csljson ( CSL JSON) o csv ( CSV) o tsv ( TSV) o djot ( Djot) o docbook (DocBook) o docx (Word docx) o dokuwiki ( DokuWiki) o endnotexml ( EndNote XML) o epub (EPUB) o fb2 ( FictionBook2) o gfm ( - GitHub-Flavored Markdown) markdown_github markdown_github gfm . o haddock ( Haddock) o html (HTML) o ipynb ( Jupyter) o jats (JATS XML) o jira ( Jira/Confluence) o json ( JSON AST ) o latex (LaTeX) o markdown ( Pandoc) o markdown_mmd (MultiMarkdown) o markdown_phpextra (PHP Markdown Extra) o markdown_strict ( ) o mediawiki ( MediaWiki) o man (roff man) o mdoc ( mdoc) o muse (Muse) o native (Haskell ) o odt ( OpenDocument) o opml (OPML) o org ( Emacs Org) o pod (Plain Old Documentation Perl) o pptx (PowerPoint) o ris ( RIS) o rtf (Rich Text Format) o rst (reStructuredText) o t2t (txt2tags) o textile (Textile) o tikiwiki ( TikiWiki) o twiki ( TWiki) o typst (typst) o vimwiki (Vimwiki) o xlsx ( Excel) o xml ( XML AST ) o Lua << >> +EXTENSION -EXTENSION . <<>> . --list-input-formats --list-extensions . -t FORMAT, -w FORMAT, --to=FORMAT, --write=FORMAT . FORMAT : o ansi ( ANSI ) o asciidoc ( AsciiDoc Asciidoctor) o asciidoc_legacy (AsciiDoc asciidoc-py). o asciidoctor ( asciidoc) o bbcode BBCode o bbcode_fluxbb BBCode (FluxBB) o bbcode_phpbb BBCode (phpBB) o bbcode_steam BBCode (Steam) o bbcode_hubzilla BBCode (Hubzilla) o bbcode_xenforo BBCode (xenForo) o beamer ( LaTeX beamer) o bibtex ( BibTeX) o biblatex ( BibLaTeX) o chunkedhtml ( zip HTML ) o commonmark ( CommonMark) o commonmark_x ( CommonMark ) o context (ConTeXt) o csljson ( CSL JSON) o djot ( Djot) o docbook docbook4 (DocBook 4) o docbook5 (DocBook 5) o docx (Word docx) o dokuwiki ( DokuWiki) o epub epub3 ( EPUB v3) o epub2 (EPUB v2) o fb2 ( FictionBook2) o gfm ( - GitHub-Flavored Markdown) markdown_github markdown_github gfm . o haddock ( Haddock) o html html5 (HTML HTML5/XHTML).IP o 2 html4 (XHTML 1.0 Transitional) o icml (InDesign ICML) o ipynb ( Jupyter) o jats_archiving (JATS XML ) o jats_articleauthoring (JATS XML ) o jats_publishing (JATS XML ) o jats ( jats_archiving) o jira ( Jira/Confluence) o json ( JSON AST ) o latex (LaTeX) o man (roff man) o markdown ( pandoc) o markdown_mmd (MultiMarkdown) o markdown_phpextra (PHP Markdown Extra) o markdown_strict ( ) o markua (Markua) o mediawiki ( MediaWiki) o ms (roff ms) o muse (Muse) o native (Haskell ) o odt ( OpenDocument) o opml (OPML) o opendocument (OpenDocument XML) o org ( Emacs Org) o pdf (PDF) o plain ( ) o pptx ( PowerPoint) o rst (reStructuredText) o rtf (Rich Text Format) o texinfo (GNU Texinfo) o textile (Textile) o t2t (txt2tags) o slideous ( HTML JavaScript Slideous) o slidy ( HTML JavaScript Slidy) o dzslides ( HTML5 + JavaScript DZSlides) o revealjs ( HTML5 + JavaScript reveal.js) o s5 ( HTML JavaScript S5) o tei (TEI Simple) o typst (typst) o vimdoc (Vimdoc) o xml ( XML AST ) o xwiki ( XWiki) o zimwiki ( ZimWiki) o writer Lua <> odt docx epub pdf stdout -o - . +EXTENSION -EXTENSION . Extensions . --list-output-formats --list-extensions . -o FILE, --output=FILE FILE stdout. FILE - stdout (docx odt epub2 epub3) . chunkedhtml FILE pandoc .zip FILE zip ( FILE ). --data-dir=DIRECTORY pandoc. . *nix macOS pandoc XDG ( $HOME/.local/share XDG_DATA_HOME ). $HOME/.pandoc ( ). %APPDATA%\pandoc . pandoc --version . ( reference.odt reference.docx epub.css templates) pandoc . ( pandoc .) -d FILE, --defaults=FILE . FILE YAML JSON . . defaults ( --data-dir) . FILE pandoc .yaml . Defaults files . . --bash-completion bash. bash pandoc .bashrc : eval "$(pandoc --bash-completion)" --sandbox[=true|false] pandoc (sandbox) IO reader writer . IO PDF . include . pandoc . : reader writer ( docx) . pandoc --sandbox . pandoc embed_data_files . --verbose (). --quiet . --fail-if-warnings[=true|false] . --log=FILE JSON FILE. DEBUG (--verbose --quiet) . --list-input-formats . --list-output-formats . --list-extensions[=FORMAT] FORMAT + - FORMAT . FORMAT pandoc ..TP --list-highlight-languages . --list-highlight-styles . --syntax-highlighting . -v, --version . -h, --help . (Reader options) --shift-heading-level-by=NUMBER . --shift-heading-level-by=-1 . . : -N N (metadata title) . --shift-heading-level-by=-1 HTML Markdown . --shift-heading-level-by=1 Markdown HTML pandoc . --base-header-level=NUMBER . --shift-heading-level-by=X X = NUMBER - 1 . ( ). --indented-code-classes=CLASSES -- perl,numberLines haskell. . --default-image-extension=EXTENSION URL . . Markdown LaTeX . --file-scope[=true|false] . . . (docx odt epub) --file-scope . --file-scope . foo subdir/file1.txt subdir__file1.txt__foo . -F PROGRAM, --filter=PROGRAM AST pandoc . JSON stdin JSON stdout . JSON JSON pandoc . . pandoc --filter ./caps.py -t latex : pandoc -t json | ./caps.py latex | pandoc -f json -t latex . . Text.Pandoc.JSON toJSONFilter Haskell . python pandocfilters PyPI . pandoc PHP perl JavaScript/node.js . pandoc : 1. ( ) 2. $DATADIR/filters ( ) $DATADIR ( --data-dir ) 3. $PATH ( ). Lua citeproc . -L SCRIPT, --lua-filter=SCRIPT JSON ( --filter ) Lua pandoc. Lua Lua . Lua AST . Lua pandoc . Lua . Lua . pandoc Lua : 1. 2. $DATADIR/filters $DATADIR ( --data-dir ). Lua citeproc . -M KEY[=VAL], --metadata=KEY[:VAL] KEY VAL. YAML . YAML . Boolean true . --variable --metadata . --variable --metadata ( ) . --metadata-file=FILE YAML ( JSON) . Markdown . ( Markdown Markdown Markdown pandoc .) . -M . metadata ( --data-dir ). -p, --preserve-tabs[=true|false] (tabs) (spaces). ( pandoc .) (literal code spans) . . --tab-stop=NUMBER ( ). --track-changes=accept|reject|all "Track Changes" MS Word . accept () . reject . accept reject . all span insertion deletion comment-start comment-end . . all : . track-changes=all span paragraph-insertion/paragraph-deletion . docx . --extract-media=DIR|FILE.zip DIR . ( docx) . .. . SHA1 . .zip pandoc zip . --abbreviations=FILE . pandoc abbreviations . pandoc --print-default-data-file=abbreviations . pandoc Markdown . (nonbreaking space) LaTeX . . --typst-input=KEY[=VAL] --input typst sys.inputs typst . KEY VAL : = . . --trace[=true|false] stderr . . (General writer options) -s, --standalone ( HTML LaTeX TEI RTF ). pdf epub epub3 fb2 docx odt . native . --template=FILE|URL . --standalone . <<>> (Templates) . pandoc templates ( --data-dir ). pandoc (writer) --template=special HTML special.html . ( -D/--print-default-template ). -V KEY[=VAL], --variable=KEY[=VAL] (standalone) KEY VAL . KEY VAL : = . VAL true . ( ) variables --variable-json . list . . -V author=Joe -V author=Sue author : Joe Sue. --variable-json=KEY[=JSON] KEY JSON ( ). --variable-json foo=false foo false --variable-json foo='"false"' "false" . KEY VAL : = . . -D FORMAT, --print-default-template=FORMAT FORMAT . ( FORMAT -t .) . -o/--output -o/--output --print-default-template . (partials) styles.html. --print-default-data-file : --print-default-data-file=templates/styles.html. --print-default-data-file=FILE . . -o/--output -o/--output --print-default-data-file . --eol=crlf|lf|native : crlf () lf (//) native ( pandoc ). native . --dpi=NUMBER dpi ( ) / . ( ppi : ). 96dpi . dpi . --wrap=auto|none|preserve (wrap) ( ). auto () pandoc --columns ( 72). none pandoc . preserve pandoc ( ). ipynb Markdown . --columns=NUMBER . ( --wrap ). ( <<>> ). --toc[=true|false], --table-of-contents[=true|false] ( latex context docx odt opendocument rst ms ) . -s/--standalone man docbook4 docbook5 jats . PDF ms groff () --pdf-engine . --pdf-engine=pdfroff . auto_identifiers ( typst). --toc-depth=NUMBER . 3 ( ). --lof[=true|false], --list-of-figures[=true|false] ( ) . -s/--standalone latex context docx . --lot[=true|false], --list-of-tables[=true|false] ( ) . -s/--standalone latex context docx . --strip-comments[=true|false] HTML Markdown Textile HTML Markdown Textile HTML . markdown_in_html_blocks HTML HTML . --syntax-highlighting=default|none|idiomatic|STYLE|FILE (syntax highlighting) . STYLE KDE . idiomatic ( ) ( ) . none . default . HTML EPUB Docx Ms Man LaTeX Typst Typst . pygments () kate monochrome breezeDark espresso zenburn haddock tango. pandoc . : --list-highlight-styles. STYLE JSON .theme . KDE ( ) . JSON --print-highlight-style . --no-highlight --syntax-highlighting=none . . --highlight-style=STYLE|FILE --syntax-highlighting=STYLE|FILE . . --print-highlight-style=STYLE|FILE JSON .theme --syntax-highlighting . -o/--output -o/--output --print-highlight-style . --syntax-definition=FILE pandoc KDE XML . . . -H FILE, --include-in-header=FILE|URL FILE (verbatim) () . CSS JavaScript HTML . . . --standalone . -B FILE, --include-before-body=FILE|URL FILE ( HTML \begin{document} LaTeX). HTML . . . --standalone . odt OpenDocument XML docx OpenXML . -A FILE, --include-after-body=FILE|URL FILE ( HTML \end{document} LaTeX). . . --standalone . odt OpenDocument XML docx OpenXML . --resource-path=SEARCHPATH . Linux UNIX macOS : Windows ; . --resource-path . --resource-path . : --resource-path=.:test test . . --resource-path foo:bar --resource-path baz:bim --resource-path baz:bim:foo:bar . pandoc ( PDF docx --embed-resources ). ( pandoc LaTeX HTML ) . --request-header=NAME:VAL HTTP ( URL ) NAME VAL . http_proxy http://... . --no-check-certificate[=true|false] HTTP ( )..SS --self-contained[=true|false] --embed-resources --standalone. --embed-resources[=true|false] HTML (standalone) URI data: . "" (self-contained) . HTML html4 html5 html+lhs html5+lhs s5 slidy slideous dzslides revealjs. URL URL ( ) URL ( ) . data-external="1" . : JavaScript --mathjax ( ) "" reveal.js . SVG img URI data: inline-svg SVG . SVG . --link-images[=true|false] ODT. ( ODT .) --html-q-tags[=true|false] HTML. ( smart .) --ascii[=true|false] ASCII . XML HTML ( UTF-8 ) CommonMark gfm Markdown ( ) roff man ms ( ) LaTeX ( ) . --reference-links[=true|false] (reference-style) Markdown reStructuredText. . --reference-location . --reference-location=block|section|document ( reference-links) ( ) . document . markdown muse html epub slidy s5 slideous dzslides revealjs . --reference-location=section . --figure-caption-position=above|below ( below ). HTML LaTeX Docx ODT Typst . --table-caption-position=above|below ( above ). HTML LaTeX Docx ODT Typst . --markdown-headings=setext|atx ATX ( #) Setext ( ) Markdown. ( atx .) ATX . Markdown ipynb . --list-tables[=true|false] (list tables) RST. --top-level-division=default|section|chapter|part LaTeX ConTeXt DocBook TEI. part chapter section . (heuristics) : section . documentclass report book memoir ( article ) chapter . beamer chapter part \part{..} . Docx chapter (section break) part . . -N, --number-sections=[true|false] LaTeX ConTeXt HTML Docx ms EPUB. . unnumbered --number-sections . --number-offset=NUMBER[,NUMBER,...] () . . "1" "6" --number-offset=5 . "1.5" --number-offset=1,4 . --number-offset . --number-sections . HTML Docx . --listings[=true|false] * --syntax-highlighting=idiomatic --syntax-highlighting=default . listings LaTeX. . UTF-8 . : Encoding issue with the listings package. -i, --incremental[=true|false] ( ) . . --slide-level=NUMBER ( beamer revealjs pptx s5 slidy slideous dzslides). . 0-6 . 0 . Structuring the slide show . --section-divs[=true|false]
(
html4)
(
) ( Heading identifiers ). HTML ( HTML ). --email-obfuscation=none|javascript|references mailto: HTML. none mailto: . javascript JavaScript . references . none . --id-prefix=STRING HTML DocBook Markdown Haddock. . -T STRING, --title-prefix=STRING STRING (header) ( HTML ). --standalone ..TP -c URL, --css=URL CSS. . . HTML ( HTML) EPUB . -s/--standalone . EPUB . ( css stylesheet) pandoc epub.css ( --data-dir ). . --reference-doc=FILE|URL docx ODT. Docx docx docx pandoc . docx ( ) docx . docx pandoc reference.docx ( --data-dir ). . reference.docx reference.docx : pandoc -o custom-reference.docx --print-default-data-file reference.docx. custom-reference.docx Word LibreOffice . pandoc : : o Normal o Body Text o First Paragraph o Compact o Title o Subtitle o Author o Date o Abstract o AbstractTitle o Bibliography o Heading 1 o Heading 2 o Heading 3 o Heading 4 o Heading 5 o Heading 6 o Heading 7 o Heading 8 o Heading 9 o Block Text [ ] o Footnote Block Text [ ] o Source Code o Footnote Text o Definition Term o Definition o Caption o Table Caption o Image Caption o Figure o Captioned Figure o TOC Heading : o Default Paragraph Font o Verbatim Char o Footnote Reference o Hyperlink o Section Number : o Table ODT ODT ODT pandoc . ODT ODT . ODT pandoc reference.odt ( --data-dir ). . reference.odt reference.odt : pandoc -o custom-reference.odt --print-default-data-file reference.odt. custom-reference.odt LibreOffice . PowerPoint Microsoft PowerPoint 2013 ( .pptx .potx) . ( PowerPoint ): o Title Slide o Title and Content o Section Header o Two Content o Comparison o Content with Caption o Blank . pandoc . ( PowerPoint layout choice .) MS PowerPoint . ( Home Layout .) reference.pptx : pandoc -o custom-reference.pptx --print-default-data-file reference.pptx custom-reference.pptx MS PowerPoint (pandoc ). --split-level=NUMBER EPUB chunked HTML . . EPUB EPUB . . chunked HTML "" . --chunk-template=PATHTEMPLATE chunkedhtml . %n ( ) %s %h ( ) %i . section-%s-%i.html section-1.1-introduction.html . / \ . %s-%i.html ..TP --epub-chapter-level=NUMBER --split-level. --epub-cover-image=FILE EPUB. 1000px . Markdown cover-image YAML ( << EPUB>> ). --epub-title-page=true|false EPUB ( true ). --epub-metadata=FILE XML EPUB. Dublin Core . : Creative Commons es-AR pandoc : ( ) ( ) ( ISO 8601 ) ( lang ) ( UUID ). . : Markdown YAML . << EPUB>> . --epub-embed-font=FILE EPUB. . (wildcards) : DejaVuSans-*.ttf. escape (single quotes) . CSS ( --css ): @font-face { font-family: DejaVuSans; font-style: normal; font-weight: normal; src:url("../fonts/DejaVuSans-Regular.ttf"); } @font-face { font-family: DejaVuSans; font-style: normal; font-weight: bold; src:url("../fonts/DejaVuSans-Bold.ttf"); } @font-face { font-family: DejaVuSans; font-style: italic; font-weight: normal; src:url("../fonts/DejaVuSans-Oblique.ttf"); } @font-face { font-family: DejaVuSans; font-style: italic; font-weight: bold; src:url("../fonts/DejaVuSans-BoldOblique.ttf"); } body { font-family: "DejaVuSans"; } --epub-subdirectory=DIRNAME OCF EPUB . EPUB . EPUB . --ipynb-output=all|none|best ipynb . all . none . best pandoc . best . --pdf-engine=PROGRAM PDF. : pdflatex lualatex xelatex latexmk tectonic wkhtmltopdf weasyprint pagedjs-cli prince context groff pdfroff typst. PATH . pandoc -t/--to : o -t latex : pdflatex ( : xelatex lualatex tectonic latexmk) o -t context: context o -t html: weasyprint ( : prince wkhtmltopdf pagedjs-cli PDF HTML/CSS print-css.rocks ) o -t ms: groff o -t typst: typst PDF -o/--output . . ms .pdfhref --pdf-engine groff pdfroff . --pdf-engine-opt=STRING pdf-engine. foo latexmk --pdf-engine-opt=-outdir=foo . ..SS -C, --citeproc . --bibliography bibliography references CSL YAML Markdown. CSL --csl csl . ( chicago-author-date .) Lua ( --filter --lua-filter): . (Citations) . : citations (writer) citeproc . --bibliography=FILE bibliography FILE . FILE . FILE URL HTTP . FILE ( --resource-path). --csl=FILE csl FILE . ( --metadata csl=FILE .) FILE URL HTTP . FILE ( --resource-path) csl pandoc . --citation-abbreviations=FILE citation-abbreviations FILE . ( --metadata citation-abbreviations=FILE .) FILE URL HTTP . FILE ( --resource-path) csl pandoc . --natbib natbib LaTeX. --citeproc PDF . LaTeX bibtex . --biblatex biblatex LaTeX. --citeproc PDF . LaTeX bibtex biber . HTML TeX Unicode . span class="math" . --mathjax . --mathjax[=URL] MathJax TeX HTML. TeX \(...\) ( ) \[...\] ( ) math . MathJax . URL MathJax.js . URL Cloudflare CDN . --mathml TeX MathML ( epub3 docbook4 docbook5 jats html4 html5). odt . MathML . --webtex[=URL] TeX . URL (URL-encode) URL . SVG --webtex https://latex.codecogs.com/svg.latex? . URL URL PNG CodeCogs (https://latex.codecogs.com/png.latex?). : --webtex HTML Markdown Markdown . --katex[=URL] KaTeX TeX HTML. URL KaTeX . katex.min.js katex.min.css . URL KaTeX CDN . --gladtex TeX HTML. HTML GladTeX SVG HTML . pandoc -s --gladtex input.md -o myfile.htex gladtex -d image_dir myfile.htex # produces myfile.html and images in image_dir --dump-args[=true|false] stdout . . -o - ( stdout) . . pandoc -- . --ignore-args[=true|false] ( ). pandoc . pandoc --ignore-args -o foo.html -s foo.txt -- -e latin1 : pandoc -o foo.html -s (EXIT CODES) pandoc 0 . : Code Error ------ ------------------------------------- 1 PandocIOError 3 PandocFailOnWarningError 4 PandocAppError 5 PandocTemplateError 6 PandocOptionError 21 PandocUnknownReaderError 22 PandocUnknownWriterError 23 PandocUnsupportedExtensionError 24 PandocCiteprocError 25 PandocBibliographyError 31 PandocEpubSubdirectoryError 43 PandocPDFError 44 PandocXMLError 47 PandocPDFProgramNotFoundError 61 PandocHttpError 62 PandocShouldNeverHappenError 63 PandocSomeError 64 PandocParseError 66 PandocMakePDFError 67 PandocSyntaxMapError 83 PandocFilterError 84 PandocLuaError 89 PandocNoScriptingEngine 91 PandocMacroLoop 92 PandocUTF8DecodingError 93 PandocIpynbDecodingError 94 PandocUnsupportedCharsetError 95 PandocInputNotTextError 97 PandocCouldNotFindDataFileError 98 PandocCouldNotFindMetadataFileError 99 PandocResourceNotFound (DEFAULTS FILES) --defaults YAML JSON . YAML JSON . . : verbosity: INFO JSON: { "verbosity": "INFO" } ( ) : csl: ${HOME}/mycsldir/special.csl ${USERDATA} USERDATA . ${.} . : epub-cover-image: ${.}/cover.jpg epub-metadata: ${.}/meta.xml resource-path: - . # the working directory from which pandoc is run - ${.}/images # the images subdirectory of the directory # containing this defaults file . defaults . letter.yaml defaults pandoc --defaults letter pandoc -dletter . . (--metadata-file --css --include-in-header --include-before-body --include-after-body --variable --metadata --syntax-definition) . . command line defaults file --------------------------------- ---------------------------------- foo.md input-file: foo.md foo.md bar.md input-files: - foo.md - bar.md input-files stdin [] ..SS (General options) command line defaults file ----------------------------------- -------------------------------------- --from markdown+emoji from: markdown+emoji reader: markdown+emoji --to markdown+hard_line_breaks to: markdown+hard_line_breaks writer: markdown+hard_line_breaks --output foo.pdf output-file: foo.pdf --output - output-file: --data-dir dir data-dir: dir --defaults file defaults: - file --verbose verbosity: INFO --quiet verbosity: ERROR --fail-if-warnings fail-if-warnings: true --sandbox sandbox: true --log=FILE log-file: FILE defaults: . verbosity ERROR WARNING INFO . (Reader options) command line defaults file ------------------------------------- ------------------------------------ --shift-heading-level-by -1 shift-heading-level-by: -1 --indented-code-classes python indented-code-classes: - python --default-image-extension ".jpg" default-image-extension: '.jpg' --file-scope file-scope: true --citeproc \ filters: --lua-filter count-words.lua \ - citeproc --filter special.lua - count-words.lua - type: json path: special.lua --metadata key=value \ metadata: --metadata key2 key: value key2: true --metadata-file meta.yaml metadata-files: - meta.yaml metadata-file: meta.yaml --preserve-tabs preserve-tabs: true --tab-stop 8 tab-stop: 8 --track-changes accept track-changes: accept --extract-media dir extract-media: dir --abbreviations abbrevs.txt abbreviations: abbrevs.txt --typst-input foo=bar typst-inputs: foo: bar --trace trace: true (literal) Markdown . .lua Lua JSON . . . citeproc citeproc {type: citeproc} . (General writer options) command line defaults file ----------------------------------- -------------------------------------- --standalone standalone: true --template letter template: letter --variable key=val \ variables: --variable key2 key: val key2: true --eol nl eol: nl --dpi 300 dpi: 300 --wrap preserve wrap: "preserve" --columns 72 columns: 72 --table-of-contents table-of-contents: true --toc toc: true --toc-depth 3 toc-depth: 3 --strip-comments strip-comments: true --no-highlight syntax-highlighting: 'none' --syntax-highlighting kate syntax-highlighting: kate --syntax-definition mylang.xml syntax-definitions: - mylang.xml syntax-definition: mylang.xml --include-in-header inc.tex include-in-header: - inc.tex --include-before-body inc.tex include-before-body: - inc.tex --include-after-body inc.tex include-after-body: - inc.tex --resource-path .:foo resource-path: ['.','foo'] --request-header foo:bar request-headers: - ["User-Agent", "Mozilla/5.0"] --no-check-certificate no-check-certificate: true command line defaults file ------------------------------------- ------------------------------------ --self-contained self-contained: true --link-images link-images: true --html-q-tags html-q-tags: true --ascii ascii: true --reference-links reference-links: true --reference-location block reference-location: block --figure-caption-position=above figure-caption-position: above --table-caption-position=below table-caption-position: below --markdown-headings atx markdown-headings: atx --list-tables list-tables: true --top-level-division chapter top-level-division: chapter --number-sections number-sections: true --number-offset=1,4 number-offset: \[1,4\] --listings listings: true --list-of-figures list-of-figures: true --lof lof: true --list-of-tables list-of-tables: true --lot lot: true --incremental incremental: true --slide-level 2 slide-level: 2 --section-divs section-divs: true --email-obfuscation references email-obfuscation: references --id-prefix ch1 identifier-prefix: ch1 --title-prefix MySite title-prefix: MySite --css styles/screen.css \ css: --css styles/special.css - styles/screen.css - styles/special.css --reference-doc my.docx reference-doc: my.docx --epub-cover-image cover.jpg epub-cover-image: cover.jpg --epub-title-page=false epub-title-page: false --epub-metadata meta.xml epub-metadata: meta.xml --epub-embed-font special.otf \ epub-fonts: --epub-embed-font headline.otf - special.otf - headline.otf --split-level 2 split-level: 2 --chunk-template="%i.html" chunk-template: "%i.html" --epub-subdirectory="" epub-subdirectory: '' --ipynb-output best ipynb-output: best --pdf-engine xelatex pdf-engine: xelatex --pdf-engine-opt=--shell-escape pdf-engine-opts: - '-shell-escape' pdf-engine-opt: '-shell-escape' command line defaults file ------------------------------------- ------------------------------------ --citeproc citeproc: true --bibliography logic.bib bibliography: logic.bib --csl ieee.csl csl: ieee.csl --citation-abbreviations ab.json citation-abbreviations: ab.json --natbib cite-method: natbib --biblatex cite-method: biblatex cite-method citeproc natbib biblatex . LaTeX . citeproc `citeproc: true` . citeproc citeproc filters ( ). HTML command line defaults file --------------------------------- ---------------------------------- --mathjax html-math-method: method: mathjax --mathml html-math-method: method: mathml --webtex html-math-method: method: webtex --katex html-math-method: method: katex --gladtex html-math-method: method: gladtex method plain . URL url: html-math-method: ..SS " (Options for wrapper scripts)" command line defaults file --------------------------------- ---------------------------------- --dump-args dump-args: true --ignore-args ignore-args: true (TEMPLATES) -s/--standalone pandoc . pandoc -D *FORMAT* FORMAT . --template . FORMAT templates/default.*FORMAT* ( --data-dir ) . : o odt default.opendocument . o docx default.openxml . o pdf default.latex ( -t context default.context -t ms default.ms -t html default.html). o pptx . docx odt pptx --reference-doc . . . -V/--variable . pandoc YAML -M/--metadata . pandoc . pandoc . pandoc . . (fork) pandoc-templates (merge) pandoc . (Template syntax) (Comments) $-- . (Delimiters) $...$ ${...} . . . . $ $$ . (Interpolated variables) . _ - . . it if else endif for sep endfor . : $foo$ $foo.bar.baz$ $foo_bar.baz-bim$ $ foo $ ${foo} ${foo.bar.baz} ${foo_bar.baz-bim} ${ foo } . employee.salary salary employee . o . ( (escaping) .) o . o (map) true . o ..SS " (Conditionals)" if(variable) ( ) endif ( ) . else ( ) . if variable (true) else ( ) . (true) : o (map) o (true) o o True YAML ( -M/--metadata) true false . -V/--variable . if(foo) -V foo=false -M foo=false . : $if(foo)$bar$endif$ $if(foo)$ $foo$ $endif$ $if(foo)$ part one $else$ part two $endif$ ${if(foo)}bar${endif} ${if(foo)} ${foo} ${endif} ${if(foo)} ${ foo.bar } ${else} no foo! ${endif} elseif : $if(foo)$ XXX $elseif(bar)$ YYY $else$ ZZZ $endif$ For (For loops) for for(variable) ( ) endfor ( ) . o variable variable (concatenate) . o variable (map) . o . : $for(foo)$$foo$$sep$, $endfor$ $for(foo)$ - $foo.last$, $foo.first$ $endfor$ ${ for(foo.bar) } - ${ foo.bar.last }, ${ foo.bar.first } ${ endfor } $for(mymap)$ $it.name$: $it.office$ $endfor$ sep ( ) . sep endfor . ${ for(foo) }${ foo }${ sep }, ${ endfor } variable (anaphoric) it . ${ for(foo.bar) } - ${ it.last }, ${ it.first } ${ endfor } (Partials) ( ) () : ${ styles() } . . : ${ styles.html() } ( templates .) (:) : ${ date:fancy() } ${ articles:bibentry() } articles bibentry() . : ${ for(articles) } ${ it:bibentry() } ${ endfor } it . bibentry articles.title it.title ( ) . (newlines) . . : ${months[, ]} ${articles:bibentry()[; ]} (literal) ( sep for) ..SS (Nesting) "" (nested) ^ : $item.number$ $^$$item.description$ ($item.price$) item.description : 00123 A fine bottle of 18-year old Oban whiskey. ($148) ^ . : $item.number$ $^$$item.description$ ($item.price$) (Available til $item.sellby$.) : 00123 A fine bottle of 18-year old Oban whiskey. ($148) (Available til March 30, 2020.) (whitespace) . (Breakable spaces) ( ) ~ ( ~ ) . $~$This long line may break if the document is rendered with a short line length.$~$ (Pipes) (pipe) (partial) . (/) ( partial) . : $for(name)$ $name/uppercase$ $endfor$ $for(metadata/pairs)$ - $it.key$: $it.value$ $endfor$ $employee:name()/uppercase$ : $for(employees/pairs)$ $it.key/alpha/uppercase$. $it.name$ $endfor$ : |----------------------|------------| $for(employee)$ $it.name.first/uppercase/left 20 "| "$$it.name.salary/right 10 " | " " |"$ $endfor$ |----------------------|------------| : o pairs: (map) key value . key 1 . o uppercase: . o lowercase: . o length: : . o reverse: . o first: . o last: . o rest: . o allbutlast: . o chomp: ( ) . o nowrap: . o alpha: a..z ( ) . . uppercase . o roman: . . uppercase . o left n "leftborder" "rightborder": n . . . . " \ . o right n "leftborder" "rightborder": n . o center n "leftborder" "rightborder": n ..SS " (Variables)" (Metadata variables) title author date . LaTeX ConTeXt PDF . pandoc ( ) YAML : --- author: - Aristotle - Peter Abelard ... PDF HTML title-meta author-meta date-meta . ( title author date .) HTML pagetitle title . subtitle HTML EPUB LaTeX ConTeXt docx. abstract HTML LaTeX ConTeXt AsciiDoc docx. abstract-title HTML EPUB docx Typst . lang . keywords HTML PDF ODT pptx docx AsciiDoc author . subject ODT PDF docx EPUB pptx. description ODT docx pptx. Comments . category docx pptx. ODT docx pptx (custom property) . YAML : --- title: 'This is the title' subtitle: "This is the subtitle" author: - Author One - Author Two description: | This is a long description. It consists of two paragraphs ... docx ODT pptx title author description subtitle . (Language variables) lang IETF ( BCP 47) en en-GB . Language subtag lookup . (hyphenation) PDF LaTeX ( babel polyglossia) ConTeXt . Div Span pandoc lang : --- lang: en-GB ... Text in the main document language (British English). ::: {lang=fr-CA} > Cette citation est ecrite en francais canadien. ::: More text in English. ['Zitat auf Deutsch.']{lang=de} dir rtl () ltr (). span div pandoc dir ( rtl ltr) . ( HTML) (Unicode Bidirectional Algorithm) . LaTeX xelatex ( --pdf-engine=xelatex ). document-css CSS (partial) styles.html ( pandoc --print-default-data-file=templates/styles.html ). --css true . pandoc -M document-css=false . mainfont font-family CSS html . fontsize font-size CSS 20px pt ( 12pt = 16px ). fontcolor color CSS html . linkcolor color CSS . monofont font-family CSS code . monobackgroundcolor background-color CSS code (padding) . linestretch line-height CSS html . maxwidth max-width CSS ( 36em ). backgroundcolor background-color CSS html . margin-left, margin-right, margin-top, margin-bottom padding CSS body . CSS : --- header-includes: | --- HTML classoption --katex YAML -M classoption=fleqn (display math) . HTML HTML (slide shows) pandoc . institute : revealjs-url (URL) reveal.js ( https://unpkg.com/reveal.js@^5 ) s5-url (URL) S5 ( s5/default ) slidy-url (URL) Slidy ( https://www.w3.org/Talks/Tools/Slidy2 ) slideous-url (URL) Slideous ( slideous ) title-slide-attributes reveal.js. background reveal.js beamer pptx . highlightjs-theme highlight.js --syntax-highlighting=idiomatic reveal.js ( monokai ). highlight.js . reveal.js . (boolean) reveal.js true 0 . Beamer PDF beamer . aspectratio (43 4:3 [] 169 16:9 1610 16:10 149 14:9 141 1.41:1 54 5:4 32 3:2) beameroption beamer \setbeameroption{} institute : logo () logooptions ( width height) navigation ( empty frame vertical horizontal) section-titles " " ( true ) theme, colortheme, fonttheme, innertheme, outertheme beamer themeoptions, colorthemeoptions, fontthemeoptions, innerthemeoptions, outerthemeoptions LaTeX beamer () titlegraphic : titlegraphicoptions ( width height) shorttitle, shortsubtitle, shortauthor, shortinstitute, shortdate beamer .SS PowerPoint . monofont . LaTeX PDF LaTeX . block-headings \paragraph \subparagraph ( ) (run-in) (free-standing) \subsubsection ( ) . KOMA-Script : --- documentclass: scrartcl header-includes: | \RedeclareSectionCommand[ beforeskip=-10pt plus -2pt minus -1pt, afterskip=1sp plus -1sp minus 1sp, font=\normalfont\itshape]{paragraph} \RedeclareSectionCommand[ beforeskip=-10pt plus -2pt minus -1pt, afterskip=1sp plus -1sp minus 1sp, font=\normalfont\scshape, indent=0pt]{subparagraph} ... classoption oneside : --- classoption: - twocolumn - landscape ... documentclass : article book report KOMA-Script scrartcl scrbook scrreprt memoir geometry geometry margin=1in : --- geometry: - top=30mm - left=20mm - heightrounded ... shorthands babel. ( pandoc babel shorthands=off .) hyperrefoptions hyperref linktoc=all : --- hyperrefoptions: - linktoc=all - pdfwindowui - pdfpagemode=FullScreen ... indent true pandoc ( LaTeX ). linestretch setspace 1.25 1.5 margin-left margin-right margin-top margin-bottom geometry ( geometry ). pagestyle \pagestyle{}: article plain () empty ( ) headings ( ) . papersize letter a4 secnumdepth ( --number-sections numbersections) beamerarticle (article) Beamer. : beamer LaTeX : pandoc -Vbeamerarticle -t beamer --template default.latex. handout (handout) Beamer ( ). csquotes csquotes \enquote \enquote* . csquotesoptions csquotes ( ). babeloptions babel ( ). provide=* . ..SS " (Fonts)" fontenc fontenc ( pdflatex) T1 ( LaTeX ). fontfamily pdflatex: TeX Live LaTeX Font Catalogue . Latin Modern . fontfamilyoptions fontfamily . Libertine (old-style) libertinus: --- fontfamily: libertinus fontfamilyoptions: - osf - p ... fontsize (). 10pt 11pt 12pt . documentclass KOMA-Script scrartcl scrbook . mainfont, sansfont, monofont, mathfont, CJKmainfont, CJKsansfont, CJKmonofont xelatex lualatex: fontspec . xelatex CJKmainfont xecjk lualatex luatexja . mainfontoptions, sansfontoptions, monofontoptions, mathfontoptions, CJKoptions, luatexjapresetoptions mainfont sansfont monofont mathfont CJKmainfont xelatex lualatex. fontspec . TeX Gyre Palatino : --- mainfont: TeX Gyre Pagella mainfontoptions: - Numbers=Lowercase - Numbers=Proportional ... mainfontfallback, sansfontfallback, monofontfallback mainfont sansfont monofont . . : --- mainfontfallback: - "FreeSans:" - "NotoColorEmoji:mode=harf" ... lualatex . babelfonts Babel ( chinese) : --- babelfonts: chinese-hant: "Noto Serif CJK TC" russian: "Noto Serif" ... microtypeoptions microtype (Links) colorlinks linkcolor filecolor citecolor urlcolor toccolor . boxlinks ( colorlinks ) linkcolor, filecolor, citecolor, urlcolor, toccolor URL : xcolor dvipsnames svgnames x11names . links-as-notes urlstyle URL ( tt rm sf same) (Front matter) lof, lot ( --lof/--list-of-figures --lot/--list-of-tables ) thanks toc ( --toc/--table-of-contents ) toc-depth .SS BibLaTeX BibLaTeX . biblatexoptions biblatex biblio-style --natbib --biblatex biblio-title --natbib --biblatex bibliography natbiboptions natbib pdf-trailer-id trailer PDF PDF . : <00112233445566778899aabbccddeeff> <00112233445566778899aabbccddeeff>. . pdfstandard () PDF ua-2 a-4f. PDF/A PDF/X PDF/UA . LuaLaTeX LaTeX 2023+ . : --- pdfstandard: - ua-2 - a-4f ... ConTeXt Pandoc PDF ConTeXt . fontsize ( 10pt 12pt) headertext, footertext ( ConTeXt ) indenting yes,small,next ( ConTeXt ) interlinespace 4ex ( setupinterlinespace) layout ( ConTeXt ) linkcolor, contrastcolor red blue ( ConTeXt ) linkstyle normal bold slanted boldslanted type cap small lof, lot mainfont, sansfont, monofont, mathfont : ( ConTeXt ) mainfontfallback, sansfontfallback, monofontfallback . \definefallbackfamily . . margin-left, margin-right, margin-top, margin-bottom layout ( layout ) pagenumbering ( setuppagenumbering) papersize letter A4 landscape ( ConTeXt ) pdfa PDF/A 1a:2005 2a. ( --metadata=pdfa pdfa: true YAML True ) 1b:2005 . --variable=pdfa . PDF/A ICC ( ) . ICC (output intent) pdfaiccprofile pdfaintent . ConTeXt PDFA . pdfaiccprofile pdfa ICC PDF default.cmyk. sRGB.icc . . . ConTeXt ICC Profiles . pdfaintent pdfa ISO coated v2 300\letterpercent\space (ECI). sRGB IEC61966-2.1 . toc ( --toc/--table-of-contents ) urlstyle normal bold slanted boldslanted type cap small whitespace none small ( setupwhitespace) includesource PDF.SS wkhtmltopdf Pandoc PDF wkhtmltopdf . --css . footer-html, header-html margin-left, margin-right, margin-top, margin-bottom papersize PDF man adjusting (l) (r) (c) (b) footer man header man section man Texinfo version ( ) filename info ( texi ) Typst template Typst ( ). margin Typst: x y top bottom left right. papersize : a4 us-letter . mainfont . fontsize ( 12pt). section-numbering 1.A.1. page-numbering 1 i . columns . thanks mathfont, codefont . linestretch 1.25 1.5 linkcolor, filecolor, citecolor : () ms fontfamily A (Avant Garde) B (Bookman) C (Helvetica) HN (Helvetica Narrow) P (Palatino) T (Times New Roman). Courier (monospace) . . install-font.sh Peter Schaffter . indent ( 2m) lineheight ( 12p) pointsize ( 10p) RTF fontsize 12pt 12.5pt. Pandoc . : body date-meta date ISO 8601 YYYY-MM-DD HTML (dzslides epub html html4 html5 revealjs s5 slideous slidy). date : mm/dd/yyyy mm/dd/yy yyyy-mm-dd (ISO 8601) dd MM yyyy ( 02 Apr 2018 02 April 2018) MM dd, yyyy ( Apr. 02, 2018 April 02, 2018) yyyy[mm[dd]] ( 20180402 201804 2018). header-includes -H/--include-in-header ( ) include-before -B/--include-before-body ( ) include-after -A/--include-after-body ( ) meta-json JSON . . numbersections -N/--number-sections sourcefile, outputfile . sourcefile stdin . : $if(sourcefile)$ $for(sourcefile)$ $sourcefile$ $endfor$ $else$ (stdin) $endif$ outputfile - . $curdir$/$sourcefile$ . pdf-engine PDF --pdf-engine PDF . curdir pandoc . pandoc-version pandoc. toc --toc/--table-of-contents toc-title ( EPUB HTML revealjs opendocument odt docx pptx beamer LaTeX ). docx pptx toc-title ..SH " (EXTENSIONS)" . +EXTENSION -EXTENSION . --from markdown_strict+footnotes Markdown --from markdown-footnotes-pipe_tables Markdown (pipe tables) . Markdown . Markdown ( commonmark gfm Markdown ). . Markdown ipynb Markdown Jupyter ( --markdown-headings). (Typography) : smart (straight quotes) (curly quotes) --- (em-dash) -- (en-dash) ... (ellipses) . "Mr." . / : markdown commonmark latex mediawiki org rst twiki html markdown latex context org rst markdown latex context ( ) : Markdown smart : . LaTeX smart (ligatures) TeX (`` '' ` ' ) (-- en-dash --- em-dash) . smart LaTeX (literal) . LaTeX smart pandoc smart pandoc . (Headings and sections) : auto_identifiers . / : markdown latex rst mediawiki textile man typst markdown muse markdown muse man : o . o . o - (underscore) . o . o . o ( ). o section. Heading Identifier ----------------------------- ----------------------------- Heading identifiers in HTML heading-identifiers-in-html Maitre d'hotel maitre-dhotel *Dogs*?--in *my* house? dogs--in-my-house [HTML], [S5], or [RTF]? html-s5-or-rtf 3. Applications applications 33 section . -1 -2 . ( gfm_auto_identifiers .) --toc|--table-of-contents . . : See the section on [heading identifiers](#heading-identifiers-in-html-latex-and-context). HTML LaTeX ConTeXt . --section-divs section ( div html4 )
(
) . JavaScript CSS ..SS : ascii_identifiers auto_identifiers ASCII . . : gfm_auto_identifiers auto_identifiers GitHub . (-) - _ . . tex_math_dollars tex_math_gfm tex_math_single_backslash tex_math_double_backslash Pandoc's Markdown . HTML . MathJax . HTML/TeX Pandoc's Markdown : o raw_html HTML AST HTML . HTML . o raw_tex LaTeX TeX ConTeXt . markdown / : latex textile html ( \ref \eqref) ipynb textile commonmark : ipynb raw_html raw_tex TeX Markdown mime text/html . ipynb docx ( html tex ) raw_html raw_tex . o native_divs div HTML Div pandoc . HTML -f html-native_divs+raw_html . o native_spans span HTML Span pandoc . HTML -f html-native_spans+raw_html . HTML Markdown div span pandoc -f html-native_divs-native_spans -t markdown . Literate Haskell : literate_haskell literate Haskell . / : markdown rst latex markdown rst latex html +lhs ( +literate_haskell) pandoc literate Haskell . : o Markdown "bird track" Haskell . \begin{code} \end{code} Haskell . ATX `#' `=' . o Markdown haskell literate bird track Haskell . ATX ( `#' ) setext ( ) . ( ghc `#' .) o restructured text "bird track" Haskell . o restructured text haskell bird track . o LaTeX code Haskell . o LaTeX haskell code . o HTML haskell literatehaskell bird track . : pandoc -f markdown+lhs -t html literate Haskell Markdown HTML ( bird track) . pandoc -f markdown+lhs -t html+lhs HTML Haskell bird track literate Haskell . GHC bird track literate ( ) Haskell ..SS : empty_paragraphs . . / : docx html docx odt opendocument html latex : native_numbering . / : odt opendocument docx . : xrefs_name . (refresh) . xrefs_number . . / : odt opendocument : xrefs_number . . xrefs_name . xrefs_number native_numbering . . / : odt opendocument : styles docx custom-styles docx pandoc . AST Div Span . ( Table .) docx . docx : amuse muse Text::Amuse Emacs Muse . : raw_markdown ipynb Markdown Markdown ( ). ipynb Markdown . : citations (typst) citations typst ( ) typst pandoc pandoc typst . : citations (org) citations org org-cite org-ref pandoc org-cite pandoc . : citations (docx) citations docx Zotero Mendeley EndNote pandoc . ( .) : fancy_lists (org) Markdown Pandoc org org-list-allow-alphabetical Emacs . Org Mode . Org # Pandoc Markdown . : element_citations jats . CSL . : ntb context Natural Tables (TABLE) Extreme Tables (xtables) . Natural extreme . : smart_quotes (org) (straight quotes) (curly quotes) . Org smart_quotes : . smart ..SS : special_strings (org) --- (em-dash) -- (en-dash) \- (shy hyphen) ... (ellipses). smart . : tagging context PDF (tagged PDFs) . . emphasis-command . (PANDOC'S MARKDOWN) Markdown (John Gruber) . Markdown . markdown_strict markdown . . . (Extensions) . : Markdown . - (John Gruber) pandoc . pandoc Markdown . Markdown HTML pandoc . pandoc HTML -HTML . () . (Newlines) . (hard line break) . : escaped_line_breaks . : . : Setext ATX. Setext setext = ( ) - ( ) : A level-one heading =================== A level-two heading ------------------- ( ). ATX ATX # # . # : ## A level-two heading ### A level-three heading ### setext : # A level-one heading with a [link](/url) and *emphasis* : blank_before_header Markdown . ( ). # ( ) . : I like several of their flavors of ice cream: #22, for example, and #5. : space_in_atx_header Markdown # ATX #5 bolt #hashtag . pandoc . auto_identifiers . : header_attributes : {#identifier .class .class key=value key=value} foo : # My heading {#foo} ## My heading ## {#foo} My other heading {#foo} --------------- ( PHP Markdown Extra .) / (writers) . / HTML HTML EPUB slidy . LaTeX ConTeXt Textile Jira AsciiDoc . unnumbered --number-sections . (-) .unnumbered . # My heading {-} : # My heading {.unnumbered} unnumbered unlisted . ( : LaTeX HTML PowerPoint RTF.).SS : implicit_header_references Pandoc . # Heading identifiers in HTML [Heading identifiers in HTML] [Heading identifiers in HTML][] [the section on heading identifiers][heading identifiers in HTML] : [Heading identifiers in HTML](#heading-identifiers-in-html) . . . bar #foo: # Foo [foo]: bar See [foo] (Block quotations) Markdown () . ( ) > . ( > .) > This is a block quote. This > paragraph has two lines. > > 1. This is a list inside a block quote. > 2. Second item. "" (lazy) > : > This is a block quote. This paragraph has two lines. > 1. This is a list inside a block quote. 2. Second item. . : > This is a block quote. > > > A block quote within a block quote. > . > : > code : blank_before_blockquote Markdown . Pandoc ( ). > ( ) . markdown_strict pandoc : > This is a block quote. >> Not nested, since `blank_before_blockquote` is enabled by default (Verbatim) (Indented code blocks) ( ) (verbatim) : . if (a > 3) { moveShip(5 * gravity, DOWN); } ( ) verbatim . : ..SS (Fenced code blocks) : fenced_code_blocks pandoc . (~) . . : ~~~~~~~ if (a > 3) { moveShip(5 * gravity, DOWN); } ~~~~~~~ . : ~~~~~~~~~~~~~~~~ ~~~~~~~~~~ code including tildes ~~~~~~~~~~ ~~~~~~~~~~~~~~~~ : backtick_code_blocks fenced_code_blocks (~) (`) . : fenced_code_attributes : ~~~~ {#mycode .haskell .numberLines startFrom="100"} qsort [] = [] qsort (x:xs) = qsort (filter (< x) xs) ++ [x] ++ qsort (filter (>= x) xs) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ mycode haskell numberLines startFrom 100 . (syntax highlighting) . HTML LaTeX Docx Ms PowerPoint. . ( pandoc --list-highlight-languages .) :
                
                ...
                
              
numberLines ( number-lines) 1 startFrom . lineAnchors ( line-anchors) HTML . : ```haskell qsort [] = [] ``` : ``` {.haskell} qsort [] = [] ``` : ```haskell {.numberLines} qsort [] = [] ``` : ``` {.haskell .numberLines} qsort [] = [] ``` fenced_code_attributes () . --syntax-highlighting=none . --syntax-highlighting . << (Syntax highlighting)>> . (Line blocks) : line_blocks (|) . Markdown . : | The limerick packs laughs anatomical | In space that is quite economical. | But the good ones I've seen | So seldom are clean | And the clean ones so seldom are comical | 200 Main St. | Berkeley, CA 94718 (hard-wrap) . | The Right Honorable Most Venerable and Righteous Samuel L. Constable, Jr. | 200 Main St. | Berkeley, CA 94718 ( ) ( ). ( ) . reStructuredText ..SS " (Lists)" (Bullet lists) . (* + -) . : * one * two * three "" . "" : * one * two * three . (whitespace) . ( ) : * here is my first list item. * and my second. Markdown "" : * here is my first list item. * and my second. (Block content in list items) (block-level) . . * First paragraph. Continued. * Second paragraph. With a code block, which must be indented eight spaces: { code } : : * code continuation paragraph . . . * fruits + apples - macintosh - red delicious + pears + peaches * vegetables + broccoli + chard Markdown "" . . + A lazy, lazy, list item. + Another one; this looks bad but is legal. Second paragraph of second list item. (Ordered lists) . Markdown . : 1. one 2. two 3. three : 5. one 7. two 1. three Markdown pandoc . . . fancy_lists `#' : #. one #. two : `#' commonmark . commonmark 1 ( i a) . . : startnum pandoc . 9 : 9) Ninth 10) Tenth 11) Eleventh i. subone ii. subtwo iii. subthree pandoc . : (2) Two (5) Three 1. Four * Five #. : #. one #. two #. three : task_lists pandoc GitHub-Flavored Markdown . - [ ] an unchecked task list item - [x] checked item (Definition lists) : definition_lists pandoc PHP Markdown Extra . Term 1 : Definition 1 Term 2 with *inline markup* : Definition 2 { some code, part of Definition 2 } Third paragraph of definition 2. . . ( ) . : ~ ( four_space_rule ) . Markdown <<>> ("lazily") : Term 1 : Definition with lazy continuation. Second paragraph of the definition. ( ) . / . : Term 1 ~ Definition 1 Term 2 ~ Definition 2a ~ Definition 2b ..SS : example_lists @ . @ <<1>> <<2>> . @ . : (@) My first example will be numbered (1). (@) My second example will be numbered (2). Explanation of examples. (@) My third example will be numbered (3). : (@good) This is a good example. As (@good) illustrates, ... - . . four_space_rule . . : (@foo) Sample sentence. Intervening text... This theory can explain the case we saw earlier (repeated): (@foo) Sample sentence. . - item one - item two { my code block } ! pandoc ( Markdown) { my code block } . << >> HTML : - item one - item two { my code block } : 1. one 2. two 3. three 1. uno 2. dos 3. tres * - _ ( ) : * * * * --------------- . pandoc YAML . . ( ) Courier . ( pipe tables) . : table_captions (caption) ( ). Table: ( table: :) . ..SS : simple_tables : Right Left Center Default ------- ------ ---------- ------- 12 12 12 12 123 123 123 123 1 1 1 1 Table: Demonstration of simple table syntax. . : o . o . o . o ( ). . . : ------- ------ ---------- ------- 12 12 12 12 123 123 123 123 1 1 1 1 ------- ------ ---------- ------- . . : multiline_tables ( ). : ------------------------------------------------------------- Centered Default Right Left Header Aligned Aligned Aligned ----------- ------- --------------- ------------------------- First row 12.0 Example of a row that spans multiple lines. Second row 5.0 Here's another one. Note the blank line between rows. ------------------------------------------------------------- Table: Here's the caption. It, too, may span multiple lines. : o ( ). o . o . (writers) . Markdown . : ----------- ------- --------------- ------------------------- First row 12.0 Example of a row that spans multiple lines. Second row 5.0 Here's another one. Note the blank line between rows. ----------- ------- --------------- ------------------------- : Here's a multiline table without a header. ( ) . : grid_tables : : Sample grid table. +---------------+---------------+--------------------+ | Fruit | Price | Advantages | +===============+===============+====================+ | Bananas | $1.34 | - built-in wrapper | | | | - bright color | +---------------+---------------+--------------------+ | Oranges | $2.10 | - cures scurvy | | | | - tasty | +---------------+---------------+--------------------+ = . ( ) . : +---------------------+----------+ | Property | Earth | +=============+=======+==========+ | | min | -89.2 C | | Temperature +-------+----------+ | 1961-1990 | mean | 14 C | | +-------+----------+ | | max | 56.7 C | +-------------+-------+----------+ : +---------------------+-----------------------+ | Location | Temperature 1961-1990 | | | in degree Celsius | | +-------+-------+-------+ | | min | mean | max | +=====================+=======+=======+=======+ | Antarctica | -89.2 | N/A | 19.8 | +---------------------+-------+-------+-------+ | Earth | -89.2 | 14 | 56.7 | +---------------------+-------+-------+-------+ (pipe tables) : +---------------+---------------+--------------------+ | Right | Left | Centered | +==============:+:==============+:==================:+ | Bananas | $1.34 | built-in wrapper | +---------------+---------------+--------------------+ : +--------------:+:--------------+:------------------:+ | Right | Left | Centered | +---------------+---------------+--------------------+ (table foot) - = : +---------------+---------------+ | Fruit | Price | +===============+===============+ | Bananas | $1.34 | +---------------+---------------+ | Oranges | $2.10 | +===============+===============+ | Sum | $3.44 | +===============+===============+ . table-mode Emacs (M-x table-insert) ..SS : pipe_tables : | Right | Left | Default | Center | |------:|:-----|---------|:------:| | 12 | 12 | 12 | 12 | | 123 | 123 | 123 | 123 | | 1 | 1 | 1 | 1 | : Demonstration of pipe table syntax. (syntax) PHP Markdown Extra . . . (header) . . . ( ) : fruit| price -----|-----: apple|2.05 pear|1.37 orange|3.09 . Markdown ( --columns ) (wrap) . ( ---|- / / .) . : pandoc orgtbl-mode Emacs' : | One | Two | |-----+-------| | my | table | | is | nice | | + . orgtbl . . : table_attributes (attributes) (caption) . ( header_attributes .) : Here's the caption. {#ident .class key="value"} LaTeX pandoc LaTeX longtable . "" (float) . "" ( ) float ( ) . latex-placement : : The caption of the table. {#ident .float latex-placement="ht"} longtable LaTeX float Lua : function Table(el) el.classes:insert("float") return el end (Metadata blocks) : pandoc_title_block : % title % author(s) (separated by semicolons) % date . ( (standalone) LaTeX HTML .) . : % % Author % My title % % June 15, 2006 : % My title on multiple lines (semicolon) . : % Author One Author Two % Author One; Author Two % Author One; Author Two . ( ) . --standalone (-s) . HTML : (head) -- -- . ( --title-prefix -T). H1 "title" CSS . -T HTML . (man page writer) . () . ( .) . (|) . % PANDOC(1) PANDOC . % PANDOC(1) Pandoc User Manuals "Pandoc User Manuals" . % PANDOC(1) Pandoc User Manuals | Version 4.0 "Version 4.0" ..SS : yaml_metadata_block YAML YAML (---) (---) (...) . --- . YAML . ( JSON JSON YAML .) pandoc YAML Markdown pandoc : pandoc chap1.md chap2.md chap3.md metadata.yaml -s -o book.html YAML --- --- ... . --metadata-file . Markdown ( ) . YAML . ( ) Markdown . (underscore) pandoc . ( .) YAML ( yes True 15 ). . . YAML . (anchors) . pandoc -t markdown Markdown YAML -s/--standalone . . (escaping) YAML . (backslash) YAML . (|) . : --- title: 'This is the title: it contains a colon' author: - Author One - Author Two keywords: [nothing, nothingness] abstract: | This is the abstract. It consists of two paragraphs. ... | | . YAML pandoc . YAML YAML . . HTML abstract HTML Markdown abstract :

This is the abstract.

It consists of two paragraphs.

YAML . author . (affiliation) : --- title: The document title author: - name: Author One affiliation: University of Somewhere - name: Author Two affiliation: University of Nowhere ... : $for(author)$ $if(author.name)$ $author.name$$if(author.affiliation)$ ($author.affiliation$)$endif$ $else$ $author$ $endif$ $endfor$ (header) header-includes raw_attribute Markdown . : header-includes: - | ```{=latex} \let\oldsection\section \renewcommand{\section}[1]{\clearpage\oldsection{#1}} ``` : yaml_metadata_block markdown commonmark ( gfm commonmark_x ). commonmark gfm commonmark_x : o YAML ( ). pandoc YAML . o YAML . ..SS (Backslash escapes) : all_symbols_escapable (literal) . *\*hello\** : *hello* hello Markdown : \`*_{}[]()>#+-.! ( markdown_strict Markdown .) (nonbreaking space) . TeX ~ . HTML XML ( HTML "" --ascii ). ( ) (hard line break) . TeX \\ HTML
. "" Markdown . (verbatim) . (Inline formatting) (Emphasis) * _ : This text is _emphasized with underscores_, and this is *emphasized with asterisks*. * _ (strong emphasis) : This is **strong emphasis** and __with underscores__. * _ : This is * not emphasized *, and \*neither is this\*. : intraword_underscores _ pandoc _ . * : feas*ible*, not feas*able*. (Strikeout) : strikeout ~~ . This ~~is deleted text.~~ (Superscripts and subscripts) : superscript subscript ^ ~ . H~2~O is a liquid. 2^10^ is 1024. ^...^ ~...~ . . ( ~ ^ .) P "a cat" P~a\ cat~ P~a cat~. (Verbatim) (verbatim) : What is the difference between `>>=` and `>>`? verbatim : Here is a literal backtick `` ` ``. ( .) verbatim ( ) ( ) . ( Markdown) verbatim : This is a backslash followed by an asterisk: `\*`. (fenced code blocks) (verbatim) : `<$>`{.haskell} (Underline) underline : [Underline]{.underline} bracketed_spans ( native_spans): Underline . (Small caps) smallcaps : [Small caps]{.smallcaps} bracketed_spans: Small caps Markdown CSS : Small caps . (Highlighting) mark : [Mark]{.mark} bracketed_spans ( native_spans): Mark . (Math) : tex_math_dollars $ TeX . $ $ . $20,000 and $30,000 . $ (\$) . (display math) $$ . ( . $$ .) TeX . : LaTeX \(...\) ( ) \[...\] ( ) . Markdown, Emacs Org mode, ConTeXt, Txt2Tags, ZimWiki $...$ ( ) $$...$$ ( ) . XWiki {{formula}}..{{/formula}} . reStructuredText :math: . AsciiDoc AsciiDoc latexmath:[...] . asciidoc_legacy . Texinfo @math . roff man, Jira markup $ . MediaWiki, DokuWiki . Textile . RTF, OpenDocument . ODT MathML . DocBook --mathml MathML inlineequation informalequation . . Docx PowerPoint OMML . FictionBook2 --webtex CodeCogs . . HTML, Slidy, DZSlides, S5, EPUB HTML . << HTML>> ..SS HTML : raw_html Markdown HTML ( DocBook) ( (verbatim) < > & ). ( Markdown .) HTML HTML S5 Slidy Slideous DZSlides EPUB Markdown CommonMark Emacs Org Textile Txt2Tags () . HTML Markdown raw_attribute . CommonMark raw_html (small capitals) HTML . . raw_html (pipe) HTML . : markdown_in_html_blocks Markdown "" HTML : HTML . HTML Markdown ( ) * . markdown_strict pandoc HTML Markdown . pandoc
*one* [a link](https://google.com)
one a link
Markdown.pl . : HTML """) ``` ## Image This image ![image](myimage.png) will be included as a cell attachment. div . fenced div native div . : :::::: {.cell .markdown} # Lorem **Lorem ipsum** dolor sit amet, consectetur adipiscing elit. Nunc luctus bibendum felis dictum sodales. :::::: :::::: {.cell .code execution_count=1} ``` {.python} print("hello") ``` ::: {.output .stream .stdout} ``` hello ``` ::: :::::: :::::: {.cell .code execution_count=2} ``` {.python} from IPython.display import HTML HTML(""" HTML """) ``` ::: {.output .execute_result execution_count=2} ```{=html} HTML hello ``` ::: :::::: HTML TeX raw . pandoc HTML TeX "" pandoc . HTML TeX raw Markdown ipynb -raw_html-raw_tex+raw_attribute . Markdown Markdown ipynb . --wrap=preserve Markdown --markdown-headings=setext Setext --preserve-tabs ..SH " (VIMDOC)" Vimdoc Vim : abstract: "A short description" author: Author title: Title # Vimdoc-specific filename: "definition-lists.txt" vimdoc-prefix: pandoc abstract author title filename . ( --standalone Templates ): *definition-lists.txt* A short description Title by Author Type |gO| to see the table of contents. [...] vim:tw=72:sw=4:ts=4:ft=help:norl:et: vimdoc-prefix : ( ) . markdown : ## Header `:[range]Fnl {expr}`{#:Fnl} : Evaluates {expr} or range `vim.b`{#vim.b} : Buffer-scoped (`:h b:`) variables for the current buffer. Invalid or unset key returns `nil`. Can be indexed with an integer to access variables for a specific buffer. [Span]{#span} : generic inline container for phrasing content, which does not inherently represent anything. vimdoc: ------------------------------------------------------------------------ Header *header* :[range]Fnl {expr} *:Fnl* Evaluates {expr} or range `vim.b` *vim.b* Buffer-scoped (|b:|) variables for the current buffer. Invalid or unset key returns `nil`. Can be indexed with an integer to access variables for a specific buffer. Span *span* generic inline container for phrasing content, which does not inherently represent anything. vimdoc ( -M vimdoc-prefix=pandoc): ------------------------------------------------------------------------ Header *pandoc-header* :[range]Fnl {expr} *:Fnl* Evaluates {expr} or range `vim.b` *pandoc-vim.b* Buffer-scoped (|b:|) variables for the current buffer. Invalid or unset key returns `nil`. Can be indexed with an integer to access variables for a specific buffer. Span *pandoc-span* generic inline container for phrasing content, which does not inherently represent anything. vim.b Span :Fnl ex ( : ) . :help b: |b:| ( :h b: ). . Vim Pandoc . Vim --columns 78 . (SYNTAX HIGHLIGHTING) Pandoc (fenced code blocks) . skylighting . HTML EPUB Docx Ms Man Typst LaTeX/PDF . pandoc pandoc --list-highlight-languages . --syntax-highlighting . pygments pygments ( pygments ). pandoc --list-highlight-styles . --print-highlight-style JSON .theme --syntax-highlighting . JSON pygments: pandoc -o my.theme --print-highlight-style pygments my.theme : pandoc --syntax-highlighting my.theme --syntax-definition XML KDE . KDE . pandoc "Could not read highlighting theme" JSON UTF-8 (BOM) . --syntax-highlighting=none . (idiomatic) pandoc --syntax-highlighting=idiomatic . idiomatic : o reveal.js reveal.js . highlightjs-theme . o Typst Typst . ( Typst .) o LaTeX listings . listings . UTF-8 . : Encoding issue with the listings package. o idiomatic default ..SH " (CUSTOM STYLES)" docx odt ICML . (Output) odt docx ICML pandoc ( ) . (reference doc) . pandoc div span . Div Span Table custom-style pandoc ( ). bracketed_spans [Get out]{custom-style="Emphatically"}, he said. <> Emphatically . fenced_divs Dickinson starts the poem simply: ::: {custom-style="Poetry"} | A Bird came down the Walk--- | He did not know I saw--- ::: Poetry . ( docx) Default Paragraph Style ( odt) . pandoc . pandoc . . Emphasis ( ) span custom-style Emphasis . docx odt . icml object-style : ![Image with object style](myImage.jpg){object-style="fixedSizeImage"} InDesign . (Input) docx pandoc . styles docx (-f docx+styles) custom-style . custom-style . Div Span . Table . custom-style-reference.docx test : +styles: $ pandoc test/docx/custom-style-reference.docx -f docx -t markdown This is some text. This is text with an *emphasized* text style. And this is text with a **strengthened** text style. > Here is a styled paragraph that inherits from Block Text. : $ pandoc test/docx/custom-style-reference.docx -f docx+styles -t markdown ::: {custom-style="First Paragraph"} This is some text. ::: ::: {custom-style="Body Text"} This is text with an [emphasized]{custom-style="Emphatic"} text style. And this is text with a [strengthened]{custom-style="Strengthened"} text style. ::: ::: {custom-style="My Block Style"} > Here is a styled paragraph that inherits from Block Text. ::: docx reference-doc ( ) . (CUSTOM READERS AND WRITERS) pandoc Lua . (pandoc Lua Lua .) Lua . : pandoc -t data/sample.lua pandoc -f my_custom_markup_language.lua -t latex -s custom (--data-dir ). Lua Reader Pandoc AST . pandoc AST Lua . lpeg . : pandoc --print-default-data-file creole.lua ( tab stop) options Reader . Lua (render) Pandoc AST . djot-writer.lua . (template) . --standalone --template default.NAME_OF_CUSTOM_WRITER.lua templates ( Templates )..SH " (REPRODUCIBLE BUILDS)" pandoc ( EPUB docx ODT) . . SOURCE_DATE_EPOCH . SOURCE_DATE_EPOCH ( UTC). LaTeX pdf-trailer-id pandoc trailer-id () SOURCE_DATE_EPOCH . . EPUB identifier ( << EPUB>> ). (ACCESSIBLE PDFS AND PDF ARCHIVING STANDARDS) PDF . PDF . PDF (tagging) . pandoc LaTeX PDF . \DocumentMetadata LaTeX LuaLaTeX PDF pdfstandard ( ). LaTeX . PDF/A PDF/UA PDF . . (colorspace) . pandoc PDF . LaTeX pdfstandard PDF PDF/A PDF/X PDF/UA . : pandoc -V pdfstandard=ua-2 --pdf-engine=lualatex doc.md -o doc.pdf : --- pdfstandard: - ua-2 - a-4f --- PDF . LuaLaTeX TeX Live 2025 LaTeX 2025-06-01 . ConTeXt ConTeXt PDF . ConTeXt pandoc . tagging . : pandoc -t context+tagging doc.md -o doc.pdf context PDF . WeasyPrint HTML WeasyPrint PDF/A PDF/UA . : pandoc --pdf-engine=weasyprint \ --pdf-engine-opt=--pdf-variant=pdf/ua-1 ... . Prince XML HTML PDF prince PDF . : pandoc --pdf-engine=prince \ --pdf-engine-opt=--tagged-pdf ... prince . Typst Typst 0.12 PDF/A-2b : pandoc --pdf-engine=typst --pdf-engine-opt=--pdf-standard=a-2b ... (Word Processors) LibreOffice MS Word PDF . pandoc . pandoc docx odt PDF . Word LibreOffice . PANDOC (RUNNING PANDOC AS A WEB SERVER) pandoc pandoc-server ( ) pandoc server (API) JSON . pandoc . pandoc-server . pandoc pandoc-server.cgi ( ) CGI API pandoc-server . pandoc-server Haskell I/O pandoc ..SH " PANDOC LUA (RUNNING PANDOC AS A LUA INTERPRETER)" pandoc pandoc-lua lua Lua . lua . . pandoc.* re lpeg . PANDOC_VERSION PANDOC_STATE PANDOC_API_VERSION . pandoc-lua . (A NOTE ON SECURITY) 1. pandoc ( PDF ) (custom writer) . . 2. pandoc pandoc . : o ( LaTeX Org RST Typst) include . . --sandbox . o ( RTF FB2 HTML --self-contained EPUB Docx ODT) (embed) . . --sandbox . o HTML pandoc URL src iframe . HTML (SSRF) (CVE-2025-51591). --sandbox -f html+raw_html ( iframe HTML ) . o pandoc --pdf-engine --sandbox . wkhtmltopdf footer-html header-html --footer-html --header-html wkhtmltopdf file: . --pdf-engine=wkhtmltopdf -f html+raw_html SSRF wkhtmltopdf (CVE-2022-35583). wkhtmltopdf . pdf . pdf pandoc --pdf-engine-opt . pandoc : o pandoc server . (sandboxed) . o WASM pandoc . Lua WASM . o pandoc --sandbox . --filter --pdf-engine . 3. HTML pandoc . raw_html Markdown HTML . raw_html URL . HTML HTML (sanitizer) . 4. pandoc (pathological performance) . pandoc (timeout) DOS . pandoc +RTS -M512M -RTS heap . commonmark ( commonmark_x gfm) markdown . 5. pandoc Haskell ( ) pandoc PandocPure . <> . ( --sandbox .) (AUTHORS) 2006-2024 John MacFarlane (jgm@berkeley.edu). GPL . . ( COPYRIGHT .) AUTHORS.md pandoc . Pandoc . . pandoc 3.10.2 2026-08-11 pandoc(1)