Ini ialah arahan pandoc yang boleh dijalankan dalam penyedia pengehosan percuma OnWorks menggunakan salah satu daripada berbilang stesen kerja dalam talian percuma kami seperti Ubuntu Online, Fedora Online, emulator dalam talian Windows atau emulator dalam talian MAC OS.
JADUAL:
NAMA
pandoc - penukar tanda umum
SINOPSIS
pandoc [pilihan] [fail input]...
DESCRIPTION
Pandoc ialah pustaka Haskell untuk menukar daripada satu format markup kepada format lain, dan a
alat baris arahan yang menggunakan perpustakaan ini. Ia boleh membaca Markdown, CommonMark, PHP Markdown
Tambahan, Penurunan Berperisa GitHub dan (subset) Tekstil, reStructuredText, HTML, LaTeX,
Penanda MediaWiki, penanda TWiki, penanda Haddock, OPML, mod Org Emacs, DocBook, txt2tags,
EPUB, ODT dan Word docx; dan ia boleh menulis teks biasa, Markdown, CommonMark, PHP Markdown
Tambahan, Penurunan Berperisa GitHub, reStructuredText, XHTML, HTML5, LaTeX (termasuk beamer
persembahan slaid), ConTeXt, RTF, OPML, DocBook, OpenDocument, ODT, Word docx, GNU Texinfo,
Penanda MediaWiki, Penanda DokuWiki, Penanda Haddock, EPUB (v2 atau v3), Buku Fiksyen2, Tekstil,
halaman manual groff, mod Org Emacs, AsciiDoc, InDesign ICML dan Slidy, Slideous, DZSlides,
reveal.js atau rancangan slaid HTML S5. Ia juga boleh menghasilkan output PDF pada sistem di mana LaTeX,
ConTeXt, atau wkhtmltopdf dipasang.
Versi Markdown yang dipertingkatkan oleh Pandoc termasuk sintaks untuk nota kaki, jadual, fleksibel
senarai tersusun, senarai definisi, blok kod berpagar, superskrip dan subskrip,
mogok, blok metadata, jadual kandungan automatik, matematik LaTeX terbenam, petikan,
dan Markdown dalam elemen blok HTML. (Peningkatan ini, diterangkan di bawah di bawah
Penurunan Pandoc, boleh dilumpuhkan menggunakan format input atau output yang ketat_markdown.)
Berbeza dengan kebanyakan alat sedia ada untuk menukar Markdown kepada HTML, yang menggunakan regex
penggantian, pandoc mempunyai reka bentuk modular: ia terdiri daripada satu set pembaca, yang menghuraikan
teks dalam format tertentu dan menghasilkan perwakilan asli dokumen, dan satu set
penulis, yang menukar perwakilan asli ini kepada format sasaran. Oleh itu, menambah satu
format input atau output hanya memerlukan penambahan pembaca atau penulis.
Kerana perwakilan perantaraan pandoc bagi sesuatu dokumen adalah kurang ekspresif berbanding kebanyakan dokumen
format yang ditukar antaranya, seseorang tidak seharusnya mengharapkan penukaran yang sempurna antara setiap
format dan lain-lain. Pandoc cuba untuk mengekalkan unsur-unsur struktur a
dokumen, tetapi tidak memformat butiran seperti saiz margin. Dan beberapa elemen dokumen,
seperti jadual kompleks, mungkin tidak sesuai dengan model dokumen ringkas pandoc. manakala
penukaran daripada Markdown pandoc kepada semua format bercita-cita untuk menjadi sempurna, penukaran daripada
format yang lebih ekspresif daripada Markdown pandoc boleh dijangka menjadi lossy.
Menggunakan pandok
Jika tidak fail input ditentukan, input dibaca daripada stdin. Jika tidak, yang fail input adalah
bercantum (dengan garis kosong di antara setiap satu) dan digunakan sebagai input. Output pergi ke stdout by
lalai (walaupun output ke stdout dilumpuhkan untuk output odt, docx, epub dan epub3
format). Untuk output ke fail, gunakan pilihan -o:
pandoc -o output.html input.txt
Secara lalai, pandoc menghasilkan serpihan dokumen, bukan dokumen kendiri dengan betul
pengepala dan pengaki. Untuk menghasilkan dokumen kendiri, gunakan bendera -s atau --standalone:
pandoc -s -o output.html input.txt
Untuk mendapatkan maklumat lanjut tentang cara dokumen kendiri dihasilkan, lihat Templat, di bawah.
Daripada fail, URI mutlak boleh diberikan. Dalam kes ini pandoc akan mengambil
kandungan menggunakan HTTP:
pandoc -f html -t markdown http://www.fsf.org
Jika berbilang fail input diberikan, pandoc akan menggabungkan kesemuanya (dengan baris kosong
antara mereka) sebelum menghuraikan. Ciri ini dilumpuhkan untuk format input binari seperti
EPUB, odt dan docx.
Format input dan output boleh ditentukan secara eksplisit menggunakan pilihan baris arahan.
Format input boleh ditentukan menggunakan pilihan -r/--read atau -f/--from, output
format menggunakan pilihan -w/--write atau -t/--to. Oleh itu, untuk menukar hello.txt daripada Markdown
ke LaTeX, anda boleh menaip:
pandoc -f markdown -t lateks hello.txt
Untuk menukar hello.html daripada HTML kepada Markdown:
pandoc -f html -t markdown hello.html
Format output yang disokong disenaraikan di bawah di bawah pilihan -t/--to. Input yang disokong
format disenaraikan di bawah di bawah pilihan -f/--from. Perhatikan bahawa yang pertama, tekstil, lateks,
dan pembaca html tidak lengkap; terdapat beberapa binaan yang tidak dihuraikan.
Jika format input atau output tidak dinyatakan secara eksplisit, pandoc akan cuba menekanya
daripada sambungan nama fail input dan output. Oleh itu, sebagai contoh,
pandoc -o hello.tex hello.txt
akan menukar hello.txt daripada Markdown kepada LaTeX. Jika tiada fail output ditentukan (supaya
output pergi ke stdout), atau jika sambungan fail output tidak diketahui, format output
akan lalai kepada HTML. Jika tiada fail input ditentukan (supaya input datang daripada stdin), atau
jika sambungan fail input tidak diketahui, format input akan diandaikan
Markdown melainkan dinyatakan dengan jelas.
Pandoc menggunakan pengekodan aksara UTF-8 untuk kedua-dua input dan output. Jika tempatan anda
pengekodan aksara bukan UTF-8, anda harus memasukkan input dan output melalui iconv:
iconv -t utf-8 input.txt | pandoc | iconv -f utf-8
Ambil perhatian bahawa dalam beberapa format output (seperti HTML, LaTeX, ConTeXt, RTF, OPML, DocBook dan
Texinfo), maklumat tentang pengekodan aksara disertakan dalam pengepala dokumen,
yang hanya akan disertakan jika anda menggunakan pilihan -s/--standalone.
mewujudkan a PDF
Untuk menghasilkan PDF, nyatakan fail output dengan sambungan .pdf. Secara lalai, pandoc akan
gunakan LaTeX untuk menukarnya kepada PDF:
pandoc test.txt -o test.pdf
Pengeluaran PDF memerlukan enjin LaTeX dipasang (lihat --enjin lateks, di bawah),
dan menganggap bahawa pakej LaTeX berikut tersedia: amsfonts, amsmath, lm,
ifxetex, ifluatex, eurosym, penyenaraian (jika pilihan --listings digunakan), fancyvrb,
meja panjang, tab buku, graphicx dan grffile (jika dokumen mengandungi imej), hyperref,
ulem, geometri (dengan set pembolehubah geometri), setspace (dengan linestretch), dan babel
(dengan lang). Penggunaan xelatex atau lualatex sebagai enjin LaTeX memerlukan fontspec;
xelatex menggunakan mathspec, polyglossia (dengan lang), xecjk dan bidi (dengan pembolehubah dir
ditetapkan). Pakej upquote dan microtype digunakan jika tersedia, dan csquotes akan digunakan
untuk tanda baca pintar jika ditambahkan pada templat atau disertakan dalam mana-mana fail pengepala. The
Pakej natbib, biblatex, bibtex dan biber boleh digunakan secara pilihan untuk petikan
rendering. Ini disertakan dengan semua versi terkini TeX Live.
Sebagai alternatif, pandoc boleh menggunakan ConTeXt atau wkhtmltopdf untuk mencipta PDF. Untuk melakukan ini, nyatakan
fail output dengan sambungan .pdf, seperti sebelum ini, tetapi tambah konteks -t atau -t html5 pada
baris perintah.
Output PDF boleh dikawal menggunakan pembolehubah untuk LaTeX (jika LaTeX digunakan) dan pembolehubah
untuk ConTeXt (jika ConTeXt digunakan). Jika wkhtmltopdf digunakan, maka pembolehubah margin-kiri,
margin-kanan, margin-atas, margin-bawah, dan saiz kertas akan mempengaruhi output, seperti yang akan berlaku
--css.
PILIHAN
Umum pilihan
-f FORMAT, -r FORMAT, --dari=FORMAT, --baca=FORMAT
Tentukan format input. FORMAT boleh menjadi asli (Haskell asli), json (versi JSON bagi
AST asli), markdown (Penurunan lanjutan pandoc), markdown_strict (original
Markdown tidak dilanjutkan), markdown_phpextra (PHP Markdown Extra), markdown_github
(Penurunan Berperisa GitHub), tanda biasa (Penurunan Tanda Biasa), tekstil (Tekstil),
pertama (reStructuredText), html (HTML), docbook (DocBook), t2t (txt2tags), docx
(docx), odt (ODT), epub (EPUB), opml (OPML), org (mod Org Emacs), mediawiki
(penanda MediaWiki), twiki (penanda TWiki), haddock (penanda Haddock), atau lateks
(LaTeX). Jika +lhs dilampirkan pada penurunan harga, pertama, lateks atau html, inputnya ialah
dianggap sebagai celik sumber Haskell: lihat sokongan Literate Haskell, di bawah. Markdown
sambungan sintaks boleh didayakan atau dilumpuhkan secara individu dengan menambahkan +SAMBUNGAN
atau -SAMBUNGAN kepada nama format. Jadi, sebagai contoh,
markdown_strict+footnotes+definition_lists ialah Markdown yang ketat dengan nota kaki dan
senarai definisi didayakan, dan markdown-pipe_tables+hard_line_breaks adalah milik pandoc
Penurunan harga tanpa jadual paip dan dengan pemecahan garis keras. Lihat Penurunan Harga Pandoc,
di bawah, untuk senarai sambungan dan nama mereka.
-t FORMAT, -w FORMAT, --ke=FORMAT, --tulis=FORMAT
Nyatakan format output. FORMAT boleh menjadi asli (Haskell asli), json (versi JSON
AST asli), biasa (teks biasa), penurunan nilai (Penurunan lanjutan pandoc),
markdown_strict (Markdown asal tidak dilanjutkan), markdown_phpextra (PHP Markdown
Tambahan), markdown_github (GitHub-Flavored Markdown), commonmark (CommonMark
Markdown), pertama (reStructuredText), html (XHTML), html5 (HTML5), lateks (LaTeX),
beamer (pertunjukan slaid beamer LaTeX), konteks (ConTeXt), man (groff man), mediawiki
(penanda MediaWiki), dokuwiki (penanda DokuWiki), tekstil (Tekstil), org (Emacs Org
mod), texinfo (GNU Texinfo), opml (OPML), docbook (DocBook), opendocument
(OpenDocument), odt (dokumen teks OpenOffice), docx (Word docx), haddock (Haddock
markup), rtf (format teks kaya), epub (buku EPUB v2), epub3 (EPUB v3), fb2
(e-book FictionBook2), asciidoc (AsciiDoc), icml (InDesign ICML), licin (Slidy HTML
dan persembahan slaid javascript), slaid (Slideous HTML dan persembahan slaid javascript),
dzslides (DZSlides HTML5 + rancangan slaid javascript), revealjs (reveal.js HTML5 +
persembahan slaid javascript), s5 (S5 HTML dan persembahan slaid javascript), atau laluan a
penulis lua tersuai (lihat Penulis tersuai, di bawah). Ambil perhatian bahawa odt, epub dan epub3
output tidak akan diarahkan ke stdout; nama fail output mesti dinyatakan menggunakan
pilihan -o/--output. Jika +lhs dilampirkan pada markdown, pertama, lateks, beamer, html,
atau html5, output akan dipaparkan sebagai celik sumber Haskell: lihat Celik
Sokongan Haskell, di bawah. Sambungan sintaks penurunan harga boleh didayakan secara individu atau
dilumpuhkan dengan menambahkan +EXTENSION atau -EXTENSION pada nama format, seperti yang diterangkan
atas bawah -f.
-o FAIL, --output=FAIL
Tulis output ke FAIL bukan stdout. Jika FAIL ialah -, output akan pergi ke stdout.
(Pengecualian: jika format output ialah odt, docx, epub, atau epub3, output kepada stdout ialah
kurang upaya.)
--data-dir=DIREKTORI
Tentukan direktori data pengguna untuk mencari fail data pandoc. Jika pilihan ini adalah
tidak dinyatakan, direktori data pengguna lalai akan digunakan. Ini adalah, dalam Unix:
$HOME/.pandoc
dalam Windows XP:
C:\Documents And Settings\USERNAME\Application Data\pandoc
dan dalam Windows Vista atau lebih baru:
C:\Users\USERNAME\AppData\Roaming\pandoc
Anda boleh mencari direktori data pengguna lalai pada sistem anda dengan melihat pada
keluaran pandoc --version. A reference.odt, reference.docx, epub.css, templates,
direktori slidy, slideous atau s5 yang diletakkan dalam direktori ini akan mengatasi pandoc's
lalai biasa.
--bash-completion
Hasilkan skrip penyiapan bash. Untuk mendayakan penyiapan bash dengan pandoc, tambahkan ini
ke .bashrc anda:
eval "$(pandoc --bash-completion)"
--verbose
Beri keluaran penyahpepijatan verbose. Pada masa ini ini hanya mempunyai kesan dengan output PDF.
-v, --versi
Versi cetakan.
-h, - membantu
Tunjukkan mesej penggunaan.
Pembaca pilihan
-R, --parse-raw
Menghuraikan kod HTML yang tidak boleh diterjemahkan dan persekitaran LaTeX sebagai HTML mentah atau LaTeX,
bukannya mengabaikan mereka. Mempengaruhi input HTML dan LaTeX sahaja. HTML mentah boleh
dicetak dalam Markdown, reStructuredText, HTML, Slidy, Slideous, DZSlides, reveal.js,
dan keluaran S5; LaTeX mentah boleh dicetak dalam Markdown, reStructuredText, LaTeX dan
Output ConTeXt. Lalai adalah untuk pembaca meninggalkan kod HTML yang tidak boleh diterjemahkan
dan persekitaran LaTeX. (Pembaca LaTeX memang melalui LaTeX yang tidak boleh diterjemahkan
arahan, walaupun -R tidak dinyatakan.)
-S, --pintar
Menghasilkan output yang betul dari segi tipografi, menukar petikan lurus kepada petikan kerinting,
--- kepada em-sempang, -- kepada en-sempang, dan ... kepada elips. Ruang tanpa pecah adalah
disisipkan selepas singkatan tertentu, seperti "Encik." (Nota: Pilihan ini dipilih
secara automatik apabila format output adalah lateks atau konteks, melainkan --no-tex-ligatures
digunakan. Ia tidak mempunyai kesan untuk input lateks.)
--sengkang-lama
Memilih tingkah laku pandoc <= 1.8.2.1 untuk menghuraikan sempang pintar: - sebelum angka
ialah en-dash, dan -- ialah em-dash. Pilihan ini dipilih secara automatik untuk
input tekstil.
--base-header-level=NOMBOR
Tentukan tahap asas untuk pengepala (lalai kepada 1).
--indented-code-classes=KELAS
Tentukan kelas untuk digunakan untuk blok kod inden--contohnya, perl,numberLines atau
haskell. Berbilang kelas boleh dipisahkan dengan ruang atau koma.
--default-image-extension=SAMBUNGAN
Tentukan sambungan lalai untuk digunakan apabila laluan imej/URL tidak mempunyai sambungan. ini
membolehkan anda menggunakan sumber yang sama untuk format yang memerlukan pelbagai jenis
imej. Pada masa ini pilihan ini hanya memberi kesan kepada pembaca Markdown dan LaTeX.
--penapis=BOLEH DILAKSANAKAN
Tentukan boleh laku untuk digunakan sebagai penapis mengubah AST pandoc selepas
input dihuraikan dan sebelum output ditulis. Boleh laku harus membaca JSON
dari stdin dan tulis JSON ke stdout. JSON mesti diformat seperti pandoc sendiri
Input dan output JSON. Nama format output akan dihantar ke penapis
sebagai hujah pertama. Oleh itu,
pandoc --filter ./caps.py -t lateks
adalah bersamaan dengan
pandoc -t json | ./caps.py lateks | pandoc -f json -t lateks
Bentuk terakhir mungkin berguna untuk menyahpepijat penapis.
Penapis boleh ditulis dalam mana-mana bahasa. Text.Pandoc.JSON mengeksport keJSONFilter ke
memudahkan menulis penapis dalam Haskell. Mereka yang lebih suka menulis penapis dalam
python boleh menggunakan modul pandocfilters, boleh dipasang dari PyPI. Terdapat juga
perpustakaan penapis pandoc dalam PHP, perl dan javascript/node.js.
Ambil perhatian bahawa BOLEH DILAKSANAKAN akan dicari dalam PATH pengguna, dan bukan dalam kerja
direktori, jika tiada direktori disediakan. Jika anda ingin menjalankan skrip dalam kerja
direktori, prakatakan nama fail dengan ./.
-M UTAMA[=VAL], --metadata=UTAMA[:VAL]
Tetapkan medan metadata UTAMA kepada nilai VAL. Nilai yang ditentukan pada baris arahan
mengatasi nilai yang ditentukan dalam dokumen. Nilai akan dihuraikan sebagai boolean YAML
atau nilai rentetan. Jika tiada nilai dinyatakan, nilai tersebut akan dianggap sebagai Boolean
benar. Seperti --variable, --metadata menyebabkan pembolehubah templat ditetapkan. Tetapi tidak seperti
--variable, --metadata mempengaruhi metadata dokumen asas (iaitu
boleh diakses daripada penapis dan boleh dicetak dalam beberapa format output).
--normalkan
Normalkan dokumen selepas membaca: gabungkan elemen Str atau Emph bersebelahan, untuk
contoh, dan alih keluar Spaces berulang.
-p, --preserve-tabs
Kekalkan tab dan bukannya menukarnya kepada ruang (lalai). Perhatikan bahawa ini
hanya akan menjejaskan tab dalam rentang kod literal dan blok kod; tab dalam teks biasa
akan dianggap sebagai ruang.
--tab-stop=NOMBOR
Nyatakan bilangan ruang bagi setiap tab (lalai ialah 4).
--track-changes=accept|tolak|semua
Menentukan perkara yang perlu dilakukan dengan sisipan dan pemadaman yang dihasilkan oleh MS Word "Track
Perubahan" ciri. terima (lalai), memasukkan semua sisipan dan mengabaikan semua
pemadaman. menolak memasukkan semua pemadaman dan mengabaikan sisipan. semua meletakkan kedua-duanya
sisipan dan pemadaman, dibalut dalam rentang dengan kelas sisipan dan pemadaman,
masing-masing. Pengarang dan masa perubahan disertakan. semua berguna untuk
skrip: hanya menerima perubahan daripada pengulas tertentu, katakan, atau sebelum yang tertentu
Tarikh. Pilihan ini hanya mempengaruhi pembaca docx.
--ekstrak-media=DIR
Ekstrak imej dan media lain yang terkandung dalam bekas docx atau epub ke laluan
DIR, menciptanya jika perlu, dan laraskan rujukan imej dalam dokumen supaya
mereka menunjuk ke fail yang diekstrak. Pilihan ini hanya mempengaruhi docx dan epub
pembaca.
Umum penulis pilihan
-ya, --berdiri sendiri
Menghasilkan output dengan pengepala dan pengaki yang sesuai (cth HTML kendiri,
LaTeX, atau fail RTF, bukan serpihan). Pilihan ini ditetapkan secara automatik untuk pdf,
epub, epub3, fb2, docx dan output odt.
--template=FAIL
Penggunaan FAIL sebagai templat tersuai untuk dokumen yang dijana. Menyiratkan --berdiri sendiri.
Lihat Templat, di bawah, untuk penerangan sintaks templat. Jika tiada sambungan
ditentukan, sambungan yang sepadan dengan penulis akan ditambah, supaya
--template=special mencari special.html untuk output HTML. Jika templat tidak
dijumpai, pandoc akan mencarinya dalam subdirektori templat data pengguna
direktori (lihat --data-dir). Jika pilihan ini tidak digunakan, templat lalai
sesuai untuk format output akan digunakan (lihat -D/--print-default-template).
-V UTAMA[=VAL], --pembolehubah=UTAMA[:VAL]
Tetapkan pembolehubah templat UTAMA kepada nilai VAL semasa membuat dokumen masuk
mod kendiri. Ini biasanya hanya berguna apabila pilihan --template digunakan
untuk menentukan templat tersuai, kerana pandoc secara automatik menetapkan pembolehubah yang digunakan dalam
templat lalai. Jika tidak VAL ditentukan, kunci akan diberi nilai
benar.
-D FORMAT, --print-default-template=FORMAT
Cetak templat lalai sistem untuk output FORMAT. (Lihat -t untuk senarai
mungkin FORMATs.) Templat dalam direktori data pengguna diabaikan.
--print-default-data-file=FAIL
Cetak fail data lalai sistem. Fail dalam direktori data pengguna diabaikan.
--dpi=NOMBOR
Tentukan nilai dpi (titik per inci) untuk penukaran daripada piksel kepada
inci/sentimeter dan sebaliknya. Lalai ialah 96dpi. Secara teknikal, betul
istilah ialah ppi (piksel per inci).
--wrap=[auto|tiada|pelihara]
Tentukan cara teks dibalut dalam output (kod sumber, bukan render
versi). Dengan auto (lalai), pandoc akan cuba membalut baris ke lajur
lebar ditentukan oleh --columns (lalai 80). Dengan tiada, pandoc tidak akan membalut baris
sama sekali. Dengan pemuliharaan, pandoc akan cuba untuk mengekalkan pembalut dari
dokumen sumber (iaitu, jika terdapat baris baharu yang tidak semantik dalam sumber, di sana
akan menjadi baris baharu yang tidak semantik dalam output juga).
--tidak-bungkus
Sinonim ditamatkan untuk --wrap=none.
--lajur=NOMBOR
Tentukan panjang baris dalam aksara (untuk pembalut teks). Ini hanya memberi kesan kepada
kod sumber yang dijana, bukan reka letak pada halaman yang diberikan.
--toc, --isi kandungan
Sertakan jadual kandungan yang dijana secara automatik (atau, dalam kes lateks,
konteks, dan pertama, arahan untuk mencipta satu) dalam dokumen output. ini
pilihan tidak mempunyai kesan pada man, docbook, slidy, slideous, s5, docx, atau output odt.
--toc-depth=NOMBOR
Nyatakan bilangan peringkat bahagian untuk dimasukkan ke dalam jadual kandungan. The
lalai ialah 3 (yang bermaksud pengepala tahap 1, 2 dan 3 akan disenaraikan dalam
kandungan).
--tiada-highlight
Melumpuhkan penyerlahan sintaks untuk blok kod dan sebaris, walaupun dalam bahasa
atribut diberikan.
--gaya-highlight=STYLE
Menentukan gaya pewarna yang akan digunakan dalam kod sumber yang diserlahkan. Pilihan adalah
pygments (lalai), kate, monokrom, espreso, zenburn, haddock dan tango.
Untuk mendapatkan maklumat lanjut tentang penonjolan sintaks dalam pandoc, lihat Penonjolan sintaks,
di bawah.
-H FAIL, --include-in-header=FAIL
Sertakan kandungan FAIL, verbatim, di hujung tajuk. Ini boleh digunakan,
contohnya, untuk memasukkan CSS atau javascript khas dalam dokumen HTML. Pilihan ini
boleh digunakan berulang kali untuk memasukkan berbilang fail dalam pengepala. Mereka akan
termasuk dalam susunan yang dinyatakan. Menyiratkan --berdiri sendiri.
-B FAIL, --termasuk-sebelum-badan=FAIL
Sertakan kandungan FAIL, verbatim, pada permulaan badan dokumen (cth
selepas teg dalam HTML, atau perintah \begin{document} dalam LaTeX). Ini boleh
digunakan untuk memasukkan bar navigasi atau sepanduk dalam dokumen HTML. Pilihan ini boleh
digunakan berulang kali untuk memasukkan berbilang fail. Mereka akan dimasukkan ke dalam pesanan
ditentukan. Menyiratkan --berdiri sendiri.
-A FAIL, --termasuk-selepas-badan=FAIL
Sertakan kandungan FAIL, verbatim, di hujung badan dokumen (sebelum
teg dalam HTML, atau perintah \end{document} dalam LaTeX). Pilihan ini boleh
digunakan berulang kali untuk memasukkan berbilang fail. Mereka akan dimasukkan ke dalam pesanan
ditentukan. Menyiratkan --berdiri sendiri.
Pilihan menjejaskan khusus penulis
--berdikari
Hasilkan fail HTML kendiri tanpa kebergantungan luaran, menggunakan data: URIs to
menggabungkan kandungan skrip terpaut, helaian gaya, imej dan video. The
fail yang terhasil hendaklah "berdikari," dalam erti kata ia tidak memerlukan luaran
fail dan tiada akses bersih untuk dipaparkan dengan betul oleh pelayar. Pilihan ini berfungsi
hanya dengan format output HTML, termasuk html, html5, html+lhs, html5+lhs, s5,
licin, slaid, dzslide dan revealjs. Skrip, imej dan helaian gaya di
URL mutlak akan dimuat turun; mereka yang berada di URL relatif akan dicari secara relatif
direktori kerja (jika fail sumber pertama adalah setempat) atau relatif kepada pangkalan
URL (jika fail sumber pertama adalah jauh). Had: sumber yang dimuatkan
secara dinamik melalui JavaScript tidak boleh digabungkan; Akibatnya,
--self-contained tidak berfungsi dengan --mathjax, dan beberapa ciri lanjutan (cth
zum atau nota pembesar suara) mungkin tidak berfungsi dalam slaid reveal.js "berlengkap" luar talian
show.
--html-q-tags
Gunakan tag untuk petikan dalam HTML.
--ascii
Gunakan hanya aksara ascii dalam output. Pada masa ini disokong hanya untuk output HTML
(yang menggunakan entiti berangka dan bukannya UTF-8 apabila pilihan ini dipilih).
--rujukan-pautan
Gunakan pautan gaya rujukan, bukannya pautan sebaris, secara bertulis Markdown atau
reStructuredText. Secara lalai pautan dalam talian digunakan.
--atx-headers
Gunakan pengepala gaya ATX dalam Markdown dan output asciidoc. Lalai adalah untuk menggunakan
pengepala gaya seteks untuk tahap 1-2, dan kemudian pengepala ATX.
--bab
Anggap pengepala peringkat atas sebagai bab dalam output LaTeX, ConTeXt dan DocBook. Bila
kelas dokumen LaTeX ditetapkan untuk melaporkan, menempah atau memoir, pilihan ini tersirat.
Jika beamer ialah format output, pengepala peringkat atas akan menjadi \bahagian{..}.
-N, --bahagian-nombor
Tajuk bahagian nombor dalam output LaTeX, ConTeXt, HTML atau EPUB. Secara lalai,
bahagian tidak bernombor. Bahagian dengan kelas tidak bernombor tidak akan dinomborkan,
walaupun --number-sections ditentukan.
--nombor-offset=NOMBOR[,NOMBOR,...]
Offset untuk tajuk bahagian dalam output HTML (diabaikan dalam format output lain). The
nombor pertama ditambahkan pada nombor bahagian untuk pengepala peringkat atas, yang kedua untuk
pengepala peringkat kedua, dan seterusnya. Jadi, sebagai contoh, jika anda mahukan peringkat teratas yang pertama
pengepala dalam dokumen anda untuk bernombor "6", nyatakan --number-offset=5. Jika anda
dokumen bermula dengan pengepala tahap-2 yang anda mahu diberi nombor "1.5", nyatakan
--number-offset=1,4. Offset ialah 0 secara lalai. Menyiratkan --number-bahagian.
--tiada-tex-ligatures
Jangan gunakan ligatur TeX untuk tanda petikan, apostrof dan sempang (`...',
``..'', --, ---) apabila menulis atau membaca LaTeX atau ConTeXt. Dalam membaca LaTeX, huraikan
aksara `, ', dan - secara literal, bukannya menghuraikan ligatur untuk petikan
tanda dan sempang. Dalam penulisan LaTeX atau ConTeXt, cetak tanda petikan unikod dan
aksara sempang secara literal, dan bukannya menukarnya kepada ASCII TeX standard
ligatur. Nota: biasanya --smart dipilih secara automatik untuk LaTeX dan ConTeXt
output, tetapi ia mesti dinyatakan secara eksplisit jika --no-tex-ligatures dipilih. Jika
anda menggunakan petikan kerinting literal, sengkang dan elips dalam sumber anda, maka anda boleh
mahu menggunakan --no-tex-ligatures tanpa --smart.
--penyenaraian
Gunakan pakej penyenaraian untuk blok kod LaTeX
-saya, --bertambah
Buat item senarai dalam tayangan slaid dipaparkan secara berperingkat (satu per satu). Lalainya ialah
untuk senarai dipaparkan sekali gus.
--tahap slaid=NOMBOR
Menentukan bahawa pengepala dengan tahap yang ditentukan membuat slaid (untuk beamer, s5,
licin, gelongsor, dzslides). Tajuk di atas tahap ini dalam hierarki sudah biasa
bahagikan persembahan slaid kepada bahagian; pengepala di bawah tahap ini mencipta subtajuk
dalam slaid. Lalai adalah untuk menetapkan tahap slaid berdasarkan kandungan
dokumen; lihat Menstrukturkan tayangan slaid.
--bahagian-div
Balut bahagian dalam tag (atau teg dalam HTML5), dan lampirkan pengecam pada
yang melampirkan (atau ) dan bukannya pengepala itu sendiri. Lihat Pengepala
pengecam, di bawah.
--email-obfuscation=none|javascript|rujukan
Tentukan kaedah untuk mengelirukan pautan mailto: dalam dokumen HTML. tiada yang pergi
mailto: pautan sebagaimana adanya. javascript mengaburkan mereka menggunakan javascript.
rujukan mengelirukan mereka dengan mencetak huruf mereka sebagai perpuluhan atau perenambelasan
rujukan watak. Lalai ialah javascript.
--id-prefix=TALI
Tentukan awalan untuk ditambahkan pada semua pengecam yang dijana secara automatik dalam HTML dan
Output DocBook dan nombor nota kaki dalam output Markdown. Ini berguna untuk
menghalang pengecam pendua apabila menjana serpihan untuk dimasukkan ke dalam yang lain
halaman.
-T TALI, --tajuk-awalan=TALI
Tentukan TALI sebagai awalan pada permulaan tajuk yang muncul dalam HTML
pengepala (tetapi bukan dalam tajuk seperti yang muncul pada permulaan badan HTML).
Menyiratkan --berdiri sendiri.
-c URL, --css=URL
Pautan ke helaian gaya CSS. Pilihan ini boleh digunakan berulang kali untuk disertakan
berbilang fail. Mereka akan dimasukkan ke dalam pesanan yang ditentukan.
--reference-odt=FAIL
Gunakan fail yang ditentukan sebagai rujukan gaya dalam menghasilkan ODT. Untuk hasil terbaik,
ODT rujukan mestilah versi diubah suai bagi ODT yang dihasilkan menggunakan pandoc.
Kandungan ODT rujukan diabaikan, tetapi lembaran gayanya digunakan dalam
ODT baharu. Jika tiada rujukan ODT dinyatakan pada baris arahan, pandoc akan kelihatan
untuk rujukan fail.odt dalam direktori data pengguna (lihat --data-dir). Jika ini
tidak ditemui sama ada, lalai yang wajar akan digunakan.
--reference-docx=FAIL
Gunakan fail yang ditentukan sebagai rujukan gaya dalam menghasilkan fail docx. Untuk yang terbaik
keputusan, docx rujukan hendaklah versi diubah suai bagi fail docx yang dihasilkan
menggunakan pandoc. Kandungan docx rujukan diabaikan, tetapi helaian gayanya
dan sifat dokumen (termasuk jidar, saiz halaman, pengepala dan pengaki) digunakan
dalam docx baharu. Jika tiada docx rujukan dinyatakan pada baris arahan, pandoc
akan mencari reference.docx fail dalam direktori data pengguna (lihat --data-dir).
Jika ini tidak ditemui sama ada, lalai yang wajar akan digunakan. Gaya berikut
digunakan oleh pandoc: [perenggan] Normal, Teks Badan, Perenggan Pertama, Padat, Tajuk,
Sarikata, Pengarang, Tarikh, Abstrak, Bibliografi, Tajuk 1, Tajuk 2, Tajuk 3,
Tajuk 4, Tajuk 5, Tajuk 6, Teks Blok, Teks Nota Kaki, Istilah Definisi,
Takrif, Kapsyen, Kapsyen Jadual, Kapsyen Imej, Rajah, Rajah Dengan Kapsyen, TOC
Tajuk; [karakter] Fon Perenggan Lalai, Aksara Teks Badan, Aksara Verbatim,
Rujukan Nota Kaki, Hiperpautan; [jadual] Jadual Biasa.
--epub-stylesheet=FAIL
Gunakan fail CSS yang ditentukan untuk menggayakan EPUB. Jika tiada lembaran gaya dinyatakan,
pandoc akan mencari fail epub.css dalam direktori data pengguna (lihat --data-dir).
Jika ia tidak ditemui di sana, lalai yang wajar akan digunakan.
--epub-cover-image=FAIL
Gunakan imej yang ditentukan sebagai penutup EPUB. Adalah disyorkan bahawa imej itu
kurang daripada 1000px lebar dan tinggi. Ambil perhatian bahawa dalam dokumen sumber Markdown anda
juga boleh menentukan imej muka depan dalam blok metadata YAML (lihat Metadata EPUB, di bawah).
--epub-metadata=FAIL
Lihat dalam fail XML yang ditentukan untuk metadata untuk EPUB. Fail harus mengandungi
satu siri elemen Teras Dublin. Sebagai contoh:
Creative Commons
es-AR
Secara lalai, pandoc akan menyertakan elemen metadata berikut: (daripada
tajuk dokumen), (daripada pengarang dokumen), (daripada
tarikh dokumen, yang sepatutnya dalam format ISO 8601), (dari lang
pembolehubah, atau, jika tidak ditetapkan, tempat), dan (a
UUID yang dijana secara rawak). Mana-mana daripada ini mungkin ditindih oleh unsur-unsur dalam
fail metadata.
Nota: jika dokumen sumber ialah Markdown, blok metadata YAML dalam dokumen boleh
digunakan sebaliknya. Lihat di bawah di bawah Metadata EPUB.
--epub-embed-font=FAIL
Benamkan fon yang ditentukan dalam EPUB. Pilihan ini boleh diulang untuk membenamkan
berbilang fon. Kad bebas juga boleh digunakan: contohnya, DejaVuSans-*.ttf.
Walau bagaimanapun, jika anda menggunakan kad bebas pada baris arahan, pastikan anda melarikan diri atau meletakkannya
keseluruhan nama fail dalam petikan tunggal, untuk mengelakkannya daripada ditafsirkan oleh
cangkerang. Untuk menggunakan fon terbenam, anda perlu menambah pengisytiharan seperti
mengikuti CSS anda (lihat --epub-stylesheet):
@font-face {
font-family: DejaVuSans;
gaya fon: biasa;
berat-font: normal;
src:url("DejaVuSans-Regular.ttf");
}
@font-face {
font-family: DejaVuSans;
gaya fon: biasa;
font-weight: bold;
src:url("DejaVuSans-Bold.ttf");
}
@font-face {
font-family: DejaVuSans;
gaya fon: condong;
berat-font: normal;
src:url("DejaVuSans-Oblique.ttf");
}
@font-face {
font-family: DejaVuSans;
gaya fon: condong;
font-weight: bold;
src:url("DejaVuSans-BoldOblique.ttf");
}
badan { font-family: "DejaVuSans"; }
--epub-chapter-level=NOMBOR
Tentukan tahap pengepala untuk memisahkan EPUB kepada fail "bab" yang berasingan.
Lalai adalah untuk dibahagikan kepada bab pada tajuk tahap 1. Pilihan ini hanya memberi kesan
komposisi dalaman EPUB, bukan cara bab dan bahagian
dipaparkan kepada pengguna. Sesetengah pembaca mungkin lambat jika fail bab terlalu besar,
jadi untuk dokumen besar dengan sedikit pengepala tahap 1, seseorang mungkin mahu menggunakan bab
tahap 2 atau 3.
--lateks-enjin=pdflatex|lualatex|xelatex
Gunakan enjin LaTeX yang ditentukan apabila menghasilkan output PDF. Lalai ialah pdflatex.
Jika enjin tiada dalam PATH anda, laluan penuh enjin mungkin ditentukan
di sini.
--enjin-lateks-opt=TALI
Gunakan rentetan yang diberikan sebagai hujah baris arahan kepada enjin lateks. Jika digunakan
beberapa kali, hujah disediakan dengan ruang di antara mereka. Perhatikan bahawa tidak
semak untuk pilihan pendua telah dilakukan.
Nama rendering
--bibliografi=FAIL
Tetapkan medan bibliografi dalam metadata dokumen kepada FAIL, mengatasi sebarang nilai
ditetapkan dalam metadata, dan proses petikan menggunakan pandoc-citeproc. (Ini adalah
bersamaan dengan --metadata bibliography=FILE --filter pandoc-citeproc.) Jika --natbib
atau --biblatex juga dibekalkan, pandoc-citeproc tidak digunakan, menjadikan ini setara
kepada --metadata bibliography=FILE. Jika anda membekalkan hujah ini beberapa kali, setiap satu
FAIL akan ditambah ke dalam bibliografi.
--csl=FAIL
Tetapkan medan csl dalam metadata dokumen kepada FAIL, mengatasi sebarang nilai yang ditetapkan
metadata tersebut. (Ini bersamaan dengan --metadata csl=FILE.) Pilihan ini hanya
relevan dengan pandoc-citeproc.
--singkatan-kutipan=FAIL
Tetapkan medan singkatan petikan dalam metadata dokumen kepada FAIL, mengatasi
sebarang nilai yang ditetapkan dalam metadata. (Ini bersamaan dengan
--metadata citation-abbreviations=FILE.) Pilihan ini hanya berkaitan dengan
pandoc-citeproc.
--natbib
Gunakan natbib untuk petikan dalam output LaTeX. Pilihan ini bukan untuk digunakan dengan
penapis pandoc-citeproc atau dengan output PDF. Ia bertujuan untuk digunakan dalam menghasilkan a
Fail LaTeX yang boleh diproses dengan bibtex.
--biblatex
Gunakan biblatex untuk petikan dalam output LaTeX. Pilihan ini bukan untuk digunakan dengan
penapis pandoc-citeproc atau dengan output PDF. Ia bertujuan untuk digunakan dalam menghasilkan a
Fail LaTeX yang boleh diproses dengan bibtex atau biber.
Matematik rendering in HTML
-m [URL], --latexmathm[=URL]
Gunakan LaTeXMathML untuk memaparkan matematik TeX terbenam dalam output HTML. The URL sepatutnya menunjuk
kepada skrip muatkan LaTeXMathML.js. Sekiranya URL tidak disediakan, pautan ke
LaTeXMathML.js di Halaman Utama LaTeXMathML akan dimasukkan.
--mathml[=URL]
Tukar matematik TeX kepada MathML (dalam buku dokumen serta html dan html5). Dalam kendiri
html output, javascript kecil (atau pautan ke skrip sedemikian jika a URL dibekalkan)
akan dimasukkan yang membolehkan MathML dilihat pada beberapa pelayar.
--jsmath[=URL]
Gunakan jsMath untuk memaparkan matematik TeX terbenam dalam output HTML. The URL harus menunjukkan
skrip muat jsMath (cth jsMath/easy/load.js); jika disediakan, ia akan dipautkan
ke dalam pengepala dokumen HTML kendiri. Sekiranya URL tidak disediakan, tiada pautan
ke skrip muat jsMath akan dimasukkan; maka terpulang kepada penulis untuk menyediakan
pautan sedemikian dalam templat HTML.
--mathjax[=URL]
Gunakan MathJax untuk memaparkan matematik TeX terbenam dalam output HTML. The URL harus menunjukkan
skrip muatkan MathJax.js. Sekiranya URL tidak disediakan, pautan ke CDN MathJax
akan dimasukkan.
--gladtex
Sertakan matematik TeX ke dalam tag dalam output HTML. Ini kemudiannya boleh diproses oleh
gladTeX untuk menghasilkan pautan kepada imej formula set taip.
--mimetex[=URL]
Render TeX matematik menggunakan skrip CGI mimeTeX. Jika URL tidak dinyatakan, ia adalah
diandaikan bahawa skrip berada di /cgi-bin/mimetex.cgi.
--webtex[=URL]
Render formula TeX menggunakan skrip luaran yang menukar formula TeX kepada imej.
Formula akan digabungkan dengan URL yang disediakan. Jika URL tidak dinyatakan,
API Carta Google akan digunakan.
--katex[=URL]
Gunakan KaTeX untuk memaparkan matematik TeX terbenam dalam output HTML. The URL harus menunjukkan kepada
katex.js memuatkan skrip. Sekiranya URL tidak disediakan, pautan ke CDN KaTeX akan disediakan
dimasukkan.
--katex-stylesheet=URL
. URL hendaklah menunjuk ke lembaran gaya katex.css. Jika pilihan ini tidak dinyatakan,
pautan ke CDN KaTeX akan dimasukkan. Ambil perhatian bahawa pilihan ini tidak membayangkan
--katex.
Pilihan khususnya pembalut skrip
--dump-args
Cetak maklumat tentang argumen baris arahan ke stdout, kemudian keluar. Pilihan ini
bertujuan terutamanya untuk digunakan dalam skrip pembalut. Baris pertama keluaran
mengandungi nama fail output yang ditentukan dengan pilihan -o, atau - (untuk
stdout) jika tiada fail output dinyatakan. Baris selebihnya mengandungi
argumen baris perintah, satu setiap baris, dalam susunan yang muncul. Ini tidak
sertakan pilihan pandoc biasa dan hujahnya, tetapi masukkan sebarang pilihan
muncul selepas pemisah -- di hujung baris.
--abaikan-args
Abaikan hujah baris arahan (untuk digunakan dalam skrip pembalut). Pilihan pandoc biasa
tidak diabaikan. Oleh itu, sebagai contoh,
pandoc --ignore-args -o foo.html -s foo.txt -- -e latin1
adalah bersamaan dengan
pandoc -o foo.html -s
Kerangka
Apabila pilihan -s/--berdiri sendiri digunakan, pandoc menggunakan templat untuk menambah pengepala dan pengaki
bahan yang diperlukan untuk dokumen berdiri sendiri. Untuk melihat templat lalai iaitu
digunakan, taip sahaja
pandoc -D *FORMAT*
di mana FORMAT ialah nama format output. Templat tersuai boleh ditentukan menggunakan
pilihan --template. Anda juga boleh mengatasi templat lalai sistem untuk sesuatu yang diberikan
format output FORMAT dengan meletakkan fail templat/lalai.*FORMAT* dalam data pengguna
direktori (lihat --data-dir, di atas). Pengecualian: Untuk output odt, sesuaikan
templat default.opendocument. Untuk output pdf, sesuaikan templat default.latex.
Templat mengandungi pembolehubah, yang membenarkan kemasukan maklumat sewenang-wenangnya di mana-mana
titik dalam fail. Pembolehubah boleh ditetapkan dalam dokumen menggunakan blok metadata YAML.
Ia juga boleh ditetapkan pada baris arahan menggunakan pilihan -V/--pembolehubah: pembolehubah ditetapkan
dengan cara ini mengatasi medan metadata dengan nama yang sama.
Pembolehubah menetapkan by pandok
Sesetengah pembolehubah ditetapkan secara automatik oleh pandoc. Ini berbeza-beza bergantung pada
format output, tetapi sertakan medan metadata serta yang berikut:
tajuk, pengarang, tarikh
membenarkan pengenalpastian aspek asas dokumen. Termasuk dalam metadata PDF
melalui LaTeX dan ConTeXt. Ini boleh ditetapkan melalui blok tajuk pandoc, yang
membenarkan berbilang pengarang, atau melalui blok metadata YAML:
---
pengarang:
- Aristotle
- Peter Abelard
...
subtitle
sari kata dokumen, disertakan dalam HTML, EPUB, LaTeX, ConTeXt dan Word docx; memaparkan
dalam LaTeX hanya apabila menggunakan kelas dokumen yang menyokong \subtitle, seperti beamer
atau siri Skrip KOMA (scrartcl, scrreprt, scrbook).
abstrak
ringkasan dokumen, disertakan dalam LaTeX, ConTeXt, AsciiDoc dan Word docx
kata kunci
senarai kata kunci untuk disertakan dalam metadata HTML, PDF dan AsciiDoc; mungkin
diulang seperti untuk pengarang, di atas
tajuk-termasuk
kandungan yang ditentukan oleh -H/--include-in-header (mungkin mempunyai berbilang nilai)
palsu nilai bukan nol jika --toc/--table-of-contents telah ditentukan
tajuk-toc
tajuk jadual kandungan (hanya berfungsi dengan EPUB dan docx)
sertakan-sebelum ini
kandungan yang ditentukan oleh -B/--include-before-body (mungkin mempunyai berbilang nilai)
termasuk-selepas
kandungan yang ditentukan oleh -A/--include-after-body (mungkin mempunyai berbilang nilai)
badan badan dokumen
meta-json
Perwakilan JSON bagi semua metadata dokumen
Bahasa pembolehubah
lang mengenal pasti bahasa utama dokumen, menggunakan kod mengikut BCP 47
(cth en atau en-GB). Untuk beberapa format output, pandoc akan menukarnya kepada format
format yang sesuai disimpan dalam pembolehubah tambahan babel-lang, polyglossia-lang
(LaTeX) dan context-lang (ConTeXt).
Rentang dan div pandoc asli dengan atribut lang (nilai dalam BCP 47) boleh digunakan
untuk menukar bahasa dalam julat itu.
bahasa lain
senarai bahasa lain yang digunakan dalam dokumen dalam metadata YAML, menurut
BCP 47. Contohnya: bahasa lain: [en-GB, fr]. Ini dijana secara automatik
daripada atribut lang dalam semua rentang dan div tetapi boleh diganti. Pada masa ini
hanya digunakan oleh LaTeX melalui babel-otherlangs yang dihasilkan dan
pembolehubah polyglossia-lain-lain. Penulis LaTeX mengeluarkan arahan polyglossia dalam
teks tetapi pembolehubah babel-newcommands mengandungi pemetaan untuk mereka ke
babel sepadan.
dir arah asas dokumen, sama ada rtl (kanan ke kiri) atau ltr
(kiri ke kanan).
Untuk dokumen dwiarah, pandoc asli menjangkau dan div dengan atribut dir
(nilai rtl atau ltr) boleh digunakan untuk mengatasi arah asas dalam beberapa output
format. Ini mungkin tidak selalu diperlukan jika pemapar akhir (cth
pelayar, apabila menjana HTML) menyokong Algoritma Dwiarah Unikod.
Apabila menggunakan LaTeX untuk dokumen dua hala, hanya enjin xelatex sepenuhnya
disokong (gunakan --latex-engine=xelatex).
Pembolehubah khususnya slaid
Pembolehubah tersedia untuk menghasilkan persembahan slaid dengan pandoc, termasuk semua reveal.js
pilihan konfigurasi.
url-slide
URL asas untuk dokumen Slidy (lalai kepada http://www.w3.org/Talks/Tools/Slidy2)
slideous-url
URL asas untuk dokumen Slideous (lalai kepada slaid)
s5-url URL asas untuk dokumen S5 (lalai kepada s5/lalai)
revealjs-url
URL asas untuk dokumen reveal.js (lalai untuk reveal.js)
tema, tema warna, tema fon, tema dalaman, tema luar
tema untuk dokumen beamer LaTeX
navigasi
mengawal simbol navigasi dalam dokumen beamer (lalai kosong untuk tiada navigasi
simbol; nilai sah lain ialah bingkai, menegak dan mendatar).
tajuk bahagian
membolehkan pada "halaman tajuk" untuk bahagian baharu dalam dokumen beamer (lalai = benar).
Pembolehubah khususnya LaTeX
Pembolehubah LaTeX digunakan semasa membuat PDF.
saiz kertas
saiz kertas, cth huruf, A4
Saiz huruf
saiz fon untuk teks kandungan (cth 10pt, 12pt)
kelas dokumen
kelas dokumen, cth artikel, laporan, buku, memoir
pilihan kelas
pilihan untuk kelas dokumen, cth oneside; boleh diulang untuk berbilang pilihan
geometri
pilihan untuk pakej geometri, cth margin=1in; boleh diulang untuk berbilang pilihan
margin-kiri, margin-kanan, margin atas, margin bawah
tetapkan margin, jika geometri tidak digunakan (jika tidak, geometri mengatasi ini)
regangan garisan
melaraskan jarak baris menggunakan pakej setspace, cth 1.25, 1.5
fontfamily
pakej fon untuk digunakan dengan pdflatex: TeX Live termasuk banyak pilihan, didokumenkan dalam
Katalog Fon LaTeX. Lalai ialah Latin Modern.
fontfamilyoptions
pilihan untuk pakej yang digunakan sebagai fontfamily: cth osf,sc dengan fontfamily ditetapkan kepada
mathpazo menyediakan Palatino dengan angka gaya lama dan topi kecil yang benar; mungkin
diulang untuk berbilang pilihan
utama, sansfont, monofon, fon matematik, CJKmainfont
keluarga fon untuk digunakan dengan xelatex atau lualatex: ambil nama mana-mana fon sistem,
menggunakan pakej fontspec. Ambil perhatian bahawa jika CJKmainfont digunakan, pakej xecjk
mesti ada.
mainfontoptions, sansfontoptions, monofontoptions, mathfontoptions, CJKoptions
pilihan untuk digunakan dengan mainfont, sansfont, monofont, mathfont, CJKmainfont dalam xelatex
dan lualatex. Benarkan sebarang pilihan yang tersedia melalui fontspec, seperti
OpenType menampilkan Numbers=OldStyle,Numbers=Proportional. Boleh diulang untuk
berbilang pilihan.
fontc
membenarkan pengekodan fon ditentukan melalui pakej fontenc (dengan pdflatex);
lalai ialah T1 (lihat panduan untuk pengekodan fon LaTeX)
pautan warna
tambah warna pada teks pautan; didayakan secara automatik jika mana-mana linkcolor, citecolor,
urlcolor, atau toccolor ditetapkan
linkcolor, citecolor, urlcolor, toccolor
warna untuk pautan dalaman, pautan petikan, pautan luar dan pautan dalam jadual
kandungan: menggunakan mana-mana warna LaTeX yang telah ditetapkan
pautan-sebagai-nota
menyebabkan pautan dicetak sebagai nota kaki
inden menggunakan tetapan kelas dokumen untuk lekukan (templat LaTeX lalai sebaliknya
mengalih keluar lekukan dan menambah ruang antara perenggan)
subperenggan
melumpuhkan tingkah laku lalai templat LaTeX yang mentakrifkan semula (sub) perenggan sebagai
bahagian, menukar rupa tajuk bersarang dalam sesetengah kelas
terima kasih menentukan kandungan nota kaki pengakuan selepas tajuk dokumen.
palsu sertakan jadual kandungan (juga boleh ditetapkan menggunakan --toc/--table-of-contents)
toc-depth
tahap bahagian untuk dimasukkan ke dalam jadual kandungan
lof, banyak
sertakan senarai rajah, senarai jadual
bibliografi
bibliografi untuk digunakan untuk menyelesaikan rujukan
ala biblio
gaya bibliografi, apabila digunakan dengan --natbib dan --biblatex.
biblatexoptions
senarai pilihan untuk biblatex.
Pembolehubah khususnya ConTeXt
saiz kertas
saiz kertas, cth huruf, A4, landskap (lihat Persediaan Kertas ConTeXt); mungkin berulang
untuk berbilang pilihan
susun atur pilihan untuk jidar halaman dan susunan teks (lihat Reka Letak ConTeXt); mungkin berulang
untuk berbilang pilihan
margin-kiri, margin-kanan, margin atas, margin bawah
tetapkan margin, jika susun atur tidak digunakan (jika tidak susun atur mengatasi ini)
Saiz huruf
saiz fon untuk teks kandungan (cth 10pt, 12pt)
utama, sansfont, monofon, mathfont
keluarga fon: ambil nama mana-mana fon sistem (lihat ConTeXt Font Switching)
linkcolor, warna kontras
warna untuk pautan di luar dan di dalam halaman, cth merah, biru (lihat Warna ConTeXt)
linkstyle
gaya muka taip untuk pautan, cth normal, tebal, serong, boldslanted, taip, topi,
kecil
inden
mengawal lekukan perenggan, cth ya, kecil, seterusnya (lihat Lekukan ConTeXt);
boleh diulang untuk berbilang pilihan
ruang kosong
jarak antara perenggan, cth tiada, kecil (menggunakan setupwhitespace)
ruang antara talian
melaraskan jarak baris, cth 4ex (menggunakan setupinterlinespace); boleh diulang untuk
pelbagai pilihan
teks tajuk, teks kaki
teks untuk diletakkan dalam pengepala atau pengaki yang sedang berjalan (lihat Pengepala dan Pengaki ConTeXt);
boleh diulang sehingga empat kali untuk penempatan yang berbeza
penomboran halaman
gaya nombor halaman dan lokasi (menggunakan setuppagenumbering); boleh diulang untuk
pelbagai pilihan
palsu sertakan jadual kandungan (juga boleh ditetapkan menggunakan --toc/--table-of-contents)
lof, banyak
sertakan senarai rajah, senarai jadual
Pembolehubah khususnya lelaki muka surat
seksyen
nombor bahagian dalam halaman manual
header pengepala dalam halaman manusia
footer pengaki dalam halaman manusia
menyesuaikan diri
melaraskan teks ke margin kiri (l), kanan (r), tengah (c), atau kedua-duanya (b).
kata hubung
jika benar (lalai), tanda sempang akan digunakan
Menggunakan pembolehubah in template
Nama pembolehubah ialah jujukan abjad angka, -, dan _, bermula dengan huruf. A
nama pembolehubah yang dikelilingi oleh tanda $ akan digantikan dengan nilainya. Sebagai contoh, yang
rentetan $tajuk$ masuk
$tajuk$
akan digantikan dengan tajuk dokumen.
Untuk menulis $ literal dalam templat, gunakan $$.
Templat mungkin mengandungi syarat. Sintaksnya adalah seperti berikut:
$jika(pembolehubah)$
X
$else$
Y
$endif$
Ini akan memasukkan X dalam templat jika pembolehubah mempunyai nilai bukan nol; jika tidak ia akan
sertakan Y. X dan Y ialah pemegang tempat untuk sebarang teks templat yang sah, dan mungkin termasuk
pembolehubah interpolasi atau syarat lain. Bahagian $else$ mungkin ditinggalkan.
Apabila pembolehubah boleh mempunyai berbilang nilai (contohnya, pengarang dalam dokumen berbilang pengarang),
anda boleh menggunakan kata kunci $for$:
$for(author)$
$endfor$
Anda boleh secara pilihan menentukan pemisah untuk digunakan antara item berturut-turut:
$for(author)$$author$$sep$, $endfor$
Titik boleh digunakan untuk memilih medan pembolehubah yang mengambil objek sebagai nilainya. Jadi,
sebagai contoh:
$author.name$ ($author.affiliation$)
Jika anda menggunakan templat tersuai, anda mungkin perlu menyemaknya sebagai perubahan pandoc. Kami mengesyorkan
menjejaki perubahan dalam templat lalai dan mengubah suai templat tersuai anda
sewajarnya. Cara mudah untuk melakukan ini ialah dengan memotong repositori templat pandoc dan bergabung
dalam perubahan selepas setiap keluaran pandoc.
PANDOC'S MARKDOWN
Pandoc memahami versi lanjutan dan sedikit disemak bagi Markdown John Gruber
sintaks. Dokumen ini menerangkan sintaks, mencatat perbezaan daripada Markdown standard.
Kecuali jika dinyatakan, perbezaan ini boleh dihalang dengan menggunakan markdown_strict
format bukannya markdown. Sambungan boleh didayakan dengan menambahkan +SAMBUNGAN pada
nama format dan dilumpuhkan dengan menambah -EXTENSION. Contohnya, markdown_strict+footnotes ialah
Markdown yang ketat dengan nota kaki didayakan, manakala markdown-footnotes-pipe_tables ialah pandoc's
Markdown tanpa nota kaki atau jadual paip.
Falsafah
Markdown direka bentuk supaya mudah ditulis dan, lebih penting lagi, mudah dibaca:
Dokumen berformat Markdown harus boleh diterbitkan apa adanya, sebagai teks biasa, tanpa
kelihatan seperti telah ditandai dengan teg atau arahan pemformatan. -- John
Gruber
Prinsip ini telah membimbing keputusan pandoc dalam mencari sintaks untuk jadual, nota kaki dan
sambungan lain.
Walau bagaimanapun, terdapat satu aspek di mana matlamat pandoc berbeza daripada matlamat asal
daripada Markdown. Manakala Markdown pada asalnya direka dengan mengambil kira penjanaan HTML,
pandoc direka untuk berbilang format output. Oleh itu, sementara pandoc membenarkan pembenaman
HTML mentah, ia tidak menggalakkannya, dan menyediakan cara lain yang bukan HTMLish untuk mewakili
elemen dokumen penting seperti senarai definisi, jadual, matematik dan nota kaki.
Perenggan
Perenggan ialah satu atau lebih baris teks diikuti dengan satu atau lebih baris kosong. baris baharu
dianggap sebagai ruang, jadi anda boleh mengalirkan semula perenggan anda mengikut kehendak anda. Jika anda memerlukan yang sukar
pemisah baris, letakkan dua atau lebih ruang di hujung baris.
Sambungan: escaped_line_breaks
Segaris ke belakang diikuti dengan baris baharu juga merupakan pemisah garis keras. Nota: dalam multiline dan grid
sel jadual, ini adalah satu-satunya cara untuk mencipta pemisah garis keras, kerana mengekori ruang masuk
sel diabaikan.
Pengepala
Terdapat dua jenis pengepala: Setext dan ATX.
Gaya seteks tajuk
Pengepala gaya seteks ialah baris teks "bergaris bawah" dengan baris tanda = (untuk tahap
satu pengepala) atau - tanda (untuk pengepala tahap dua):
Tajuk tahap satu
==================
Tandukan tahap dua
------------------
Teks pengepala boleh mengandungi pemformatan sebaris, seperti penekanan (lihat pemformatan Sebaris,
di bawah).
gaya ATX tajuk
Pengepala gaya ATX terdiri daripada satu hingga enam # tanda dan baris teks, diikuti secara pilihan
dengan sebarang bilangan # tanda. Bilangan # tanda pada permulaan baris ialah
tahap pengepala:
## Tajuk tahap dua
### Tajuk tahap tiga ###
Seperti dengan pengepala gaya seteks, teks pengepala boleh mengandungi pemformatan:
# Tajuk tahap satu dengan [pautan](/url) dan *penekanan*
Sambungan: blank_before_header
Sintaks Markdown Standard tidak memerlukan baris kosong sebelum pengepala. Pandoc lakukan
memerlukan ini (kecuali, sudah tentu, pada permulaan dokumen). Sebab untuk
keperluan adalah bahawa ia adalah terlalu mudah untuk # berakhir pada permulaan baris oleh
kemalangan (mungkin melalui pembalut talian). Pertimbangkan, sebagai contoh:
Saya suka beberapa perisa aiskrim mereka:
#22, sebagai contoh, dan #5.
Header pengecam
Sambungan: header_attributes
Pengepala boleh diberikan atribut menggunakan sintaks ini pada penghujung baris yang mengandungi
teks tajuk:
{#identifier .class .class key=value key=value}
Oleh itu, sebagai contoh, pengepala berikut semuanya akan diberikan pengecam foo:
# Pengepala saya {#foo}
## Tajuk saya ## {#foo}
Pengepala saya yang lain {#foo}
---------------
(Sintaks ini serasi dengan PHP Markdown Extra.)
Ambil perhatian bahawa walaupun sintaks ini membenarkan penetapan kelas dan atribut kunci/nilai,
penulis biasanya tidak menggunakan semua maklumat ini. Pengecam, kelas dan kunci/nilai
atribut digunakan dalam HTML dan format berasaskan HTML seperti EPUB dan slidy. Pengecam
digunakan untuk label dan penambat pautan dalam penulis LaTeX, ConTeXt, Textile dan AsciiDoc.
Pengepala dengan kelas tidak bernombor tidak akan bernombor, walaupun jika --number-sections adalah
ditentukan. Tanda sempang tunggal (-) dalam konteks atribut adalah bersamaan dengan .unnumbered dan
lebih baik dalam dokumen bukan bahasa Inggeris. Jadi,
# Pengepala saya {-}
sama sahaja dengan
# Pengepala saya {.unnumbered}
Sambungan: auto_identifiers
Pengepala tanpa pengecam yang dinyatakan secara eksplisit akan diberikan secara automatik a
pengecam unik berdasarkan teks pengepala. Untuk mendapatkan pengecam daripada pengepala
teks,
· Alih keluar semua pemformatan, pautan, dsb.
· Alih keluar semua nota kaki.
· Alih keluar semua tanda baca, kecuali garis bawah, sempang dan noktah.
· Gantikan semua ruang dan baris baharu dengan sempang.
· Tukar semua aksara abjad kepada huruf kecil.
· Alih keluar semua sehingga huruf pertama (pengecam mungkin tidak bermula dengan nombor atau
tanda baca).
· Jika tiada yang tinggal selepas ini, gunakan bahagian pengecam.
Oleh itu, sebagai contoh,
Pengecam Pengepala
────────────────────────────────────────────────── ──────
Pengecam pengepala dalam HTML pengepala-pengenal-dalam-html
*Anjing*?--di rumah *saya*? anjing--di-rumah saya
[HTML], [S5] atau [RTF]? html-s5-atau-rtf
3. Aplikasi aplikasi
Bahagian 33
Peraturan ini seharusnya, dalam kebanyakan kes, membenarkan seseorang untuk menentukan pengecam daripada pengepala
teks. Pengecualian adalah apabila beberapa pengepala mempunyai teks yang sama; dalam kes ini, yang pertama
akan mendapat pengecam seperti yang diterangkan di atas; yang kedua akan mendapat pengecam yang sama dengan -1
dilampirkan; yang ketiga dengan -2; dan sebagainya.
Pengecam ini digunakan untuk menyediakan sasaran pautan dalam jadual kandungan yang dijana oleh
pilihan --toc|--jadual-kandungan. Mereka juga memudahkan untuk menyediakan pautan daripada satu
bahagian dokumen kepada yang lain. Pautan ke bahagian ini, sebagai contoh, mungkin kelihatan seperti
ini:
Lihat bahagian di
[pengecam pengepala](#pengecam-pengepala-dalam-html-lateks-dan-konteks).
Walau bagaimanapun, ambil perhatian bahawa kaedah menyediakan pautan ke bahagian ini hanya berfungsi dalam HTML, LaTeX,
dan format ConTeXt.
Jika pilihan --section-divs ditentukan, maka setiap bahagian akan dibalut dalam div (atau
bahagian, jika --html5 ditentukan), dan pengecam akan dilampirkan pada lampiran
(atau ) teg dan bukannya pengepala itu sendiri. Ini membolehkan keseluruhan bahagian menjadi
dimanipulasi menggunakan javascript atau dirawat secara berbeza dalam CSS.
Sambungan: implicit_header_references
Pandoc berkelakuan seolah-olah pautan rujukan telah ditakrifkan untuk setiap pengepala. Jadi, bukannya
[pengecam pengepala](#pengenal-pengepala-dalam-html)
anda hanya boleh menulis
[pengecam pengepala]
or
[pengecam pengepala][]
or
[bahagian pengecam pengepala][pengecam pengepala]
Jika terdapat berbilang pengepala dengan teks yang sama, rujukan yang sepadan akan dipautkan
kepada yang pertama sahaja, dan anda perlu menggunakan pautan eksplisit untuk memaut kepada yang lain, sebagai
diterangkan di atas.
Seperti pautan rujukan biasa, rujukan ini tidak peka huruf besar-kecil.
Takrif rujukan pautan eksplisit sentiasa diutamakan berbanding rujukan pengepala tersirat.
Jadi, dalam contoh berikut, pautan akan menghala ke bar, bukan ke #foo:
# Foo
[foo]: bar
Lihat [foo]
Menyekat petikan
Penurunan harga menggunakan konvensyen e-mel untuk memetik blok teks. Sebut harga blok ialah satu atau
lebih banyak perenggan atau elemen blok lain (seperti senarai atau pengepala), dengan setiap baris
didahului dengan > aksara dan ruang pilihan. (The > tidak perlu bermula di sebelah kiri
margin, tetapi ia tidak boleh diindenkan lebih daripada tiga ruang.)
> Ini adalah petikan blok. ini
> perenggan mempunyai dua baris.
>
> 1. Ini ialah senarai di dalam petikan blok.
> 2. Perkara kedua.
Borang "malas", yang memerlukan > aksara hanya pada baris pertama setiap blok, ialah
juga dibenarkan:
> Ini adalah petikan blok. ini
perenggan mempunyai dua baris.
> 1. Ini ialah senarai di dalam petikan blok.
2. Perkara kedua.
Antara elemen blok yang boleh terkandung dalam petikan blok adalah petikan blok lain.
Iaitu, petikan blok boleh bersarang:
> Ini adalah petikan blok.
>
> > Petikan blok dalam petikan blok.
Jika aksara > diikuti oleh ruang pilihan, ruang itu akan dianggap sebahagian daripadanya
penanda petikan blok dan bukan sebahagian daripada lekukan kandungan. Oleh itu, untuk meletakkan satu
blok kod inden dalam petikan blok, anda memerlukan lima ruang selepas >:
> kod
Sambungan: blank_before_blockquote
Sintaks Markdown Standard tidak memerlukan baris kosong sebelum petikan blok. Pandoc lakukan
memerlukan ini (kecuali, sudah tentu, pada permulaan dokumen). Sebab untuk
keperluannya ialah terlalu mudah untuk a > berakhir di permulaan baris
kemalangan (mungkin melalui pembalut talian). Jadi, melainkan format markdown_strict digunakan,
yang berikut tidak menghasilkan petikan blok bersarang dalam pandoc:
> Ini adalah petikan blok.
>> Bersarang.
verbatim (kod) blok
Inden kod blok
Satu blok teks menginden empat ruang (atau satu tab) dianggap sebagai teks verbatim: iaitu,
aksara khas tidak mencetuskan pemformatan khas, dan semua ruang dan pemisah baris adalah
terpelihara. Sebagai contoh,
jika (a > 3) {
moveShip(5 * graviti, BAWAH);
}
Lekukan awal (empat ruang atau satu tab) tidak dianggap sebagai sebahagian daripada kata kerja
teks, dan dikeluarkan dalam output.
Nota: baris kosong dalam teks verbatim tidak perlu bermula dengan empat ruang.
berpagar kod blok
Sambungan: blok_kod_pagar
Selain blok kod inden standard, pandoc menyokong berpagar blok kod. Ini
bermula dengan satu baris tiga atau lebih tilde (~) dan berakhir dengan baris tilde yang mesti berada di
sekurang-kurangnya sepanjang baris permulaan. Segala-galanya di antara baris ini dianggap sebagai kod. Tidak
lekukan diperlukan:
~~~~~~~
jika (a > 3) {
moveShip(5 * graviti, BAWAH);
}
~~~~~~~
Seperti blok kod biasa, blok kod berpagar mesti diasingkan daripada teks sekeliling dengan
garisan kosong.
Jika kod itu sendiri mengandungi baris tilde atau backtick, hanya gunakan baris tilde yang lebih panjang
atau tanda belakang pada permulaan dan akhir:
~~~~~~~~~~~~~~~~
~~~~~~~~~~
kod termasuk tildes
~~~~~~~~~~
~~~~~~~~~~~~~~~~
Sambungan: backtick_code_blocks
Sama seperti fenced_code_blocks, tetapi menggunakan backtick (`) dan bukannya tildes (~).
Sambungan: atribut_kod_pagar
Secara pilihan, anda boleh melampirkan atribut pada blok kod berpagar atau backtick menggunakan sintaks ini:
~~~~ {#mycode .haskell .numberLines startFrom="100"}
qsort [] = []
qsort (x:xs) = qsort (penapis (< x) xs) ++ [x] ++
qsort (penapis (>= x) xs)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Di sini mycode ialah pengecam, haskell dan numberLines ialah kelas, dan startFrom ialah satu
atribut dengan nilai 100. Sesetengah format output boleh menggunakan maklumat ini untuk melakukan sintaks
mengetengahkan. Pada masa ini, satu-satunya format output yang menggunakan maklumat ini ialah HTML dan
LaTeX. Jika penonjolan disokong untuk format dan bahasa output anda, maka kod
blok di atas akan kelihatan diserlahkan, dengan garis bernombor. (Untuk melihat bahasa mana
disokong, lakukan pandoc --version.) Jika tidak, blok kod di atas akan dipaparkan seperti berikut:
...
Borang pintasan juga boleh digunakan untuk menentukan bahasa blok kod:
```haskell
qsort [] = []
"
Ini bersamaan dengan:
``` {.haskell}
qsort [] = []
"
Jika sambungan fenced_code_attributes dilumpuhkan, tetapi input mengandungi atribut kelas
untuk blok kod, atribut kelas pertama akan dicetak selepas pagar pembukaan sebagai a
kata kosong.
Untuk menghalang semua penyerlahan, gunakan bendera --no-highlight. Untuk menetapkan gaya penyerlahan,
gunakan --highlight-style. Untuk maklumat lanjut tentang penyerlahan, lihat Syntax highlighting,
di bawah.
Talian blok
Sambungan: blok_baris
Blok garis ialah jujukan garisan yang bermula dengan bar menegak (|) diikuti dengan ruang.
Pembahagian kepada baris akan dikekalkan dalam output, begitu juga dengan mana-mana ruang utama;
jika tidak, baris akan diformatkan sebagai Markdown. Ini berguna untuk ayat dan
alamat:
| Pek limerick ketawa anatomi
| Dalam ruang yang agak menjimatkan.
| Tetapi yang baik saya lihat
| Jadi jarang bersih
| Dan yang bersih sangat jarang lucu
| 200 Jalan Utama
| Berkeley, CA 94718
Garisan boleh dibalut keras jika perlu, tetapi baris kesinambungan mesti bermula dengan a
ruang.
| Yang Amat Mulia Yang Amat Mulia dan Amat Adil Samuel L.
Konstabel, Jr.
| 200 Jalan Utama
| Berkeley, CA 94718
Sintaks ini dipinjam daripada reStructuredText.
senarai
Peluru senarai
Senarai bullet ialah senarai item senarai bertitik tumpu. Item senarai bertitik tumpu bermula dengan titik tumpu
(*, +, atau -). Berikut adalah contoh mudah:
* satu
* dua
* tiga
Ini akan menghasilkan senarai "padat". Jika anda mahu senarai "longgar", di mana setiap item adalah
diformat sebagai perenggan, letakkan ruang antara item:
* satu
* dua
* tiga
Peluru tidak perlu disiram dengan jidar kiri; ia mungkin diendenkan satu, dua, atau
tiga ruang. Peluru mesti diikuti dengan ruang putih.
Senarai item kelihatan terbaik jika baris berikutnya sama dengan baris pertama (selepas titik):
* inilah yang pertama saya
item senarai.
* dan kedua saya.
Tetapi Markdown juga membenarkan format "malas":
* inilah yang pertama saya
item senarai.
* dan kedua saya.
. empat ruang memerintah
Item senarai mungkin mengandungi berbilang perenggan dan kandungan peringkat blok lain. Walau bagaimanapun,
perenggan seterusnya mesti didahului dengan baris kosong dan diinden empat ruang atau tab.
Senarai akan kelihatan lebih baik jika perenggan pertama sejajar dengan yang lain:
* Perenggan pertama.
Berlanjutan.
* Perenggan kedua. Dengan blok kod, yang mesti diinden
lapan ruang:
{ kod }
Item senarai mungkin termasuk senarai lain. Dalam kes ini, baris kosong sebelumnya adalah pilihan.
Senarai bersarang mesti diinden empat ruang atau satu tab:
*buah-buahan
+ epal
- macintosh
- merah sedap
+ pear
+ pic
* sayur-sayuran
+ brokoli
+ chard
Seperti yang dinyatakan di atas, Penurunan harga membolehkan anda menulis item senarai "malas," dan bukannya menginden
garis kesinambungan. Walau bagaimanapun, jika terdapat berbilang perenggan atau blok lain dalam senarai
item, baris pertama setiap satu mesti diinden.
+ Senarai yang malas, malas
item.
+ Satu lagi; ini kelihatan
buruk tetapi sah.
Perenggan kedua kedua
item senarai.
Catatan: Walaupun peraturan empat ruang untuk perenggan sambungan berasal dari rasmi
Panduan sintaks penurunan harga, pelaksanaan rujukan, Markdown.pl, tidak mengikutinya. Jadi
pandoc akan memberikan hasil yang berbeza daripada Markdown.pl apabila pengarang telah inden
perenggan sambungan kurang daripada empat ruang.
Panduan sintaks Markdown tidak jelas sama ada peraturan empat ruang digunakan semua
kandungan peringkat blok dalam item senarai; ia hanya menyebut perenggan dan blok kod. Tetapi ia
membayangkan bahawa peraturan itu digunakan untuk semua kandungan peringkat blok (termasuk senarai bersarang), dan
pandoc menafsirkannya begitu.
Mengarahkan senarai
Senarai tersusun berfungsi sama seperti senarai bertitik tumpu mata, kecuali item itu bermula dengan pembanci
bukannya peluru.
Dalam Markdown standard, pembanci ialah nombor perpuluhan diikuti dengan noktah dan ruang.
Nombor itu sendiri diabaikan, jadi tiada perbezaan antara senarai ini:
1. satu
2. dua
3. tiga
dan yang ini:
5. satu
7. dua
1. tiga
Sambungan: fancy_lists
Tidak seperti Markdown standard, pandoc membenarkan item senarai tersusun ditanda dengan huruf besar dan
huruf kecil dan angka roman, sebagai tambahan kepada angka arab. Penanda senarai mungkin
disertakan dalam kurungan atau diikuti dengan tanda kurung atau noktah kanan tunggal. Mereka mesti begitu
dipisahkan daripada teks yang diikuti oleh sekurang-kurangnya satu ruang, dan, jika penanda senarai ialah a
huruf besar dengan titik, sekurang-kurangnya dua ruang.
Sambungan fancy_lists juga membenarkan '#' digunakan sebagai penanda senarai tersusun sebagai ganti
nombor:
#. satu
#. dua
Sambungan: permulaan
Pandoc juga memberi perhatian kepada jenis penanda senarai yang digunakan, dan kepada nombor permulaan,
dan kedua-duanya dipelihara jika boleh dalam format output. Justeru, berikut
menghasilkan senarai dengan nombor diikuti dengan kurungan tunggal, bermula dengan 9, dan a
subsenarai dengan angka roman huruf kecil:
9) Kesembilan
10) Kesepuluh
11) Kesebelas
i. subone
ii. subdua
iii. subtiga
Pandoc akan memulakan senarai baharu setiap kali jenis penanda senarai yang berbeza digunakan. Jadi
berikut akan mencipta tiga senarai:
(2) Dua
(5) Tiga
1. Empat
* Lima
Jika penanda senarai lalai dikehendaki, gunakan #.:
#. satu
#. dua
#. tiga
definisi senarai
Sambungan: senarai_definisi
Pandoc menyokong senarai definisi, menggunakan sintaks PHP Markdown Extra dengan beberapa
sambungan.
Istilah 1
: Definisi 1
Penggal 2 dengan *penanda sebaris*
: Definisi 2
{ beberapa kod, sebahagian daripada Definisi 2 }
Perenggan ketiga definisi 2.
Setiap istilah mesti muat pada satu baris, yang boleh diikuti dengan baris kosong, dan mesti
diikuti oleh satu atau lebih definisi. Definisi bermula dengan titik bertindih atau tilde, yang
boleh diendenkan satu atau dua ruang.
Sesuatu istilah mungkin mempunyai pelbagai takrifan, dan setiap takrifan mungkin terdiri daripada satu atau lebih blok
elemen (perenggan, blok kod, senarai, dsb.), setiap satu mengesot empat ruang atau satu hentian tab.
Badan definisi (termasuk baris pertama, selain daripada kolon atau tilde)
hendaklah diendenkan empat ruang. Walau bagaimanapun, seperti senarai Markdown lain, anda boleh "malas"
tinggalkan lekukan kecuali pada permulaan perenggan atau elemen blok lain:
Istilah 1
: Definisi
dengan sambung malas.
Perenggan kedua definisi.
Jika anda meninggalkan ruang sebelum definisi (seperti dalam contoh di atas), teks
definisi akan dianggap sebagai perenggan. Dalam sesetengah format output, ini bermakna lebih besar
jarak antara pasangan istilah/takrif. Untuk senarai definisi yang lebih padat, tinggalkan ruang
sebelum definisi:
Istilah 1
~ Definisi 1
Istilah 2
~ Definisi 2a
~ Definisi 2b
Ambil perhatian bahawa ruang antara item dalam senarai definisi diperlukan. (Varian yang longgar
keperluan ini, tetapi tidak membenarkan pembalut keras "malas", boleh diaktifkan dengan
compact_definition_lists: lihat sambungan bukan pandoc, di bawah.)
Bernombor contoh senarai
Sambungan: senarai_contoh
Penanda senarai khas @ boleh digunakan untuk contoh bernombor berurutan. Senarai pertama
item dengan penanda @ akan dinomborkan '1', '2' seterusnya, dan seterusnya, sepanjang
dokumen. Contoh bernombor tidak perlu berlaku dalam satu senarai; setiap senarai baharu menggunakan @
akan mengambil tempat terakhir berhenti. Jadi, sebagai contoh:
(@) Contoh pertama saya akan diberi nombor (1).
(@) Contoh kedua saya akan diberi nombor (2).
Penjelasan contoh.
(@) Contoh ketiga saya akan diberi nombor (3).
Contoh bernombor boleh dilabel dan dirujuk di tempat lain dalam dokumen:
(@baik) Ini adalah contoh yang baik.
Seperti yang digambarkan oleh (@baik), ...
Label boleh berupa sebarang rentetan aksara abjad angka, garis bawah atau sempang.
Kompak and longgar senarai
Pandoc berkelakuan berbeza daripada Markdown.pl pada beberapa "kes tepi" yang melibatkan senarai.
Pertimbangkan sumber ini:
+ Pertama
+ Kedua:
- Bayaran
- Fie
- Musuh
+ Ketiga
Pandoc mengubahnya menjadi "senarai padat" (dengan no tag sekitar "Pertama", "Kedua",
atau "Ketiga"), manakala Markdown meletakkan tag sekitar "Kedua" dan "Ketiga" (tetapi bukan "Pertama"),
kerana ruang kosong di sekitar "Third". Pandoc mengikut peraturan mudah: jika teksnya
diikuti dengan baris kosong, ia dianggap sebagai perenggan. Oleh kerana "Kedua" diikuti dengan a
senarai, dan bukan baris kosong, ia tidak dianggap sebagai perenggan. Hakikat bahawa senarai itu
diikuti dengan baris kosong adalah tidak relevan. (Nota: Pandoc berfungsi dengan cara ini walaupun ketika
format markdown_strict ditentukan. Tingkah laku ini konsisten dengan pegawai
Perihalan sintaks Markdown, walaupun ia berbeza daripada Markdown.pl.)
Berakhir a senarai
Bagaimana jika anda ingin meletakkan blok kod inden selepas senarai?
- item satu
- perkara dua
{ blok kod saya }
masalah! Di sini pandoc (seperti pelaksanaan Markdown lain) akan menganggap { my code block } sebagai
perenggan kedua item dua, dan bukan sebagai blok kod.
Untuk "memotong" senarai selepas item dua, anda boleh memasukkan beberapa kandungan tidak berinden, seperti
Komen HTML, yang tidak akan menghasilkan output yang kelihatan dalam sebarang format:
- item satu
- perkara dua
{ blok kod saya }
Anda boleh menggunakan helah yang sama jika anda mahukan dua senarai berturut-turut dan bukannya satu senarai besar:
1. satu
2. dua
3. tiga
1. satu
2. lakukan
3. tres
Mendatar peraturan
Baris yang mengandungi baris tiga atau lebih *, -, atau _ aksara (pilihan dipisahkan oleh
spaces) menghasilkan peraturan mendatar:
* * * *
---------------
Jadual
Empat jenis meja boleh digunakan. Tiga jenis pertama mengandaikan penggunaan a
fon lebar tetap, seperti Courier. Jenis keempat boleh digunakan dengan jarak berkadar
fon, kerana ia tidak memerlukan barisan lajur.
Sambungan: kapsyen_jadual
Kapsyen boleh disediakan secara pilihan dengan semua 4 jenis jadual (seperti yang digambarkan dalam
contoh di bawah). Kapsyen ialah perenggan yang bermula dengan rentetan Jadual: (atau hanya :),
yang akan dilucutkan. Ia mungkin muncul sama ada sebelum atau selepas jadual.
Sambungan: simple_tables
Jadual ringkas kelihatan seperti ini:
Kanan Kiri Pusat Lalai
------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1
Jadual: Demonstrasi sintaks jadual ringkas.
Pengepala dan baris jadual mesti setiap satu muat pada satu baris. Penjajaran lajur ditentukan oleh
kedudukan teks pengepala berbanding dengan garis putus-putus di bawahnya:
· Jika garis putus-putus disiram dengan teks pengepala di sebelah kanan tetapi melepasinya
di sebelah kiri, lajur dijajarkan ke kanan.
· Jika garis putus-putus disiram dengan teks pengepala di sebelah kiri tetapi melampauinya
di sebelah kanan, lajur dijajar ke kiri.
· Jika garis putus-putus melangkaui teks pengepala pada kedua-dua belah, lajur ditengahkan.
· Jika garis putus-putus disiram dengan teks pengepala pada kedua-dua belah, penjajaran lalai ialah
digunakan (dalam kebanyakan kes, ini akan ditinggalkan).
Jadual mesti berakhir dengan garis kosong, atau garis sempang diikuti dengan garis kosong.
Pengepala lajur boleh ditinggalkan, dengan syarat garis putus-putus digunakan untuk menamatkan jadual. Untuk
contoh:
------- ------ ---------- -------
12 12 12 12
123 123 123 123
1 1 1 1
------- ------ ---------- -------
Apabila pengepala diabaikan, penjajaran lajur ditentukan berdasarkan baris pertama
daripada badan meja. Jadi, dalam jadual di atas, lajur adalah kanan, kiri, tengah dan
dijajarkan ke kanan, masing-masing.
Sambungan: multiline_tables
Jadual berbilang baris membenarkan pengepala dan baris jadual menjangkau berbilang baris teks (tetapi sel
yang merangkumi berbilang lajur atau baris jadual tidak disokong). Berikut adalah contoh:
-------------------------------------------------- -----------
Lalai Berpusat Kanan Kiri
Pengepala Dijajar Dijajarkan
------------------------- ------- ---------------- ----------------- --------
Baris pertama 12.0 Contoh baris yang
menjangkau berbilang baris.
Baris kedua 5.0 Ini satu lagi. Nota
garisan kosong antara
baris.
-------------------------------------------------- -----------
Jadual: Ini kapsyennya. Ia juga mungkin menjangkau
berbilang baris.
Ini berfungsi seperti jadual ringkas, tetapi dengan perbezaan berikut:
· Ia mesti bermula dengan deretan sengkang, sebelum teks pengepala (melainkan pengepala adalah
ditinggalkan).
· Ia mesti diakhiri dengan barisan sengkang, kemudian baris kosong.
· Baris mesti dipisahkan dengan garisan kosong.
Dalam jadual berbilang baris, penghurai jadual memberi perhatian kepada lebar lajur, dan
penulis cuba menghasilkan semula lebar relatif ini dalam output. Jadi, jika anda mendapati bahawa salah satu daripada
lajur terlalu sempit dalam output, cuba lebarkannya dalam sumber Markdown.
Pengepala boleh ditinggalkan dalam jadual berbilang baris serta jadual ringkas:
------------------------- ------- ---------------- ----------------- --------
Baris pertama 12.0 Contoh baris yang
menjangkau berbilang baris.
Baris kedua 5.0 Ini satu lagi. Nota
garisan kosong antara
baris.
------------------------- ------- ---------------- ----------------- --------
: Berikut ialah jadual berbilang baris tanpa pengepala.
Ada kemungkinan untuk jadual berbilang baris hanya mempunyai satu baris, tetapi baris itu harus diikuti
dengan baris kosong (dan kemudian baris sengkang yang mengakhiri jadual), atau jadual mungkin
ditafsirkan sebagai jadual ringkas.
Sambungan: grid_tables
Jadual grid kelihatan seperti ini:
: Contoh jadual grid.
+--------------+----------------+----------------- ---+
| Buah-buahan | Harga | Kelebihan |
+===========================+ ===+
| Pisang | $1.34 | - pembalut terbina dalam |
| | | - warna terang |
+--------------+----------------+----------------- ---+
| Jeruk | $2.10 | - menyembuhkan skurvi |
| | | - sedap |
+--------------+----------------+----------------- ---+
Baris =s memisahkan pengepala daripada badan jadual, dan boleh ditinggalkan untuk a
meja tanpa kepala. Sel-sel jadual grid mungkin mengandungi unsur blok sewenang-wenangnya (berbilang
perenggan, blok kod, senarai, dsb.). Penjajaran tidak disokong, begitu juga sel yang menyokongnya
menjangkau berbilang lajur atau baris. Jadual grid boleh dibuat dengan mudah menggunakan mod jadual Emacs.
Sambungan: meja_paip
Jadual paip kelihatan seperti ini:
| Betul | Kiri | Lalai | Pusat |
|------:|:-----|---------|:------:|
| 12 | 12 | 12 | 12 |
| 123 | 123 | 123 | 123 |
| 1 | 1 | 1 | 1 |
: Demonstrasi sintaks jadual paip.
Sintaks adalah sama dengan jadual PHP Markdown Extra. Paip permulaan dan penamat
aksara adalah pilihan, tetapi paip diperlukan antara semua lajur. Titik bertindih menunjukkan
penjajaran lajur seperti yang ditunjukkan. Pengepala tidak boleh ditinggalkan. Untuk mensimulasikan jadual tanpa kepala,
sertakan pengepala dengan sel kosong.
Oleh kerana paip menunjukkan sempadan lajur, lajur tidak perlu dijajarkan secara menegak, seperti
mereka dalam contoh di atas. Jadi, ini adalah jadual paip yang sah (walaupun hodoh):
buah| harga
-----|-----:
epal|2.05
pir|1.37
oren|3.09
Sel-sel jadual paip tidak boleh mengandungi elemen blok seperti perenggan dan senarai, dan
tidak boleh menjangkau berbilang baris. Jika jadual paip mengandungi baris yang kandungan boleh cetaknya
lebih lebar daripada lebar lajur (lihat --columns), maka kandungan sel akan dibalut, dengan
lebar sel relatif ditentukan oleh lebar garis pemisah.
Nota: pandoc juga mengenali jadual paip dalam bentuk berikut, seperti yang boleh dihasilkan oleh
Mod orgtbl Emacs:
| Satu | Dua |
|-----+-------|
| saya | jadual |
| ialah | bagus |
Perbezaannya ialah + digunakan bukannya |. Ciri orgtbl lain tidak disokong.
Khususnya, untuk mendapatkan penjajaran lajur bukan lalai, anda perlu menambah titik bertindih seperti di atas.
Metadata blok
Sambungan: blok_tajuk_pandoc
Jika fail bermula dengan blok tajuk
% tajuk
% pengarang (dipisahkan dengan koma bertitik)
% Tarikh
ia akan dihuraikan sebagai maklumat bibliografi, bukan teks biasa. (Ia akan digunakan, untuk
contoh, dalam tajuk keluaran LaTeX atau HTML kendiri.) Blok mungkin mengandungi hanya a
tajuk, tajuk dan pengarang, atau ketiga-tiga elemen. Jika anda ingin memasukkan pengarang tetapi
tiada tajuk, atau tajuk dan tarikh tetapi tiada pengarang, anda memerlukan baris kosong:
%
% Pengarang
% Tajuk saya
%
% 15 Jun 2006
Tajuk mungkin menduduki berbilang baris, tetapi baris kesinambungan mesti bermula dengan ruang hadapan,
Oleh itu:
% Tajuk saya
pada berbilang baris
Jika dokumen mempunyai berbilang pengarang, pengarang boleh diletakkan pada baris berasingan dengan pendahuluan
ruang, atau dipisahkan dengan koma bertitik, atau kedua-duanya. Jadi, semua yang berikut adalah setara:
% Pengarang Satu
Pengarang Dua
% Pengarang Satu; Pengarang Dua
% Pengarang Satu;
Pengarang Dua
Tarikh mesti muat pada satu baris.
Ketiga-tiga medan metadata mungkin mengandungi pemformatan sebaris standard (condong, pautan,
nota kaki, dsb.).
Blok tajuk akan sentiasa dihuraikan, tetapi ia akan menjejaskan output hanya apabila
Pilihan --standalone (-s) dipilih. Dalam output HTML, tajuk akan muncul dua kali: sekali dalam
kepala dokumen -- ini ialah tajuk yang akan muncul di bahagian atas tetingkap dalam penyemak imbas
-- dan sekali pada permulaan badan dokumen. Tajuk dalam kepala dokumen boleh
mempunyai awalan pilihan dilampirkan (--title-prefix atau pilihan -T). Tajuk dalam badan
muncul sebagai elemen H1 dengan kelas "tajuk", jadi ia boleh ditindas atau diformatkan semula
CSS. Jika awalan tajuk ditentukan dengan -T dan tiada blok tajuk muncul dalam dokumen,
awalan tajuk akan digunakan dengan sendirinya sebagai tajuk HTML.
Penulis halaman manual mengekstrak tajuk, nombor bahagian halaman manual dan pengepala dan pengaki lain
maklumat daripada baris tajuk. Tajuk diandaikan sebagai perkataan pertama pada tajuk
baris, yang boleh pilihan berakhir dengan nombor bahagian (satu digit) dalam kurungan.
(Tiada ruang antara tajuk dan kurungan.) Apa-apa selepas ini
diandaikan sebagai teks pengaki dan pengepala tambahan. Satu aksara paip (|) sepatutnya
digunakan untuk memisahkan teks pengaki daripada teks pengepala. Oleh itu,
% PANDOC(1)
akan menghasilkan halaman manual dengan tajuk PANDOC dan bahagian 1.
% PANDOC(1) Manual Pengguna Pandoc
juga akan mempunyai "Manual Pengguna Pandoc" dalam pengaki.
% PANDOC(1) Manual Pengguna Pandoc | Versi 4.0
juga akan mempunyai "Versi 4.0" dalam pengepala.
Sambungan: yaml_metadata_block
Blok metadata YAML ialah objek YAML yang sah, dihadkan dengan baris tiga sempang (---)
di bahagian atas dan garisan tiga sempang (---) atau tiga titik (...) di bahagian bawah. YAML
blok metadata mungkin berlaku di mana-mana dalam dokumen, tetapi jika ia bukan pada permulaan, ia
mesti didahului dengan baris kosong. (Perhatikan bahawa, kerana cara pandoc menggabungkan
input fail apabila beberapa disediakan, anda juga boleh menyimpan metadata dalam YAML yang berasingan
fail dan hantar ke pandoc sebagai hujah, bersama-sama dengan fail Markdown anda:
pandoc chap1.md chap2.md chap3.md metadata.yaml -s -o book.html
Pastikan fail YAML bermula dengan --- dan berakhir dengan --- atau ....)
Metadata akan diambil dari medan objek YAML dan ditambah kepada mana-mana yang sedia ada
metadata dokumen. Metadata boleh mengandungi senarai dan objek (bersarang sewenang-wenangnya), tetapi semuanya
skalar rentetan akan ditafsirkan sebagai Markdown. Medan dengan nama yang berakhir dengan garis bawah
akan diabaikan oleh pandoc. (Mereka mungkin diberi peranan oleh pemproses luaran.)
Dokumen mungkin mengandungi berbilang blok metadata. Medan metadata akan digabungkan
melalui berat sebelah kiri kesatuan: jika dua blok metadata cuba untuk menetapkan medan yang sama, the
nilai dari blok pertama akan diambil.
Apabila pandoc digunakan dengan -t markdown untuk mencipta dokumen Markdown, blok metadata YAML
akan dihasilkan hanya jika -s/--pilihan kendiri digunakan. Semua metadata akan
muncul dalam satu blok pada permulaan dokumen.
Ambil perhatian bahawa peraturan melarikan diri YAML mesti dipatuhi. Oleh itu, sebagai contoh, jika tajuk mengandungi a
kolon, ia mesti dipetik. Aksara paip (|) boleh digunakan untuk memulakan blok inden
itu akan ditafsirkan secara literal, tanpa perlu melarikan diri. Borang ini perlu
apabila medan mengandungi baris kosong:
---
tajuk: 'Ini adalah tajuk: ia mengandungi titik bertindih'
pengarang:
- nama: Pengarang Satu
gabungan: Universiti Somewhere
- nama: Pengarang Dua
gabungan: Universiti Nowhere
tag: [tiada, ketiadaan]
abstrak: |
Ini adalah abstrak.
Ia terdiri daripada dua perenggan.
...
Pembolehubah templat akan ditetapkan secara automatik daripada metadata. Oleh itu, sebagai contoh, dalam
menulis HTML, abstrak pembolehubah akan ditetapkan kepada HTML yang setara dengan Markdown dalam
bidang abstrak:
Ini adalah abstrak.
Ia terdiri daripada dua perenggan.
Nota: Pembolehubah pengarang dalam templat lalai menjangkakan senarai atau rentetan yang ringkas. Kepada
gunakan pengarang berstruktur dalam contoh, anda memerlukan templat tersuai. Sebagai contoh:
$for(author)$
$jika(nama pengarang)$
$author.name$$if(author.affiliation)$ ($author.affiliation$)$endif$
$else$
$author$
$endif$
$endfor$
Tanda Belakang melarikan diri
Sambungan: semua_simbol_boleh
Kecuali di dalam blok kod atau kod sebaris, sebarang tanda baca atau aksara ruang yang didahului
garis miring ke belakang akan dilayan secara literal, walaupun ia biasanya menunjukkan pemformatan.
Oleh itu, sebagai contoh, jika seseorang menulis
*\*hello\**
seseorang akan mendapat
*hello*
bukan
hello
Peraturan ini lebih mudah diingati daripada peraturan Markdown standard, yang membenarkan hanya
aksara berikut untuk dilepaskan dengan garis miring ke belakang:
\`*_{}[]()>#+-.!
(Walau bagaimanapun, jika format markdown_strict digunakan, peraturan Markdown standard akan digunakan.)
Ruang yang dilepaskan dengan garis miring ke belakang dihuraikan sebagai ruang yang tidak putus. Ia akan muncul dalam output TeX
sebagai ~ dan dalam HTML dan XML sebagai \ atau \ .
Baris baharu yang dilepaskan ke belakang (iaitu, garis miring ke belakang yang berlaku pada penghujung baris) dihuraikan
sebagai pemutus garis keras. Ia akan muncul dalam output TeX sebagai \\ dan dalam HTML sebagai . Ini adalah
alternatif yang bagus kepada cara Markdown "tidak kelihatan" untuk menunjukkan pemisah garis keras menggunakan dua
ruang mengekor pada garisan.
Melarikan garis miring ke belakang tidak berfungsi dalam konteks verbatim.
Pintar tanda baca
Lanjutan
Jika pilihan --smart ditentukan, pandoc akan menghasilkan output yang betul dari segi tipografi,
menukar petikan lurus kepada petikan kerinting, --- kepada em-sempang, -- kepada en-sempang dan ... kepada
elips. Ruang tanpa putus disisipkan selepas singkatan tertentu, seperti "Encik."
Nota: jika templat LaTeX anda atau mana-mana fail pengepala yang disertakan memanggil pakej csquotes,
pandoc akan mengesan ini secara automatik dan menggunakan \enquote{...} untuk teks yang dipetik.
Dalam barisan pemformatan
Penekanan
Untuk penekanan beberapa teks, kelilingi dengan *s atau _, seperti ini:
Teks ini _ditekankan dengan garis bawah_, dan ini
adalah *ditekankan dengan asterisk*.
Berganda * atau _ menghasilkan kuat penekanan:
Ini **penekanan kuat** dan __dengan garis bawah__.
A * atau _ aksara yang dikelilingi oleh ruang, atau garis miring ke belakang, tidak akan mencetuskan penekanan:
Ini * tidak ditekankan *, dan \*begitu juga\*.
Sambungan: intraword_underscores
Kerana _ kadangkala digunakan di dalam perkataan dan pengecam, pandoc tidak mentafsirkan _
dikelilingi oleh aksara alfanumerik sebagai penanda penekanan. Kalau nak ditekankan
hanya sebahagian daripada perkataan, gunakan *:
feas*ible*, bukan feas*able*.
Strikeout
Sambungan: mogok
Untuk memotong bahagian teks dengan garis mendatar, mulakan dan akhiri dengan ~~. Oleh itu,
sebagai contoh,
Ini ~~memadamkan teks.~~
Superskrip and subskrip
Sambungan: superskrip, langganan
Superskrip boleh ditulis dengan mengelilingi teks superskrip dengan ^ aksara;
subskrip boleh ditulis dengan mengelilingi teks yang dilanggan oleh ~ aksara. Justeru, untuk
contohnya,
H~2~O ialah cecair. 2^10^ ialah 1024.
Jika teks superskrip atau subskrip mengandungi ruang, ruang ini mesti dilepaskan
dengan garis miring ke belakang. (Ini adalah untuk mengelakkan superskrip dan melanggan secara tidak sengaja melalui
penggunaan biasa ~ dan ^.) Oleh itu, jika anda mahu huruf P dengan 'kucing' dalam subskrip,
guna P~a\ cat~, bukan P~a cat~.
verbatim
Untuk membuat jangka pendek kata kerja teks, letakkan di dalam tanda kutu belakang:
Apakah perbezaan antara `>>=` dan `>>`?
Jika teks verbatim termasuk tanda belakang, gunakan tanda belakang berganda:
Berikut ialah tanda belakang literal `` ` ``.
(Ruang selepas kutu belakang pembukaan dan sebelum kutu belakang penutup akan diabaikan.)
Peraturan umum ialah rentang kata kerja bermula dengan rentetan tanda belakang berturut-turut
(pilihan diikuti dengan ruang) dan diakhiri dengan rentetan bilangan kutu belakang yang sama
(pilihan didahului dengan ruang).
Ambil perhatian bahawa tanda serong terbalik (dan binaan Markdown yang lain) tidak berfungsi secara verbatim
konteks:
Ini ialah garis miring ke belakang diikuti dengan asterisk: `\*`.
Sambungan: atribut_kod_baris
Atribut boleh dilampirkan pada teks verbatim, sama seperti dengan blok kod berpagar:
`<$>`{.haskell}
kecil topi
Untuk menulis huruf kecil, anda boleh menggunakan teg span HTML:
Tudung kecil
(Koma bertitik adalah pilihan dan mungkin terdapat ruang selepas titik bertindih.) Ini akan berfungsi dalam semua
format output yang menyokong huruf kecil.
Matematik
Sambungan: tex_math_dollars
Apa-apa sahaja antara dua $ aksara akan dianggap sebagai matematik TeX. Pembukaan $ mesti mempunyai a
aksara bukan ruang serta-merta di sebelah kanannya, manakala $ penutup mesti mempunyai bukan ruang
aksara serta-merta ke kiri, dan tidak boleh diikuti dengan serta-merta dengan satu digit. Oleh itu,
$20,000 dan $30,000 tidak akan dihuraikan sebagai matematik. Jika atas sebab tertentu anda perlu melampirkan teks
aksara $ literal, sengkang belakang-escape mereka dan ia tidak akan dianggap sebagai pembatas matematik.
TeX matematik akan dicetak dalam semua format output. Bagaimana ia diberikan bergantung pada output
format:
Penurunan harga, LaTeX, Emacs organ mod, ConTeXt
Ia akan muncul secara verbatim antara $ aksara.
reStructuredText
Ia akan diberikan menggunakan peranan teks yang ditafsirkan :math:.
AsciiDoc
Ia akan diberikan sebagai lateksmath:[...].
Texinfo
Ia akan diberikan dalam arahan @math.
mengarut lelaki
Ia akan diberikan secara verbatim tanpa $'s.
MediaWiki, DokuWiki
Ia akan diberikan di dalam tag.
Tekstil
Ia akan dipaparkan di dalam teg.
RTF, OpenDocument, ODT
Ia akan diberikan, jika boleh, menggunakan aksara unicode, dan sebaliknya
muncul secara verbatim.
DocBook
Jika bendera --mathm digunakan, ia akan dipaparkan menggunakan MathML dalam persamaan sebaris
atau tag informalequation. Jika tidak, ia akan diberikan, jika boleh, menggunakan unicode
watak-watak.
Docx Ia akan dipaparkan menggunakan penanda matematik OMML.
Buku Fiksyen2
Jika pilihan --webtex digunakan, formula dipaparkan sebagai imej menggunakan Carta Google
atau perkhidmatan web lain yang serasi, dimuat turun dan dibenamkan dalam e-buku. Jika tidak,
mereka akan muncul secara verbatim.
HTML, licin, DZSlides, S5, EPUB
Cara matematik dipaparkan dalam HTML akan bergantung pada pilihan baris perintah yang dipilih:
1. Lalai adalah untuk menjadikan matematik TeX sejauh mungkin menggunakan aksara unicode,
seperti output RTF, DocBook dan OpenDocument. Formula dimasukkan ke dalam rentang
dengan class="math", supaya mereka boleh digayakan secara berbeza daripada persekitaran
teks jika perlu.
2. Jika pilihan --latexmathml digunakan, matematik TeX akan dipaparkan antara $ atau $$
aksara dan masukkan tag dengan kelas LaTeX. Skrip LaTeXMathML akan
digunakan untuk menjadikannya sebagai formula. (Helah ini tidak berfungsi dalam semua pelayar,
tetapi ia berfungsi dalam Firefox. Dalam penyemak imbas yang tidak menyokong LaTeXMathML, matematik TeX
akan muncul secara verbatim antara $ aksara.)
3. Jika pilihan --jsmath digunakan, matematik TeX akan dimasukkan ke dalam teg (untuk
matematik sebaris) atau tag (untuk paparan matematik) dengan matematik kelas. The jsMath
skrip akan digunakan untuk memaparkannya.
4. Jika pilihan --mimetex digunakan, skrip CGI mimeTeX akan dipanggil
menjana imej untuk setiap formula TeX. Ini sepatutnya berfungsi dalam semua penyemak imbas. The
--mimetex option mengambil URL pilihan sebagai hujah. Jika tiada URL dinyatakan, ia
akan diandaikan bahawa skrip CGI mimeTeX berada di /cgi-bin/mimetex.cgi.
5. Jika pilihan --gladtex digunakan, formula TeX akan disertakan tag masuk
output HTML. Fail htex yang terhasil kemudiannya boleh diproses oleh gladTeX,
yang akan menghasilkan fail imej untuk setiap formula dan fail HTML dengan pautan ke
imej-imej ini. Jadi, prosedurnya ialah:
pandoc -s --gladtex myfile.txt -o myfile.htex
gladtex -d myfile-imej myfile.htex
# menghasilkan myfile.html dan imej dalam myfile-images
6. Jika pilihan --webtex digunakan, formula TeX akan ditukar kepada tag
pautan itu kepada skrip luaran yang menukar formula kepada imej. Formulanya
akan dikodkan URL dan digabungkan dengan URL yang disediakan. Jika tiada URL
ditentukan, API Carta Google akan digunakan
(http://chart.apis.google.com/chart?cht=tx&chl=).
7. Jika pilihan --mathjax digunakan, matematik TeX akan dipaparkan antara \(...\) (untuk
matematik sebaris) atau \[...\] (untuk matematik paparan) dan masukkan teg dengan kelas
matematik. Skrip MathJax akan digunakan untuk menjadikannya sebagai formula.
Raw HTML
Sambungan: raw_html
Penurunan harga membolehkan anda memasukkan HTML mentah (atau DocBook) di mana-mana dalam dokumen (kecuali
konteks verbatim, di mana <, >, dan & ditafsirkan secara literal). (Secara teknikal ini tidak
sambungan, memandangkan Markdown standard membenarkannya, tetapi ia telah dijadikan sambungan supaya
ia boleh dilumpuhkan jika dikehendaki.)
HTML mentah dihantar melalui tidak berubah dalam HTML, S5, Slidy, Slideous, DZSlides, EPUB,
Markdown, dan Output Tekstil, dan ditindas dalam format lain.
Sambungan: markdown_in_html_blocks
Penurunan Nilai Standard membolehkan anda memasukkan "blok" HTML: blok HTML antara seimbang
tag yang diasingkan daripada teks sekeliling dengan baris kosong, dan bermula dan berakhir pada
jidar kiri. Dalam blok ini, semuanya ditafsirkan sebagai HTML, bukan Markdown; jadi
(sebagai contoh), * tidak menandakan penekanan.
Pandoc berkelakuan seperti ini apabila format markdown_strict digunakan; tetapi secara lalai, pandoc
mentafsir bahan antara tag blok HTML sebagai Markdown. Oleh itu, sebagai contoh, pandoc akan
berpaling
*satu*
[pautan](http://google.com)
ke dalam
satu
<a href="/http://google.com">pautan
manakala Markdown.pl akan mengekalkannya sebagaimana adanya.
Terdapat satu pengecualian untuk peraturan ini: teks antara and tags is not
ditafsirkan sebagai Markdown.
Penyimpangan daripada Markdown standard ini seharusnya memudahkan untuk mencampurkan Markdown dengan HTML
elemen blok. Sebagai contoh, seseorang boleh mengelilingi blok teks Markdown dengan tag
tanpa menghalangnya daripada ditafsirkan sebagai Markdown.
Sambungan: native_divs
Gunakan blok Div pandoc asli untuk kandungan di dalam tag. Untuk sebahagian besar ini sepatutnya
berikan output yang sama seperti markdown_in_html_blocks, tetapi ia memudahkan untuk menulis pandoc
penapis untuk memanipulasi kumpulan blok.
Sambungan: native_spans
Gunakan blok Span pandoc asli untuk kandungan di dalam teg. Untuk sebahagian besar ini
harus memberikan output yang sama seperti raw_html, tetapi ia memudahkan untuk menulis penapis pandoc
memanipulasi kumpulan sebaris.
Raw TeX
Sambungan: raw_tex
Selain HTML mentah, pandoc membenarkan LaTeX mentah, TeX dan ConTeXt untuk disertakan dalam a
dokumen. Perintah TeX sebaris akan disimpan dan dihantar tidak berubah kepada LaTeX dan
Penulis ConTeXt. Oleh itu, sebagai contoh, anda boleh menggunakan LaTeX untuk memasukkan petikan BibTeX:
Keputusan ini telah dibuktikan dalam \cite{jones.1967}.
Ambil perhatian bahawa dalam persekitaran LaTeX, seperti
\begin{jadual}{|l|l|}\hline
Umur & Kekerapan \\ \hline
18--25 & 15 \\
26--35 & 33 \\
36--45 & 22 \\ \hline
\end{jadual}
bahan antara tag permulaan dan akhir akan ditafsirkan sebagai LaTeX mentah, bukan sebagai
Penurunan harga.
LaTeX Sebaris diabaikan dalam format output selain daripada Markdown, LaTeX dan ConTeXt.
LaTeX makro
Sambungan: lateks_makros
Untuk format output selain daripada LaTeX, pandoc akan menghuraikan LaTeX \newcommand dan \renewcommand
definisi dan gunakan makro yang terhasil pada semua matematik LaTeX. Jadi, sebagai contoh,
berikut akan berfungsi dalam semua format output, bukan hanya LaTeX:
\newcommand{\tuple}[1]{\langle #1 \rangle}
$\tuple{a, b, c}$
Dalam output LaTeX, definisi \newcommand hanya akan dihantar tidak berubah kepada output.
pautan
Penurunan harga membolehkan pautan ditentukan dalam beberapa cara.
automatik link
Jika anda melampirkan URL atau alamat e-mel dalam kurungan runcing, ia akan menjadi pautan:
<http://google.com>
<[e-mel dilindungi]>
Dalam barisan link
Pautan sebaris terdiri daripada teks pautan dalam kurungan segi empat sama, diikuti dengan URL dalam
kurungan. (Secara pilihan, URL boleh diikuti dengan tajuk pautan, dalam petikan.)
Ini ialah [pautan sebaris](/url), dan inilah [satu dengan
tajuk](http://fsf.org "klik di sini untuk masa yang baik!").
Tidak boleh ada ruang antara bahagian kurungan dan bahagian kurungan. pautan itu
teks boleh mengandungi pemformatan (seperti penekanan), tetapi tajuk tidak boleh.
Alamat e-mel dalam pautan sebaris tidak dapat dikesan secara automatik, jadi ia mesti diberi awalan
mailto:
[Tulis saya!](mailto:[e-mel dilindungi])
Rujukan link
An jelas pautan rujukan mempunyai dua bahagian, pautan itu sendiri dan definisi pautan, yang
mungkin berlaku di tempat lain dalam dokumen (sama ada sebelum atau selepas pautan).
Pautan terdiri daripada teks pautan dalam kurungan segi empat sama, diikuti dengan label dalam kurungan segi empat sama.
(Mungkin terdapat ruang antara keduanya.) Definisi pautan terdiri daripada label berkurung,
diikuti dengan titik bertindih dan ruang, diikuti dengan URL, dan secara pilihan (selepas ruang) a
tajuk pautan sama ada dalam petikan atau dalam kurungan. Label tidak boleh dihuraikan sebagai a
petikan (dengan andaian sambungan petikan didayakan): petikan diutamakan
label pautan.
Berikut adalah beberapa contoh:
[label saya 1]: /foo/bar.html "Tajuk saya, pilihan"
[label saya 2]: /foo
[label saya 3]: http://fsf.org (Asas perisian percuma)
[label saya 4]: /bar#special 'Tajuk dalam petikan tunggal'
URL secara pilihan mungkin dikelilingi oleh kurungan sudut:
[label saya 5]:http://foo.bar.baz>
Tajuk mungkin pergi pada baris seterusnya:
[label saya 3]: http://fsf.org
"Asas perisian percuma"
Ambil perhatian bahawa label pautan tidak sensitif huruf besar-besaran. Jadi, ini akan berfungsi:
Inilah [pautan saya][FOO]
[Foo]: /bar/baz
Dalam tersirat pautan rujukan, pasangan kurungan kedua kosong:
Lihat [laman web saya][].
[laman web saya]: http://foo.bar.baz
Nota: Dalam Markdown.pl dan kebanyakan pelaksanaan Markdown yang lain, rujukan definisi pautan
tidak boleh berlaku dalam binaan bersarang seperti item senarai atau petikan blok. Pandoc mengangkat
sekatan yang kelihatan sewenang-wenang ini. Jadi yang berikut adalah baik dalam pandoc, walaupun tidak dalam
kebanyakan pelaksanaan lain:
> Blok saya [petikan].
>
> [petikan]: /foo
Sambungan: shortcut_reference_links
Dalam pakej Jalan pintas pautan rujukan, pasangan kurungan kedua boleh ditinggalkan sepenuhnya:
Lihat [laman web saya].
[laman web saya]: http://foo.bar.baz
Dalaman link
Untuk memaut ke bahagian lain dalam dokumen yang sama, gunakan yang dijana secara automatik
pengecam (lihat pengecam Pengepala). Sebagai contoh:
Lihat [Pengenalan](#pengenalan).
or
Lihat [Pengenalan].
[Pengenalan]: #pengenalan
Pautan dalaman pada masa ini disokong untuk format HTML (termasuk tayangan slaid HTML dan
EPUB), LaTeX dan ConTeXt.
Imej
Pautan segera didahului oleh ! akan dianggap sebagai imej. Teks pautan akan menjadi
digunakan sebagai teks alt imej:
![kekili filem]
[kekili filem]: movie.gif
Sambungan: angka_implisit
Imej yang berlaku dengan sendirinya dalam perenggan akan dipaparkan sebagai angka dengan kapsyen.
(Dalam LaTeX, persekitaran angka akan digunakan; dalam HTML, imej akan diletakkan dalam div
dengan angka kelas, bersama dengan kapsyen dalam ap dengan kapsyen kelas.) Alt imej
teks akan digunakan sebagai kapsyen.
Jika anda hanya mahukan imej sebaris biasa, cuma pastikan ia bukan satu-satunya perkara dalam
perenggan. Satu cara untuk melakukan ini adalah dengan memasukkan ruang tanpa putus selepas imej:
\
Sambungan: pautan_atribut
Atribut boleh ditetapkan pada pautan dan imej:
Sebaris {#id .class width=30 height=20px}
dan rujukan ![imej][ref] dengan atribut.
[ref]: foo.jpg "tajuk pilihan" {#id .class key=val key2="val 2"}
(Sintaks ini serasi dengan PHP Markdown Extra apabila hanya #id dan .class digunakan.)
Untuk HTML dan EPUB, semua atribut kecuali lebar dan tinggi (tetapi termasuk srcset dan saiz)
dilalui sebagaimana adanya. Penulis lain mengabaikan atribut yang tidak disokong oleh
format keluaran mereka.
Atribut lebar dan ketinggian pada imej dilayan secara khusus. Apabila digunakan tanpa a
unit, unit itu diandaikan sebagai piksel. Walau bagaimanapun, mana-mana pengecam unit berikut
boleh digunakan: px, cm, mm, dalam, inci dan %. Tidak boleh ada sebarang ruang antara nombor
dan unit. Sebagai contoh:
{ lebar=50% }
· Dimensi ditukar kepada inci untuk output dalam format berasaskan halaman seperti LaTeX.
Dimensi ditukar kepada piksel untuk output dalam format seperti HTML. Gunakan --dpi
pilihan untuk menentukan bilangan piksel setiap inci. Lalai ialah 96dpi.
· Unit % biasanya relatif kepada beberapa ruang yang tersedia. Contohnya contoh di atas
akan memberikan kepada (HTML),
\includegraphics[width=0.5\textwidth]{file.jpg} (LaTeX), atau
\externalfigure[file.jpg][width=0.5\textwidth] (ConTeXt).
· Sesetengah format output mempunyai tanggapan tentang kelas (ConTeXt) atau pengecam unik (LaTeX
\caption), atau kedua-duanya (HTML).
· Apabila tiada atribut lebar atau ketinggian dinyatakan, sandaran adalah untuk melihat imej
resolusi dan metadata dpi yang dibenamkan dalam fail imej.
Nota kaki
Sambungan: nota kaki
Penurunan nilai Pandoc membenarkan nota kaki, menggunakan sintaks berikut:
Berikut ialah rujukan nota kaki,[^1] dan satu lagi.[^nota panjang]
[^1]: Berikut ialah nota kaki.
[^nota panjang]: Ini adalah satu dengan berbilang blok.
Perenggan seterusnya diinden untuk menunjukkan bahawa mereka
tergolong dalam nota kaki sebelumnya.
{ some.code }
Seluruh perenggan boleh diinden, atau hanya yang pertama
barisan. Dengan cara ini, nota kaki berbilang perenggan berfungsi seperti
item senarai berbilang perenggan.
Perenggan ini tidak akan menjadi sebahagian daripada nota, kerana ia
tidak inden.
Pengecam dalam rujukan nota kaki mungkin tidak mengandungi ruang, tab atau baris baharu. Ini
pengecam hanya digunakan untuk mengaitkan rujukan nota kaki dengan nota itu sendiri; di dalam
output, nota kaki akan dinomborkan secara berurutan.
Nota kaki itu sendiri tidak perlu diletakkan di hujung dokumen. Mereka mungkin muncul
di mana-mana kecuali di dalam elemen blok lain (senarai, petikan blok, jadual, dll.).
Sambungan: nota_sebaris
Nota kaki sebaris juga dibenarkan (walaupun, tidak seperti nota biasa, ia tidak boleh mengandungi
berbilang perenggan). Sintaksnya adalah seperti berikut:
Berikut ialah nota sebaris.^[Nota sebaris lebih mudah untuk ditulis, kerana
anda tidak perlu memilih pengecam dan bergerak ke bawah untuk menaip
Nota.]
Nota kaki sebaris dan biasa boleh dicampur dengan bebas.
Petikan
Sambungan: petikan
Menggunakan penapis luaran, pandoc-citeproc, pandoc boleh menjana petikan dan
bibliografi dalam beberapa gaya. Penggunaan asas adalah
pandoc --filter pandoc-citeproc myinput.txt
Untuk menggunakan ciri ini, anda perlu menentukan fail bibliografi menggunakan
medan metadata bibliografi dalam bahagian metadata YAML, atau --bibliography baris arahan
hujah. Anda boleh membekalkan berbilang --hujah bibliografi atau menetapkan metadata bibliografi
medan ke tatasusunan YAML, jika anda ingin menggunakan berbilang fail bibliografi. Bibliografi boleh
mempunyai mana-mana format ini:
Format sambungan fail
─────────────────────────────
BibLaTeX .bib
BibTeX .bibtex
Copac .copac
CSL JSON .json
CSL YAML .yaml
Nota Akhir .ms
EndNote XML .xml
ISI .wos
MEDLINE .medline
MODS .mods
RIS .ris
Ambil perhatian bahawa .bib boleh digunakan dengan kedua-dua fail BibTeX dan BibLaTeX; gunakan .bibtex untuk memaksa
BibTeX.
Ambil perhatian bahawa pandoc-citeproc --bib2json dan pandoc-citeproc --bib2yaml boleh menghasilkan .json dan
fail .yaml daripada mana-mana format yang disokong.
Penanda dalam medan: Dalam pangkalan data BibTeX dan BibLaTeX, pandoc-citeproc menghuraikan subset
Penanda LaTeX; dalam pangkalan data CSL YAML, Pandoc Markdown; dan dalam pangkalan data CSL JSON, an
Penanda seperti HTML:
huruf condong
...
berani
style="font-variant:small-caps;">... or ...
modal kecil
...
langganan
...
superskrip
class="nocase">...
mengelakkan frasa daripada dijadikan huruf besar sebagai huruf besar
pandoc-citeproc -j dan -y menukar format CSL JSON dan CSL YAML setakat
mungkin.
Sebagai alternatif untuk menentukan fail bibliografi menggunakan --bibliography atau YAML
bibliografi medan metadata, anda boleh memasukkan data petikan terus dalam rujukan
medan metadata YAML dokumen. Medan harus mengandungi tatasusunan berkod YAML
rujukan, contohnya:
---
rujukan:
- jenis: artikel-jurnal
id: WatsonCrick1953
pengarang:
- keluarga: Watson
diberikan: JD
- keluarga: Crick
diberi: FHC
dikeluarkan:
bahagian tarikh:
- - 1953
- 4
- 25
tajuk: 'Struktur molekul asid nukleik: struktur untuk deoksiribosa
asid nukleik'
title-short: Struktur molekul asid nukleik
tajuk kontena: Alam Semulajadi
isipadu: 171
keluaran: 4356
muka surat: 737-738
DOI: 10.1038/171737a0
URL: http://www.nature.com/nature/journal/v171/n4356/abs/171737a0.html
bahasa: en-GB
...
(pandoc-citeproc --bib2yaml boleh menghasilkan ini daripada fail bibliografi dalam salah satu
format yang disokong.)
Petikan dan rujukan boleh diformat menggunakan mana-mana gaya yang disokong oleh Gaya Petikan
Bahasa, disenaraikan dalam Repositori Gaya Zotero. Fail-fail ini ditentukan menggunakan
--csl pilihan atau medan metadata csl. Secara lalai, pandoc-citeproc akan menggunakan Chicago
Manual Gaya format tarikh pengarang. Projek CSL menyediakan maklumat lanjut tentang
mencari dan menyunting gaya.
Untuk menjadikan petikan anda hiperpautan kepada entri bibliografi yang sepadan, tambah
petikan pautan: benar kepada metadata YAML anda.
Petikan dimasukkan ke dalam kurungan segi empat sama dan dipisahkan oleh koma bertitik. Setiap petikan mesti
mempunyai kunci, terdiri daripada '@' + pengecam petikan daripada pangkalan data, dan boleh
pilihan mempunyai awalan, pencari dan akhiran. Kunci petikan mesti bermula dengan a
huruf, digit atau _ dan mungkin mengandungi abjad angka, _ dan aksara tanda baca dalaman
(:.#$%&-+?<>~/). Berikut adalah beberapa contoh:
Bla bla [lihat @doe99, ms 33-35; juga @smith04, bab. 1].
Bla bla [@doe99, ms 33-35, 38-39 dan *passim*].
Bla bla [@smith04; @doe99].
pandoc-citeproc mengesan istilah pencari dalam fail setempat CSL. Sama ada disingkat atau
borang yang tidak dipendekkan diterima. Dalam tempat en-AS, istilah pencari boleh ditulis dalam
sama ada bentuk tunggal atau jamak, sebagai buku, bk./bks.; bab, bab/bab; ruangan,
kol./kol.; rajah, rajah./rajah.; folio, fol./fols.; nombor, no./no.; baris, l./ll.; Nota,
n./nn.; opus, op./opp.; muka surat, hlm/hlm; perenggan, perenggan/perenggan; bahagian, pt./pts.; bahagian,
sec./secs.; sub kata kerja, sv/s.vv.; ayat, v./vv.; jilid, jilid/jilid; ¶/¶¶; §/§§. Jika tidak
istilah pencari digunakan, "halaman" diandaikan.
Tanda tolak (-) sebelum @ akan menghalang sebutan pengarang dalam petikan. ini
boleh berguna apabila pengarang telah disebutkan dalam teks:
Smith berkata blah [-@smith04].
Anda juga boleh menulis petikan dalam teks, seperti berikut:
@smith04 cakap blah.
@smith04 [hlm. 33] kata bla.
Jika gaya memerlukan senarai karya yang dipetik, ia akan diletakkan di penghujung
dokumen. Biasanya, anda ingin menamatkan dokumen anda dengan pengepala yang sesuai:
perenggan terakhir...
# Rujukan
Bibliografi akan disisipkan selepas pengepala ini. Ambil perhatian bahawa kelas tidak bernombor akan
ditambahkan pada pengepala ini, supaya bahagian itu tidak bernombor.
Jika anda ingin memasukkan item dalam bibliografi tanpa benar-benar memetiknya dalam badan
teks, anda boleh menentukan medan metadata nocite tiruan dan meletakkan petikan di sana:
---
maklum: |
@item1, @item2
...
@item3
Dalam contoh ini, dokumen akan mengandungi petikan untuk item3 sahaja, tetapi bibliografi
akan mengandungi entri untuk item1, item2 dan item3.
Untuk output LaTeX atau PDF, anda juga boleh menggunakan natbib atau biblatex untuk menghasilkan bibliografi. Dalam
untuk berbuat demikian, nyatakan fail bibliografi seperti yang digariskan di atas dan tambah --natbib atau
--biblatex hujah kepada doa pandoc. Perlu diingat bahawa fail bibliografi mestilah
dalam format masing-masing (sama ada BibTeX atau BibLaTeX).
Untuk maklumat lanjut, lihat halaman manual pandoc-citeproc.
Bukan pandoc sambungan
Sambungan sintaks Markdown berikut tidak didayakan secara lalai dalam pandoc, tetapi mungkin
didayakan dengan menambahkan +SAMBUNGAN pada nama format, dengan EXTENSION ialah nama bagi
sambungan. Oleh itu, sebagai contoh, markdown+hard_line_breaks ialah Markdown dengan garis keras
rehat.
Sambungan: lists_without_preceding_blankline
Benarkan senarai berlaku sejurus selepas perenggan, tanpa ruang kosong campur tangan.
Sambungan: hard_line_breaks
Menyebabkan semua baris baharu dalam perenggan ditafsirkan sebagai pemisah garis keras dan bukannya
ruang.
Sambungan: ignore_line_breaks
Menyebabkan baris baharu dalam perenggan diabaikan, dan bukannya dianggap sebagai ruang atau
sebagai garis keras putus. Pilihan ini bertujuan untuk digunakan dengan bahasa Asia Timur di mana
ruang tidak digunakan antara perkataan, tetapi teks dibahagikan kepada baris untuk kebolehbacaan.
Sambungan: east_asian_line_breaks
Menyebabkan baris baharu dalam perenggan diabaikan, dan bukannya dianggap sebagai ruang atau
sebagai garis keras putus, apabila ia berlaku antara dua aksara Asia Timur yang luas. Ini adalah satu
pilihan yang lebih baik daripada ignore_line_breaks untuk teks yang merangkumi gabungan seluruh Asia Timur
watak dan watak lain.
Sambungan: emoji
Menghuraikan emoji teks seperti :smile: sebagai emotikon Unicode.
Sambungan: tex_math_single_backslash
Menyebabkan apa-apa antara \( dan \) ditafsirkan sebagai matematik TeX sebaris, dan apa-apa sahaja
antara \[ dan \] untuk ditafsirkan sebagai paparan TeX matematik. Nota: kelemahan ini
sambungan ialah ia menghalang melarikan diri ( dan [.
Sambungan: tex_math_double_backslash
Menyebabkan apa-apa antara \\( dan \\) ditafsirkan sebagai matematik TeX sebaris, dan apa-apa sahaja
antara \\[ dan \\] untuk ditafsirkan sebagai paparan TeX matematik.
Sambungan: turunkan_atribut
Secara lalai, pandoc mentafsir bahan di dalam teg peringkat blok sebagai Penurunan Harga. ini
sambungan mengubah tingkah laku supaya Markdown hanya dihuraikan dalam teg peringkat blok jika
tag mempunyai tanda turun atribut=1.
Sambungan: mmd_title_block
Mendayakan blok tajuk gaya MultiMarkdown di bahagian atas dokumen, contohnya:
Tajuk: Tajuk saya
Pengarang: John Doe
Tarikh: September 1, 2008
Ulasan: Ini adalah contoh blok tajuk mmd, dengan
medan yang merangkumi berbilang baris.
Lihat dokumentasi MultiMarkdown untuk butiran. Jika pandoc_title_block atau
yaml_metadata_block didayakan, ia akan diutamakan daripada mmd_title_block.
Sambungan: singkatan
Menghuraikan PHP Markdown Kekunci singkatan tambahan, seperti
*[HTML]: Bahasa Penanda Hiperteks
Ambil perhatian bahawa model dokumen pandoc tidak menyokong singkatan, jadi jika sambungan ini
didayakan, kekunci singkatan hanya dilangkau (berbanding dihuraikan sebagai
perenggan).
Sambungan: autolink_bare_uris
Menjadikan semua URI mutlak menjadi pautan, walaupun tidak dikelilingi oleh tanda kurung runcing <...>.
Sambungan: ascii_identifiers
Menyebabkan pengecam yang dihasilkan oleh auto_identifiers menjadi ASCII tulen. Aksen adalah
dilucutkan daripada huruf latin beraksen, dan huruf bukan latin ditinggalkan.
Sambungan: mmd_link_attributes
Menghuraikan atribut nilai kunci gaya multimarkdown pada pautan dan rujukan imej. ini
sambungan tidak boleh dikelirukan dengan sambungan link_attributes.
Ini ialah rujukan ![image][ref] dengan atribut multimarkdown.
[rujuk]: http://path.to/image "Tajuk imej" lebar=20px tinggi=30px
id=myId class="myClass1 myClass2"
Sambungan: mmd_header_identifiers
Menghuraikan pengecam pengepala gaya multimarkdown (dalam kurungan segi empat sama, selepas pengepala tetapi
sebelum sebarang #s tertinggal dalam pengepala ATX).
Sambungan: senarai_definisi_padat
Mengaktifkan sintaks senarai definisi pandoc 1.12.x dan lebih awal. Sintaks ini berbeza
daripada yang diterangkan di atas di bawah senarai Definisi dalam beberapa aspek:
· Tiada baris kosong diperlukan antara item berturut-turut senarai definisi.
· Untuk mendapatkan senarai "ketat" atau "padat", tinggalkan ruang antara item berturut-turut; ruang itu
antara istilah dan definisinya tidak mempengaruhi apa-apa.
· Pembalut perenggan yang malas tidak dibenarkan: keseluruhan definisi mesti dienden empat
ruang.
Penurunan harga varian
Selain Markdown lanjutan pandoc, varian Markdown berikut disokong:
markdown_phpextra (PHP Penurunan harga Tambahan)
nota kaki, pipe_tables, raw_html, markdown_attribute, fenced_code_blocks,
senarai_definisi, intraword_underscores, header_attributes, link_attributes,
singkatan, shortcut_reference_links.
markdown_github (Berperisa GitHub penurunan harga)
pipe_tables, raw_html, tex_math_single_backslash, fenced_code_blocks,
auto_identifiers, ascii_identifiers, backtick_code_blocks, autolink_bare_uris,
intraword_underscores, 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, nota kaki,
senarai_takrifan, semua_simbol_boleh dilepaskan, rujukan_pengepala_implisit,
auto_identifiers, mmd_header_identifiers, shortcut_reference_links.
penurunan_tegas (Markdown.pl)
raw_html
Extensions bersama format lain daripada Penurunan harga
Beberapa sambungan yang dibincangkan di atas boleh digunakan dengan format selain daripada Markdown:
· auto_identifiers boleh digunakan dengan lateks, pertama, mediawiki dan input tekstil (dan digunakan
secara lalai).
· tex_math_dollars, tex_math_single_backslash dan tex_math_double_backslash boleh digunakan
dengan input html. (Ini berguna untuk membaca halaman web yang diformat menggunakan MathJax, untuk
contoh.)
MENGELUARKAN SLIDE MENUNJUKKAN DENGAN PANDOC
Anda boleh menggunakan pandoc untuk menghasilkan persembahan slaid HTML + javascript yang boleh dilihat
melalui pelayar web. Terdapat lima cara untuk melakukan ini, menggunakan S5, DZSlides, Slidy, Slideous,
atau reveal.js. Anda juga boleh menghasilkan tayangan slaid PDF menggunakan pancaran LaTeX.
Berikut ialah sumber Markdown untuk tayangan slaid ringkas, habits.txt:
% Tabiat
% John Doe
% 22 Mac 2005
# Pada waktu pagi
## Bangun
- Matikan penggera
- Bangun dari tidur
## Sarapan pagi
- Makan telur
- Minum kopi
# Pada waktu petang
## Makan malam
- Makan spageti
- Minum wain
------------------
## Nak tidur
- Naik katil
- Kira biri-biri
Untuk menghasilkan persembahan slaid HTML/javascript, hanya taip
pandoc -t FORMAT -s habits.txt -o habits.html
dengan FORMAT sama ada s5, slidy, slideous, dzslides atau revealjs.
Untuk Slidy, Slideous, reveal.js dan S5, fail yang dihasilkan oleh pandoc dengan
-s/--pilihan kendiri membenamkan pautan ke javascript dan fail CSS, yang diandaikan sebagai
tersedia di laluan relatif s5/lalai (untuk S5), slaid (untuk Slideous), reveal.js
(untuk reveal.js), atau di tapak web Slidy di w3.org (untuk Slidy). (Laluan ini boleh
diubah dengan menetapkan pembolehubah slidy-url, slideous-url, revealjs-url atau s5-url; lihat
Pembolehubah untuk slaid, di atas.) Untuk DZSlides, javascript dan css (agak pendek) ialah
disertakan dalam fail secara lalai.
Dengan semua format slaid HTML, pilihan --self-contained boleh digunakan untuk menghasilkan satu
fail yang mengandungi semua data yang diperlukan untuk memaparkan persembahan slaid, termasuk dipautkan
skrip, helaian gaya, imej dan video.
Untuk menghasilkan tayangan slaid PDF menggunakan beamer, taip
pandoc -t beamer habits.txt -o habits.pdf
Ambil perhatian bahawa persembahan slaid reveal.js juga boleh ditukar kepada PDF dengan mencetaknya ke fail
daripada pelayar.
Penstrukturan yang luncurkan Menunjukkan
Secara lalai, luncurkan tahap ialah tahap pengepala tertinggi dalam hierarki yang diikuti
serta-merta mengikut kandungan, dan bukan pengepala lain, di suatu tempat dalam dokumen. Dalam contoh
di atas, pengepala tahap 1 sentiasa diikuti oleh pengepala tahap 2, yang diikuti oleh
kandungan, jadi 2 ialah tahap slaid. Lalai ini boleh diganti menggunakan --slide-level
pilihan.
Dokumen itu diukir ke dalam slaid mengikut peraturan berikut:
· Peraturan mendatar sentiasa memulakan slaid baharu.
· Tajuk pada tahap slaid sentiasa memulakan slaid baharu.
· Tajuk di bawah tahap slaid dalam hierarki mencipta tajuk dalam sebuah slaid.
· Tajuk atas tahap slaid dalam hierarki mencipta "slaid tajuk", yang hanya mengandungi
tajuk bahagian dan bantuan untuk memecahkan persembahan slaid kepada bahagian.
· Halaman tajuk dibina secara automatik daripada blok tajuk dokumen, jika ada.
(Dalam kes beamer, ini boleh dilumpuhkan dengan mengulas beberapa baris dalam fail lalai
templat.)
Peraturan ini direka bentuk untuk menyokong banyak gaya persembahan slaid yang berbeza. Jika anda tidak
mengambil berat tentang menstrukturkan slaid anda kepada bahagian dan subseksyen, anda hanya boleh menggunakan tahap 1
pengepala untuk semua setiap slaid. (Dalam kes itu, tahap 1 akan menjadi tahap slaid.) Tetapi anda boleh
juga struktur persembahan slaid ke dalam bahagian, seperti dalam contoh di atas.
Nota: dalam persembahan slaid reveal.js, jika tahap slaid ialah 2, reka letak dua dimensi akan menjadi
dihasilkan, dengan pengepala tahap 1 dibina secara mendatar dan pembinaan pengepala tahap 2
secara menegak. Anda tidak digalakkan menggunakan sarang yang lebih dalam pada tahap bahagian dengan
reveal.js.
Tambahan senarai
Secara lalai, penulis ini menghasilkan senarai yang memaparkan "sekali gus". Jika anda mahu senarai anda
untuk memaparkan secara berperingkat (satu item pada satu masa), gunakan pilihan -i. Jika anda mahu a
senarai tertentu untuk berlepas daripada lalai (iaitu, untuk memaparkan secara berperingkat tanpa
-i pilihan dan sekaligus dengan pilihan -i), letakkannya dalam petikan blok:
> - Makan spageti
> - Minum wain
Dengan cara ini senarai incremental dan nonincremental boleh dicampur dalam satu dokumen.
Memasukkan rehat
Anda boleh menambah "jeda" dalam slaid dengan memasukkan perenggan yang mengandungi tiga titik,
dipisahkan oleh ruang:
# Luncurkan dengan jeda
kandungan sebelum jeda
. . .
kandungan selepas jeda
Styling yang slaid
Anda boleh menukar gaya slaid HTML dengan memasukkan fail CSS tersuai
$DATADIR/s5/lalai (untuk S5), $DATADIR/slidy (untuk Slidy), atau $DATADIR/slideous (untuk
Slideous), dengan $DATADIR ialah direktori data pengguna (lihat --data-dir, di atas). The
asal boleh didapati dalam direktori data sistem pandoc (umumnya
$CABALDIR/pandoc-VERSION/s5/default). Pandoc akan mencari di sana untuk sebarang fail yang tidak
cari dalam direktori data pengguna.
Untuk dzslides, CSS disertakan dalam fail HTML itu sendiri, dan boleh diubah suai di sana.
Semua pilihan konfigurasi reveal.js boleh ditetapkan melalui pembolehubah. Sebagai contoh, tema boleh
digunakan dengan menetapkan pembolehubah tema:
-V tema=bulan
Atau anda boleh menentukan lembaran gaya tersuai menggunakan pilihan --css.
Untuk menggayakan slaid beamer, anda boleh menentukan tema, tema warna, tema fon, tema dalaman dan
tema luar, menggunakan pilihan -V:
pandoc -t beamer habits.txt -V theme:Warsaw -o habits.pdf
Ambil perhatian bahawa atribut pengepala akan bertukar menjadi atribut slaid (pada a atau ) dalam
Format slaid HTML, membolehkan anda menggayakan slaid individu. Dalam beamer, satu-satunya tajuk
atribut yang mempengaruhi slaid ialah kelas allowframebreaks, yang menetapkan
pilihan allowframebreaks, menyebabkan berbilang slaid dibuat jika kandungan terlebih isi
bingkai itu. Ini disyorkan terutamanya untuk bibliografi:
# Rujukan {.allowframebreaks}
Speaker nota
reveal.js mempunyai sokongan yang baik untuk nota pembesar suara. Anda boleh menambah nota pada dokumen Markdown anda
Oleh itu:
Ini nota saya.
- Ia boleh mengandungi Markdown
- seperti senarai ini
Untuk menunjukkan tetingkap nota, tekan s semasa melihat pembentangan. Nota belum lagi
disokong untuk format slaid lain, tetapi nota tidak akan muncul pada slaid itu sendiri.
Frame sifat-sifat in beamer
Kadangkala adalah perlu untuk menambah pilihan LaTeX [fragile] pada bingkai dalam beamer (untuk
contoh, apabila menggunakan persekitaran yang ditempa). Ini boleh dipaksa dengan menambah yang rapuh
kelas ke pengepala yang memperkenalkan slaid:
# Slaid rapuh {.fragile}
Semua atribut bingkai lain yang diterangkan dalam Bahagian 8.1 Panduan Pengguna Beamer boleh
juga boleh digunakan: allowdisplaybreaks, allowframebreaks, b, c, t, persekitaran, label, biasa,
mengecil.
MENCIPTA EPUBS DENGAN PANDOC
EPUB Metadata
Metadata EPUB boleh ditentukan menggunakan pilihan --epub-metadata, tetapi jika sumbernya
dokumen ialah Markdown, lebih baik menggunakan blok metadata YAML. Berikut adalah contoh:
---
tajuk:
- jenis: utama
teks: Buku Saya
- jenis: sari kata
teks: Penyiasatan metadata
pencipta:
- peranan: pengarang
teks: John Smith
- peranan: editor
teks: Sarah Jones
pengecam:
- skim: DOI
teks: doi:10.234234.234/33
penerbit: My Press
hak: © 2007 John Smith, CC BY-NC
...
Medan berikut diiktiraf:
pengecam
Sama ada nilai rentetan atau objek dengan teks dan skema medan. Nilai yang sah untuk
skim ialah ISBN-10, GTIN-13, UPC, ISMN-10, DOI, LCCN, GTIN-14, ISBN-13,
Nombor deposit sah, URN, OCLC, ISMN-13, ISBN-A, JP, OLCC.
tajuk Sama ada nilai rentetan, atau objek dengan medan fail-sebagai dan jenis, atau senarai sedemikian
objek. Nilai yang sah untuk jenis ialah utama, sari kata, pendek, koleksi, edisi,
dipanjangkan.
pembuat
Sama ada nilai rentetan, atau objek dengan peranan medan, fail sebagai dan teks, atau senarai
daripada objek tersebut. Nilai yang sah untuk peranan ialah penghubung MARC, tetapi pandoc akan mencuba
untuk menterjemah versi yang boleh dibaca manusia (seperti "pengarang" dan "editor") kepada
relator marc yang sesuai.
penyumbang
Format yang sama seperti pencipta.
tarikh Nilai rentetan dalam format YYYY-MM-DD. (Hanya tahun yang diperlukan.) Pandoc akan
cuba menukar format tarikh biasa yang lain.
lang (Atau warisan: bahasa)
Nilai rentetan dalam format BCP 47. Pandoc akan lalai kepada bahasa tempatan jika
tiada yang dinyatakan.
tertakluk
Nilai rentetan atau senarai nilai tersebut.
Penerangan
Nilai rentetan.
jenis Nilai rentetan.
format Nilai rentetan.
berhubung
Nilai rentetan.
liputan
Nilai rentetan.
hak Nilai rentetan.
cover-image
Nilai rentetan (laluan ke imej penutup).
stylesheet
Nilai rentetan (laluan ke lembaran gaya CSS).
arah kemajuan halaman
Sama ada ltr atau rtl. Menentukan atribut halaman-kemajuan-arah untuk
unsur tulang belakang.
Berkaitan purata
Secara lalai, pandoc akan memuat turun media terpaut (termasuk audio dan video) dan menyertakannya
dalam bekas EPUB, menghasilkan EPUB serba lengkap. Jika anda ingin memaut ke
sumber media luaran sebaliknya, gunakan HTML mentah dalam sumber anda dan tambahkan data-external="1" ke
tag dengan atribut src. Sebagai contoh:
<sumber src="/http://example.com/music/toccata.mp3"
data-external="1" type="audio/mpeg">
celik huruf HASKELL PERTANYAAN
Jika anda menambahkan +lhs (atau +literate_haskell) pada format input atau output yang sesuai
(markdown, markdown_strict, pertama, atau lateks untuk input atau output; beamer, html atau html5 untuk
output sahaja), pandoc akan menganggap dokumen sebagai sumber Haskell yang celik. Ini bermakna bahawa
· Dalam input Markdown, bahagian "track burung" akan dihuraikan sebagai kod Haskell dan bukannya
petikan blok. Teks antara \begin{code} dan \end{code} juga akan dianggap sebagai
Kod Haskell. Untuk pengepala gaya ATX aksara '=' akan digunakan dan bukannya '#'.
· Dalam output Markdown, blok kod dengan kelas haskell dan literate akan diberikan menggunakan
jejak burung, dan petikan blok akan diinden satu ruang, jadi mereka tidak akan
dianggap sebagai kod Haskell. Di samping itu, pengepala akan diberikan gaya seteks (dengan
garis bawah) dan bukannya gaya ATX (dengan aksara '#'). (Ini kerana ghc merawat
aksara '#' dalam lajur 1 sebagai memperkenalkan nombor baris.)
· Dalam input teks yang distruktur semula, bahagian "jejak burung" akan dihuraikan sebagai kod Haskell.
· Dalam output teks yang distruktur semula, blok kod dengan haskell kelas akan diberikan menggunakan burung
trek.
· Dalam input LaTeX, teks dalam persekitaran kod akan dihuraikan sebagai kod Haskell.
· Dalam output LaTeX, blok kod dengan haskell kelas akan diberikan di dalam kod
persekitaran.
· Dalam output HTML, blok kod dengan haskell kelas akan diberikan dengan kelas
literatehaskell dan jejak burung.
Contoh:
pandoc -f markdown+lhs -t html
membaca sumber Haskell celik yang diformatkan dengan konvensyen Markdown dan menulis HTML biasa
(tanpa jejak burung).
pandoc -f markdown+lhs -t html+lhs
menulis HTML dengan kod Haskell dalam trek burung, jadi ia boleh disalin dan ditampal sebagai
celik sumber Haskell.
SISTEM MENYERLAHKAN
Pandoc secara automatik akan menyerlahkan sintaks dalam blok kod berpagar yang ditandakan dengan a
nama bahasa. Pustaka Haskell highlighting-kate digunakan untuk menyerlahkan, yang
berfungsi dalam HTML, Docx dan output LaTeX/PDF. Skim warna boleh dipilih menggunakan
--pilihan gaya sorotan. Skim warna lalai ialah pygments, yang meniru
skema warna lalai yang digunakan oleh pygments perpustakaan Python, tetapi pygments sebenarnya tidak
digunakan untuk melakukan highlighting.
Untuk melihat senarai nama bahasa yang akan dikenali oleh pandoc, taip pandoc --version.
Untuk melumpuhkan penyerlahan, gunakan pilihan --no-highlight.
CUSTOM PENULIS
Pandoc boleh dilanjutkan dengan penulis tersuai yang ditulis dalam lua. (Pandoc termasuk lua
penterjemah, jadi lua tidak perlu dipasang secara berasingan.)
Untuk menggunakan penulis tersuai, hanya tentukan laluan ke skrip lua sebagai ganti output
format. Sebagai contoh:
pandoc -t data/sample.lua
Mencipta penulis tersuai memerlukan menulis fungsi lua untuk setiap elemen yang mungkin dalam a
dokumen pandoc. Untuk mendapatkan contoh yang didokumenkan yang boleh anda ubah suai mengikut anda
keperluan, lakukan
pandoc --print-default-data-file sample.lua
PENGARANG
© 2006-2015 John MacFarlane ([e-mel dilindungi]). Dikeluarkan di bawah GPL, versi 2 atau
lebih besar. Perisian ini tidak membawa sebarang waranti. (Lihat HAK CIPTA untuk penuh
notis hak cipta dan waranti.)
Penyumbang termasuk 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 dan Xavier Olive.
Kod sumber Pandoc dan semua dokumentasi boleh dimuat turun daripadahttp://pandoc.org>.
Gunakan pandoc dalam talian menggunakan perkhidmatan onworks.net
