git.iko.soy/typeable/pandoc
on b784ce8 help sign in
b8e0b46
swap
0 ahead, 7335 behind
.circleci/config.ymldeleted−72
since splitsnapshots
unifiedsplit
@@ -1,72 +0,0 @@
1−version: "2.1"
2−jobs:
3− build:
4− macos:
5− xcode: 11.1.0
6− environment:
7− HOMEBREW_NO_AUTO_UPDATE: 1
8− steps:
9− - checkout
10− - restore_cache:
11− # See https://circleci.com/docs/2.0/caching/
12− name: Restore Cached Dependencies
13− keys:
14− - stack-dependencies-{{ checksum "stack.yaml" }}
15− - run:
16− name: Install stack
17− command: stack --version || (curl -sSL https://get.haskellstack.org/ | sh -s - -f)
18− - run:
19− name: Resolve/Update Dependencies
20− command: stack --no-terminal setup
21− - run:
22− name: Run tests
23− command: stack --no-terminal test
24− - run:
25− name: Install executable
26− command: stack --no-terminal install
27− - run:
28− name: Create artifacts
29− command: |
30− export VERSION=$(grep '^[Vv]ersion:' pandoc.cabal | awk '{print $$2;}')
31− export ARTIFACTS=macos-release-candidate
32− export RESOURCES=${ARTIFACTS}/Resources
33− export ROOT=${ARTIFACTS}/pandoc
34− export DEST=${ROOT}/usr/local
35− export ME=$(whoami)
36− export BASE=pandoc-$VERSION
37− mkdir -p ${ARTIFACTS}
38− mkdir -p ${RESOURCES}
39− mkdir -p ${DEST}/bin
40− mkdir -p ${DEST}/share/man/man1
41− cp ~/.local/bin/pandoc ${DEST}/bin/
42− strip ${DEST}/bin/pandoc
43− cp man/pandoc.1 ${DEST}/share/man/man1/pandoc.1
44− ~/.local/bin/pandoc -s COPYING.md -Vpagetitle=License -o ${RESOURCES}/license.html
45− chown -R $ME:staff ${ROOT}
46− sed -e "s/PANDOCVERSION/${VERSION}/" macos/distribution.xml.in > ${ARTIFACTS}/distribution.xml
47− cp macos/Makefile ${ARTIFACTS}/
48− echo ${VERSION} > ${ARTIFACTS}/version.txt
49− zip -r macos-release-candidate.zip ${ARTIFACTS}
50−
51− - save_cache:
52− name: Cache Dependencies
53− key: stack-dependencies-{{ checksum "stack.yaml" }}
54− paths:
55− - "/root/.stack"
56− - ".stack-work"
57− - "/usr/local/bin/stack"
58−
59− - store_artifacts:
60− # https://circleci.com/docs/2.0/artifacts/
61− path: macos-release-candidate.zip
62− destination: macos-release-candidate.zip
63−
64−workflows:
65− version: 2
66− release:
67− jobs:
68− - build:
69− filters:
70− branches:
71− only:
72− - /rc\/.*/
.editorconfig+1−9
@@ -8,17 +8,9 @@ indent_size = 2
8insert_final_newline = true
8insert_final_newline = true
9trim_trailing_whitespace = true
9trim_trailing_whitespace = true
10
10
11−[*.{zip,docx}]
12−charset =
13−end_of_line =
14−indent_style =
15−indent_size =
16−insert_final_newline =
17−trim_trailing_whitespace =
18−
19[*.{markdown,md}]
11[*.{markdown,md}]
20trim_trailing_whitespace = false
12trim_trailing_whitespace = false
21
13
22−[test/*]
14+[tests/*]
23insert_final_newline = false
15insert_final_newline = false
24trim_trailing_whitespace = false
16trim_trailing_whitespace = false
.gitattributesdeleted−1
@@ -1 +0,0 @@
1−test/fb2/reader/* -text
.github/FUNDING.ymldeleted−1
@@ -1 +0,0 @@
1−github: [jgm,tarleb]
.github/ISSUE_TEMPLATE/bug_report.mddeleted−25
@@ -1,25 +0,0 @@
1−---
2−name: Bug report
3−about: Create a report to help us improve
4−title: ''
5−labels: 'bug'
6−assignees: ''
7−
8−---
9−
10−<!--
11−Thank you for reporting an issue! Before you continue, please make sure that you have
12−
13−- searched the issue tracker for similar issues (including closed issues): https://github.com/jgm/pandoc/issues
14−- searched the pandoc-discuss mailing list for solutions: https://groups.google.com/forum/#!forum/pandoc-discuss
15−- reproduced your issue on the latest release of pandoc, or on https://pandoc.org/try
16−
17−Note that this bug tracker is for reporting bugs, not asking questions. For questions, use the pandoc-discuss mailing list.
18−-->
19−
20−**Explain the problem.**
21−Include the exact command line you used and all inputs necessary to reproduce the issue. Please create as minimal an example as possible, to help the maintainers isolate the problem. Explain the output you received and how it differs from what you expected.
22−
23−**Pandoc version?**
24−What version of pandoc are you using, on what OS?
25−
.github/ISSUE_TEMPLATE/config.ymldeleted−9
@@ -1,9 +0,0 @@
1−blank_issues_enabled: false
2−contact_links:
3− - name: Ask a question
4− url: https://groups.google.com/forum/#!forum/pandoc-discuss
5− about: "Discussion forum for pandoc (may be used as an email list)"
6− - name: Contributing Guidelines
7− url: https://pandoc.org/CONTRIBUTING.html
8− about: "Guidelines for submitting bug reports and code improvements"
9−
.github/ISSUE_TEMPLATE/feature_request.mddeleted−21
@@ -1,21 +0,0 @@
1−---
2−name: Feature request
3−about: Suggest an idea for this project
4−title: ''
5−labels: 'enhancement'
6−assignees: ''
7−
8−---
9−
10−<!--
11−Thank you for suggesting a feature! Before you continue, please make sure that you have
12−
13−- read the contributing guidelines: https://pandoc.org/CONTRIBUTING.html
14−- searched the issue tracker for similar issues (including closed issues): https://github.com/jgm/pandoc/issues
15−- searched the pandoc-discuss mailing list for relevant discussions: https://groups.google.com/forum/#!forum/pandoc-discuss
16−-->
17−
18−**Describe your proposed improvement and the problem it solves.**
19−
20−**Describe alternatives you've considered.**
21−
.github/workflows/ci.ymldeleted−275
@@ -1,275 +0,0 @@
1−name: CI tests
2−
3−on:
4− push:
5− branches:
6− - '*'
7− - '!rc/*'
8− paths-ignore:
9− - 'doc/**'
10− - 'MANUAL.txt'
11− - '*.md'
12− - 'RELEASE_CHECKLIST'
13− - 'BUGS'
14− - 'changelog'
15− - 'README.template'
16− - 'appveyor.yml'
17− - 'tools/**'
18− - 'linux/**'
19− - 'macos/**'
20− - 'windows/**'
21− - 'man/**'
22− pull_request:
23− paths-ignore:
24− - 'doc/**'
25− - 'MANUAL.txt'
26− - '*.md'
27− - 'RELEASE_CHECKLIST'
28− - 'BUGS'
29− - 'changelog'
30− - 'README.template'
31− - 'appveyor.yml'
32− - 'tools/**'
33− - 'linux/**'
34− - 'macos/**'
35− - 'windows/**'
36− - 'man/**'
37−
38−jobs:
39− linux:
40−
41− runs-on: ubuntu-18.04
42− strategy:
43− fail-fast: true
44− matrix:
45− versions:
46− - ghc: '8.0.2'
47− cabal: '2.4'
48− prefix: 'v2-'
49− cabalopts: ''
50− testopts: ''
51− - ghc: '8.2.2'
52− cabal: '2.4'
53− prefix: 'v2-'
54− cabalopts: ''
55− testopts: ''
56− - ghc: '8.4.4'
57− cabal: '2.4'
58− prefix: 'v2-'
59− cabalopts: '-f-embed_data_files'
60− testopts: ''
61− - ghc: '8.6.5'
62− cabal: '3.2'
63− prefix: ''
64− cabalopts: ''
65− testopts: '--test-option=--hide-successes'
66− - ghc: '8.8.4'
67− cabal: '3.2'
68− prefix: ''
69− cabalopts: ''
70− testopts: '--test-option=--hide-successes'
71− - ghc: '8.10.4'
72− cabal: '3.2'
73− prefix: ''
74− cabalopts: '-ftrypandoc'
75− testopts: '--test-option=--hide-successes'
76− - ghc: '9.0.1'
77− cabal: '3.4'
78− prefix: ''
79− cabalopts: ''
80− testopts: '--test-option=--hide-successes'
81− steps:
82− - uses: actions/checkout@v2
83−
84− # needed by memory
85− - name: Install numa
86− run: sudo apt-get install libnuma-dev
87−
88− # need to install older cabal/ghc versions from ppa repository
89−
90− - name: Install recent cabal/ghc
91− uses: haskell/actions/setup@v1
92− with:
93− ghc-version: ${{ matrix.versions.ghc }}
94− cabal-version: ${{ matrix.versions.cabal }}
95−
96− # declare/restore cached things
97− # caching doesn't work for scheduled runs yet
98− # https://github.com/actions/cache/issues/63
99−
100− - name: Cache cabal global package db
101− id: cabal-global
102− uses: actions/cache@v2
103− with:
104− path: |
105− ~/.cabal
106− key: ${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-global-${{ hashFiles('cabal.project') }}
107−
108− - name: Cache cabal work
109− id: cabal-local
110− uses: actions/cache@v2
111− with:
112− path: |
113− dist-newstyle
114− key: ${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-local
115−
116− - name: Install dependencies
117− run: |
118− cabal ${{ matrix.versions.prefix }}update
119− cabal ${{ matrix.versions.prefix }}build ${{ matrix.versions.cabalopts }} --dependencies-only --enable-tests --disable-optimization
120−
121− - name: Build and test
122− run: |
123− cabal ${{ matrix.versions.prefix }}build ${{ matrix.versions.cabalopts }} --enable-tests --disable-optimization 2>&1 | tee build.log
124− # fail if warnings in local build
125− ! grep -q ": *[Ww]arning:" build.log || exit 1
126− cabal ${{ matrix.versions.prefix }}test ${{ matrix.versions.cabalopts }} --disable-optimization ${{ matrix.versions.testopts }}
127−
128− windows:
129−
130− runs-on: windows-2019
131−
132− steps:
133− - uses: actions/checkout@v2
134−
135− # We should have ghc 8.10, cabal, stack pre-installed
136− # - uses: haskell/actions/setup@v1
137− # with:
138− # enable-stack: true
139− # stack-version: 'latest'
140−
141− # declare/restore cached things
142− # caching doesn't work for scheduled runs yet
143− # https://github.com/actions/cache/issues/63
144−
145− - name: Cache stack global package db
146− id: stack-global-package-db
147− uses: actions/cache@v2
148− with:
149− path: |
150− C:\Users\runneradmin\AppData\Roaming\stack\
151− key: ${{ runner.os }}-appdata-roaming-stack-${{ hashFiles('stack.yaml') }}
152−
153− # stack's local package dbs for the project and each package
154− # - name: Cache .stack-work
155− # uses: actions/cache@v1
156− # with:
157− # path: .stack-work
158− # key: ${{ runner.os }}-stack-work-${{ hashFiles('stack.yaml') }}
159− # restore-keys: ${{ runner.os }}-stack-work
160−
161− - name: Install dependencies
162− run: |
163− stack update
164− stack install happy
165− stack test --dependencies-only --fast
166− - name: Build and test
167− shell: cmd
168− run: |
169− stack test --fast --test-arguments=--hide-successes
170−
171− macos:
172−
173− runs-on: macOS-10.15
174− strategy:
175− fail-fast: true
176− matrix:
177− versions:
178− - ghc: '8.8.4'
179− cabal: '3.2'
180−
181− steps:
182− - uses: actions/checkout@v2
183−
184− - name: Install recent cabal/ghc
185− uses: haskell/actions/setup@v1
186− with:
187− ghc-version: ${{ matrix.versions.ghc }}
188− cabal-version: ${{ matrix.versions.cabal }}
189−
190− # declare/restore cached things
191− # caching doesn't work for scheduled runs yet
192− # https://github.com/actions/cache/issues/63
193−
194− - name: Cache cabal global package db
195− id: cabal-global
196− uses: actions/cache@v2
197− with:
198− path: |
199− ~/.cabal
200− key: ${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-global-${{ hashFiles('cabal.project') }}
201−
202− - name: Cache cabal work
203− id: cabal-local
204− uses: actions/cache@v2
205− with:
206− path: |
207− dist-newstyle
208− key: ${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-local
209−
210− - name: Install dependencies
211− run: |
212− cabal v2-update
213− cabal v2-build --dependencies-only --enable-tests --disable-optimization
214− - name: Build and test
215− run: |
216− cabal v2-build --enable-tests --disable-optimization 2>&1 | tee build.log
217− # fail if warnings in local build
218− ! grep -q ": *[Ww]arning:" build.log || exit 1
219− cabal v2-test --disable-optimization
220−
221− benchmark:
222−
223− runs-on: ubuntu-18.04
224− strategy:
225− fail-fast: true
226− matrix:
227− versions:
228− - ghc: '8.8.4'
229− cabal: '3.2'
230− - ghc: '8.10.2'
231− cabal: '3.2'
232− steps:
233− - uses: actions/checkout@v2
234−
235− # need to install older cabal/ghc versions from ppa repository
236−
237− - name: Install recent cabal/ghc
238− uses: haskell/actions/setup@v1
239− with:
240− ghc-version: ${{ matrix.versions.ghc }}
241− cabal-version: ${{ matrix.versions.cabal }}
242−
243− # declare/restore cached things
244− # caching doesn't work for scheduled runs yet
245− # https://github.com/actions/cache/issues/63
246−
247− - name: Cache cabal global package db
248− id: cabal-global
249− uses: actions/cache@v2
250− with:
251− path: |
252− ~/.cabal
253− key: benchmark-${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-global-${{ hashFiles('cabal.project') }}
254−
255− - name: Cache cabal work
256− id: cabal-local
257− uses: actions/cache@v2
258− with:
259− path: |
260− dist-newstyle
261− key: benchmark-${{ runner.os }}-${{ matrix.versions.ghc }}-${{ matrix.versions.cabal }}-cabal-local
262−
263− - name: Install dependencies
264− run: |
265− v2=$([ "${{ matrix.versions.cabal }}" = "2.2" ] && printf 'new' || printf 'v2')
266− cabal $v2-update
267− cabal $v2-build --dependencies-only --enable-optimization=1 --enable-benchmarks --disable-tests
268−
269− - name: Build and test
270− run: |
271− v2=$([ "${{ matrix.versions.cabal }}" = "2.2" ] && printf 'new' || printf 'v2')
272− cabal $v2-build --enable-optimization=1 --enable-benchmarks --disable-tests 2>&1 | tee build.log
273− # fail if warnings in local build
274− ! grep -q ": *[Ww]arning:" build.log || exit 1
275− cabal $v2-bench --enable-optimization=1 --benchmark-options='--timeout=6 +RTS -T -RTS'
.github/workflows/commit-validation.ymldeleted−38
@@ -1,38 +0,0 @@
1−name: commit-validation
2−on: [ push, pull_request ]
3−
4−jobs:
5− check-commit-msg-length:
6− runs-on: ubuntu-latest
7− steps:
8− - uses: actions/checkout@v1
9− - name: Check commit message length
10− run: |
11− # Get last commit messages
12− if [ "${{github.event_name}}" = "push" ]; then
13− if [ "${{github.event.before}}" = "0000000000000000000000000000000000000000" ]; then
14− # We are on a new branch
15− current="$(echo '${{github.ref}}' | sed 's!^refs/heads!origin!')"
16− readarray -t other < <(git show-ref | awk -F' ' '{ sub(/^refs\/remotes\//,"",$NF); }($NF != "'"$current"'"){print "^" $NF;}')
17− LOG_RANGE=( "$current" "${other[@]}" )
18− unset current other
19− else
20− # We are on existing branch
21− LOG_RANGE=( "${{github.event.before}}.." )
22− fi
23− elif [ "${{github.event_name}}" = "pull_request" ]; then
24− LOG_RANGE=( "origin/${{github.base_ref}}.." )
25− fi
26− if [[ -v LOG_RANGE ]]; then
27− if git log --no-merges --pretty=format:"%s" "${LOG_RANGE[@]}" -- | grep -qE "^[^#].{78}"; then
28− echo -e "Last commit log contains a line with more than 78 characters:\n"
29− git log --no-merges --pretty=format:"%h: %s" "${LOG_RANGE[@]}" -- | grep -E "^[^:]+: [^#].{78}"
30− echo
31− exit 1
32− else
33− echo "Commit log looks good."
34− fi
35− unset LOG_RANGE
36− else
37− echo "Not checking commits on ${{github.event_name}}"
38− fi
.github/workflows/format-validation.ymldeleted−88
@@ -1,88 +0,0 @@
1−name: Format validation
2−
3−on:
4− push:
5− branches:
6− - '*'
7− - '!rc/*'
8− paths:
9− - 'test/writer.jats_articleauthoring'
10− - 'test/writer.jats_publishing'
11− - 'test/writer.jats_archiving'
12− - 'test/tables.jats_archiving'
13− - 'test/tables/nordics.jats_archiving'
14− - 'test/tables/planets.jats_archiving'
15− - 'test/tables/students.jats_archiving'
16− pull_request:
17− branches:
18− - '*'
19− - '!rc/*'
20− paths:
21− - 'test/writer.jats_articleauthoring'
22− - 'test/writer.jats_publishing'
23− - 'test/writer.jats_archiving'
24− - 'test/tables.jats_archiving'
25− - 'test/tables/nordics.jats_archiving'
26− - 'test/tables/planets.jats_archiving'
27− - 'test/tables/students.jats_archiving'
28−
29−jobs:
30− jats:
31− name: JATS
32− runs-on: ubuntu-latest
33− env:
34− VALIDATOR_URL: "https://jats-validator.hubmed.org/dtd/"
35− strategy:
36− fail-fast: false
37− matrix:
38− tagset:
39− - articleauthoring
40− - publishing
41− - archiving
42− steps:
43− - name: Checkout
44− uses: actions/checkout@v2
45−
46− - name: Validate writer output
47− run: |
48− filename=test/writer.jats_${{ matrix.tagset }}
49− printf "Validating file %s\n" "$filename"
50− json="$(curl --form "xml=@${filename}" --silent "$VALIDATOR_URL")"
51− err_count="$(printf '%s' "$json" | jq '.errors | length')"
52− if [ "$err_count" -eq 0 ]; then
53− printf "File was validated successfully.\n"
54− exit 0
55− else
56− printf "Validator report:\n%s" "$json"
57− exit 1
58− fi
59−
60− - name: Validate tables
61− # Archiving has the simplest template, so we only check with that.
62− if: matrix.tagset == 'archiving'
63− run: |
64− tmpl="$(cat <<EOF
65− <?xml version="1.0" encoding="utf-8" ?>
66− <!DOCTYPE article PUBLIC "-//NLM//DTD JATS (Z39.96) Journal Archiving and Interchange DTD v1.2 20190208//EN"
67− "JATS-archivearticle1.dtd">
68− <article xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:xlink="http://www.w3.org/1999/xlink" dtd-version="1.2" article-type="other">
69− <front><article-meta></article-meta></front>
70− <body>%s</body></article>
71− EOF
72− )"
73− jats_file="$(mktemp jats-tables.XXXXX)"
74− exit_code=0
75− for f in tables tables/nordics tables/planets tables/students; do
76− filename=test/$f.jats_archiving
77− printf "Validating %s...\n" "$filename"
78− printf "$tmpl" "$(cat $filename)" > "$jats_file"
79− json="$(curl --form "xml=@${jats_file}" --silent "$VALIDATOR_URL")"
80− err_count="$(printf "%s" "$json" | jq '.errors | length')"
81− if [ "$err_count" -eq 0 ]; then
82− printf "Table output is valid when used as body content.\n"
83− else
84− printf "Validator report:\n%s" "$json"
85− exit_code=1
86− fi
87− done
88− exit "$exit_code"
.github/workflows/lint.ymldeleted−33
@@ -1,33 +0,0 @@
1−name: Lint
2−
3−# Trigger the workflow on push or pull request, but only for the
4−# master branch
5−on:
6− pull_request:
7− branch: [master]
8− push:
9− branch: [master]
10− paths-ignore:
11− - LICENSE
12− - README.md
13− - CHANGELOG.md
14− - stack.yaml
15− - .travis.yml
16−
17−jobs:
18− lint:
19− name: Lint
20− runs-on: ubuntu-latest
21− env:
22− hlint_script: https://raw.github.com/ndmitchell/hlint/master/misc/run.sh
23−
24− steps:
25− - name: Checkout
26− uses: actions/checkout@v2
27−
28− - name: Check cabal file for missing test files
29− run: make check-cabal
30−
31− - name: Download and run hlint
32− run: |
33− curl -sSL "${hlint_script}" | sh -s .
.github/workflows/nightly.ymldeleted−91
@@ -1,91 +0,0 @@
1−name: Nightly
2−
3−on:
4− schedule:
5− - cron: '53 7 * * *'
6−
7−jobs:
8− linux:
9−
10− runs-on: ubuntu-18.04
11− steps:
12− - uses: actions/checkout@v2
13−
14− - name: Install recent cabal/ghc
15− uses: haskell/actions/setup@v1
16− with:
17− ghc-version: '8.10.3'
18− cabal-version: '3.2'
19−
20− - name: Install dependencies
21− run: |
22− ghc --version
23− cabal --version
24− cabal v2-update
25− cabal v2-build --dependencies-only
26− - name: Build
27− run: |
28− cabal v2-install
29− strip $HOME/.cabal/bin/pandoc
30− - name: Install artifact
31− run: |
32− export ARTIFACTS=nightly-linux/pandoc-nightly-linux-$(date +%Y-%m-%d)
33− mkdir -p ${ARTIFACTS}
34− cp $HOME/.cabal/bin/pandoc ${ARTIFACTS}/
35− cp COPYRIGHT ${ARTIFACTS}/
36− echo "Built from ${GITHUB_SHA}" > ${ARTIFACTS}/README.nightly.txt
37− - uses: actions/upload-artifact@master
38− with:
39− name: nightly-linux
40− path: nightly-linux
41−
42− windows:
43−
44− runs-on: windows-2019
45−
46− steps:
47− - uses: actions/checkout@v2
48− - name: Install dependencies
49− run: |
50− stack update
51− stack build --dependencies-only pandoc
52− - name: Build artifacts
53− shell: cmd
54− run: |
55− for /f %%a in ('powershell -Command "Get-Date -format yyyy-MM-dd"') do set THEDATE=%%a
56− set ARTIFACTS=%CD%\nightly-windows\pandoc-nightly-windows-%THEDATE%
57− mkdir %ARTIFACTS%
58− stack build pandoc
59− forfiles /P .\.stack-work\install /M pandoc*.exe /S /C "cmd /C copy @path %%ARTIFACTS%%"
60− copy COPYRIGHT %ARTIFACTS%
61− ren %ARTIFACTS%\COPYRIGHT COPYRIGHT.txt
62− echo Built from %GITHUB_SHA% > %ARTIFACTS%\README.nightly.txt
63− - uses: actions/upload-artifact@master
64− with:
65− name: nightly-windows
66− path: nightly-windows
67−
68− macos:
69−
70− runs-on: macOS-10.15
71−
72− steps:
73− - uses: actions/checkout@v2
74− - name: Install dependencies
75− run: |
76− stack update
77− stack build --dependencies-only pandoc
78− - name: Build artifacts
79− run: |
80− export ARTIFACTS=nightly-macos/pandoc-nightly-macos-$(date +%Y-%m-%d)
81− mkdir -p ${ARTIFACTS}
82− stack build pandoc
83− for f in $(find .stack-work/install -name 'pandoc*' -perm +001 -type f); do cp $f ${ARTIFACTS}/; done
84− mv ${ARTIFACTS}/pandoc ${ARTIFACTS}/pandoc
85− cp COPYRIGHT ${ARTIFACTS}/
86− echo "Built from ${GITHUB_SHA}" > ${ARTIFACTS}/README.nightly.txt
87− - uses: actions/upload-artifact@master
88− with:
89− name: nightly-macos
90− path: nightly-macos
91−
.github/workflows/release-candidate.ymldeleted−83
@@ -1,83 +0,0 @@
1−name: Release candidate
2−
3−on:
4− push:
5− branches:
6− - 'rc/**'
7−
8−jobs:
9− linux:
10−
11− runs-on: ubuntu-18.04
12− steps:
13− - uses: actions/checkout@v1
14− - name: Create linux package
15− run: |
16− make debpkg
17− mkdir linux-release-candidate
18− cp linux/artifacts/*.deb linux-release-candidate/
19− cp linux/artifacts/*.tar.gz linux-release-candidate/
20− - uses: actions/upload-artifact@v2
21− with:
22− name: linux-release-candidate
23− path: linux-release-candidate
24−
25− windows:
26−
27− runs-on: windows-2019
28− strategy:
29− fail-fast: true
30− matrix:
31− versions:
32− - osarch: "windows-x86_64"
33− arch: "x64"
34− stack_opts: "-j1"
35− steps:
36− - uses: actions/checkout@v1
37− - name: Install dependencies
38− run: |
39− stack update
40− stack build ${{ matrix.versions.stack_opts }} --dependencies-only pandoc
41− - name: Create windows package
42− shell: cmd
43− run: |
44− for /f %%a in ('powershell -Command "Get-Date -format yyyy-MM-dd"') do set THEDATE=%%a
45− stack build ${{ matrix.versions.stack_opts }} pandoc
46− for /f "tokens=1-2 delims= " %%a in ('stack exec pandoc -- --version') do (
47− @set VERSION=%%b
48− goto :next
49− )
50− :next
51− if "%VERSION%" == "" (
52− echo Error: could not determine version number.
53− exit /b 1
54− )
55− echo Detected version %VERSION%
56− @set WINDOWS=%CD%\windows
57− @set RELEASE=%WINDOWS%\pandoc-%VERSION%
58− mkdir %RELEASE%
59− forfiles /P .\.stack-work\install /M pandoc.exe /S /C "cmd /C echo @path && echo %%WINDOWS%% && copy @path %%RELEASE%%"
60− stack exec pandoc -- -s --toc MANUAL.txt -o %RELEASE%\MANUAL.html
61− stack exec pandoc -- -s COPYING.md -t rtf -o %RELEASE%\COPYING.rtf
62− copy %RELEASE%\COPYING.rtf %WINDOWS%
63− copy COPYRIGHT %RELEASE%\COPYRIGHT.txt
64− cd windows
65− echo Creating msi...
66− dir
67− @set WIXBIN="c:\Program Files (x86)\WiX Toolset v3.11\bin"
68− @set WORKDIR=%CD%
69− echo Running candle...
70− %WIXBIN%\candle -arch ${{ matrix.versions.arch }} -dVERSION=%VERSION% -dBINPATH=%RELEASE% *.wxs -out wixobj\
71− if %errorlevel% neq 0 exit /b %errorlevel%
72− echo Running light...
73− %WIXBIN%\light -sw1076 -ext WixUIExtension -ext WixUtilExtension -cultures:en-us -loc Pandoc-en-us.wxl -out %WORKDIR%\pandoc-%VERSION%-${{ matrix.versions.osarch }}-UNSIGNED.msi wixobj\*.wixobj
74− 7z a "pandoc-%VERSION%-${{ matrix.versions.osarch }}.zip" pandoc-%VERSION%
75− cd ..
76− mkdir windows-release-candidate
77− copy windows\pandoc-%VERSION%-${{ matrix.versions.osarch }}-UNSIGNED.msi windows-release-candidate
78− copy windows\pandoc-%VERSION%-${{ matrix.versions.osarch }}.zip windows-release-candidate
79− copy windows\Makefile windows-release-candidate
80− - uses: actions/upload-artifact@v2
81− with:
82− name: windows-release-candidate
83− path: windows-release-candidate
.gitignore+1−11
@@ -1,10 +1,8 @@
1*~
1*~
2−.DS_Store
3−*.orig
4−deb/.vagrant
5dist/*
2dist/*
6MANUAL.*
3MANUAL.*
7!MANUAL.txt
4!MANUAL.txt
5+INSTALL.*
8.configure-stamp
6.configure-stamp
9.cabal-sandbox
7.cabal-sandbox
10cabal.sandbox.config
8cabal.sandbox.config
@@ -16,10 +14,6 @@ man/man?/*.html
16*.o
14*.o
17*.hi
15*.hi
18*.pyc
16*.pyc
19−.hie/
20−.policeman-evidence/
21−.projectile/
22−.vscode/
23/COPYING.rtf
17/COPYING.rtf
24/COPYRIGHT.txt
18/COPYRIGHT.txt
25/cabal-dev/
19/cabal-dev/
@@ -29,7 +23,3 @@ windows/*.wixobj
29data/reference.docx
23data/reference.docx
30data/reference.odt
24data/reference.odt
31.stack-work
25.stack-work
32−/stack.yaml.lock
33−cabal.project.local
34−/dist-newstyle/
35−pandoc-2*/
.gitmodulesnew file+3
@@ -0,0 +1,3 @@
1+[submodule "templates"]
2+ path = data/templates
3+ url = https://github.com/jgm/pandoc-templates.git
.hlint.yamldeleted−112
@@ -1,112 +0,0 @@
1−# HLint configuration file
2−# https://github.com/ndmitchell/hlint
3−##########################
4−
5−# Specify additional command line arguments
6−#
7−- arguments: [--color=auto, --cpp-ansi]
8−
9−# Ignore some builtin hints
10−#
11−- ignore: {name: "Avoid lambda"}
12−- ignore: {name: "Use bimap"}
13−- ignore: {name: "Eta reduce"}
14−- ignore: {name: "Evaluate"}
15−- ignore: {name: "Reduce duplication"} # TODO: could be more fine-grained
16−- ignore: {name: "Use &&&"}
17−- ignore: {name: "Use String"}
18−- ignore: {name: "Use camelCase"}
19−- ignore: {name: "Use fmap"} # specific for GHC 7.8 compat
20−- ignore: {name: "Use isDigit"}
21−
22−- ignore:
23− name: "Monad law, left identity"
24− within: Text.Pandoc.App.OutputSettings
25−
26−- ignore:
27− name: "Move brackets to avoid $"
28− within: Text.Pandoc.Writers.CslJson
29−
30−- ignore:
31− name: "Redundant <$>"
32− within:
33− - Text.Pandoc.Readers.Docx.Parse
34− - Text.Pandoc.Writers.MediaWiki
35− - Text.Pandoc.Writers.OpenDocument
36− - Text.Pandoc.Writers.Powerpoint.Output
37− - Text.Pandoc.Writers.Powerpoint.Presentation
38−
39−- ignore:
40− name: "Redundant return"
41− within: Text.Pandoc.Citeproc.BibTeX
42−
43−# With recent hlint this rule has given false positives on TH
44−- ignore:
45− name: "Redundant bracket"
46−
47−
48−- ignore:
49− name: "Use <$>"
50− within:
51− - Text.Pandoc.Readers.LaTeX
52− - Text.Pandoc.Readers.Markdown
53−
54−- ignore:
55− name: "Use camelCase"
56− within:
57− - Tests.Writers.Docbook
58− - Tests.Writers.Native
59− - Text.Pandoc.Citeproc
60− - Text.Pandoc.Extensions
61− - Text.Pandoc.Lua.Marshaling.Version
62− - Text.Pandoc.Lua.Module.Pandoc
63− - Text.Pandoc.Lua.Module.Utils
64− - Text.Pandoc.Readers.Odt.ContentReader
65− - Text.Pandoc.Readers.Odt.Namespaces
66−
67−- ignore:
68− name: "Use forM_"
69− within:
70− - Text.Pandoc.Readers.DocBook
71−
72−- ignore:
73− name: "Use Just"
74− within:
75− - Text.Pandoc.Citeproc.MetaValue
76− - Text.Pandoc.Readers.Odt.ContentReader
77− - Text.Pandoc.Writers.Roff
78−
79−- ignore:
80− name: "Use list comprehension"
81− within: Text.Pandoc.Citeproc.BibTeX
82−
83−- ignore:
84− name: "Use list literal pattern"
85− within: Text.Pandoc.Citeproc.MetaValue
86−
87−# TODO: check
88−- ignore:
89− name: "Use second"
90− within:
91− - Text.Pandoc.Citeproc.BibTeX
92− - Text.Pandoc.Citeproc.Locator
93−
94−# TODO: check
95−- ignore:
96− name: "Use sortOn"
97− within: Text.Pandoc.Writers.OpenDocument
98−
99−- ignore:
100− name: "Use tuple-section"
101− within:
102− - Text.Pandoc.Readers.EPUB
103− - Text.Pandoc.ImageSize
104− - Text.Pandoc.Readers.Markdown
105− - Text.Pandoc.Readers.RST
106−
107−# fromRight is only in base >= 4.10
108−- ignore:
109− name: "Use fromRight"
110−
111−# Define some custom infix operators
112−# - fixity: infixr 3 ~^#^~
.mailmapdeleted−37
@@ -1,37 +0,0 @@
1−Adam Brandizzi <brandizzi@gmail.com>
2−Albert Krewinkel <albert@zeitkraut.de> <albert+github@zeitkraut.de>
3−Albert Krewinkel <albert@zeitkraut.de> <albert.krewinkel@tourstream.eu>
4−Albert Krewinkel <albert@zeitkraut.de> <tarleb@moltkeplatz.de>
5−Albert Krewinkel <albert@zeitkraut.de> <tarleb@zeitkraut.de>
6−Alexander Krotov <ilabdsf@gmail.com>
7−Alex Ivkin <alex@ivkin.net>
8−Alex Ivkin <alex@ivkin.net> <alexivkin@users.noreply.github.com>
9−Andrew Dunning <andunning@gmail.com>
10−Andrew Dunning <andunning@gmail.com> <adunning@users.noreply.github.com>
11−Andrew Newman <andrewfnewman@gmail.com>
12−Clare Macrae <clare.macrae@googlemail.com> <github@cfmacrae.fastmail.co.uk>
13−Hugo Roy <hugo@fsfe.org>
14−Hugo Roy <hugo@xps.ampoliros.net>
15−John MacFarlane <jgm@berkeley.edu> <fiddlosopher@788f1e2b-df1e-0410-8736-df70ead52e1b>
16−John MacFarlane <jgm@berkeley.edu> <fiddlosopher@gmail.com>
17−John MacFarlane <jgm@berkeley.edu> <jgm@Johns-MacBook-Pro.local>
18−Jose Luis Duran <jlduran@gmail.com> <jlduran@users.noreply.github.com>
19−Marc Schreiber <schrieveslaach@online.de>
20−Masayoshi Takahashi <maki@rubycolor.org>
21−Matthew Pickering <matthewtpickering@gmail.com>
22−Mauro Bieg <mauro.bieg@gmail.com>
23−Mauro Bieg <mauro.bieg@gmail.com> <maurobieg@Mauros-MacBook-Air.local>
24−Mauro Bieg <mauro.bieg@gmail.com> <mb21@server.fake>
25−Mauro Bieg <mauro.bieg@gmail.com> <mb21@users.noreply.github.com>
26−Mauro Bieg <mb21@users.noreply.github.com>
27−Nils Carlson <nils.carlson@ludd.ltu.se>
28−Nils Carlson <nils.carlson@ludd.ltu.se> <pyssling@ludd.ltu.se>
29−Robin Lambertz <robinlambertz+dev@gmail.com>
30−Roland Hieber <rohieb@rohieb.name> <rohieb@users.noreply.github.com>
31−Sebastian Talmon <35015406+stalmon@users.noreply.github.com>
32−Sergei Trofimovich <slyfox@gentoo.org> <siarheit@google.com>
33−Sergei Trofimovich <slyfox@gentoo.org> <slyfox@inbox.ru>
34−Stefan Björk <stefan.bjork@gmail.com> <stefan@airistotle.local>
35−Thomas Hodgson <hello@twshodgson.net> <twsh@users.noreply.github.com>
36−Timm Albers <timmm.albers@gmail.com> <timm.albers@open-xchange.com>
37−Yan Pashkovsky <yanpaso@gmail.com> <Yanpas@users.noreply.github.com>
.stylish-haskell.yamldeleted−171
@@ -1,171 +0,0 @@
1−# stylish-haskell configuration file
2−# ==================================
3−
4−# The stylish-haskell tool is mainly configured by specifying steps. These steps
5−# are a list, so they have an order, and one specific step may appear more than
6−# once (if needed). Each file is processed by these steps in the given order.
7−steps:
8− # Convert some ASCII sequences to their Unicode equivalents. This is disabled
9− # by default.
10− # - unicode_syntax:
11− # # In order to make this work, we also need to insert the UnicodeSyntax
12− # # language pragma. If this flag is set to true, we insert it when it's
13− # # not already present. You may want to disable it if you configure
14− # # language extensions using some other method than pragmas. Default:
15− # # true.
16− # add_language_pragma: true
17−
18− # Align the right hand side of some elements. This is quite conservative
19− # and only applies to statements where each element occupies a single
20− # line.
21− - simple_align:
22− cases: true
23− top_level_patterns: true
24− records: true
25−
26− # Import cleanup
27− - imports:
28− # There are different ways we can align names and lists.
29− #
30− # - global: Align the import names and import list throughout the entire
31− # file.
32− #
33− # - file: Like global, but don't add padding when there are no qualified
34− # imports in the file.
35− #
36− # - group: Only align the imports per group (a group is formed by adjacent
37− # import lines).
38− #
39− # - none: Do not perform any alignment.
40− #
41− # Default: global.
42− align: none
43−
44− # Following options affect only import list alignment.
45− #
46− # List align has following options:
47− #
48− # - after_alias: Import list is aligned with end of import including
49− # 'as' and 'hiding' keywords.
50− #
51− # > import qualified Data.List as List (concat, foldl, foldr, head,
52− # > init, last, length)
53− #
54− # - with_alias: Import list is aligned with start of alias or hiding.
55− #
56− # > import qualified Data.List as List (concat, foldl, foldr, head,
57− # > init, last, length)
58− #
59− # - new_line: Import list starts always on new line.
60− #
61− # > import qualified Data.List as List
62− # > (concat, foldl, foldr, head, init, last, length)
63− #
64− # Default: after_alias
65− list_align: after_alias
66−
67− # Long list align style takes effect when import is too long. This is
68− # determined by 'columns' setting.
69− #
70− # - inline: This option will put as much specs on same line as possible.
71− #
72− # - new_line: Import list will start on new line.
73− #
74− # - new_line_multiline: Import list will start on new line when it's
75− # short enough to fit to single line. Otherwise it'll be multiline.
76− #
77− # - multiline: One line per import list entry.
78− # Type with constructor list acts like single import.
79− #
80− # > import qualified Data.Map as M
81− # > ( empty
82− # > , singleton
83− # > , ...
84− # > , delete
85− # > )
86− #
87− # Default: inline
88− long_list_align: inline
89−
90− # List padding determines indentation of import list on lines after import.
91− # This option affects 'list_align' and 'long_list_align'.
92− list_padding: 4
93−
94− # Separate lists option affects formatting of import list for type
95− # or class. The only difference is single space between type and list
96− # of constructors, selectors and class functions.
97− #
98− # - true: There is single space between Foldable type and list of it's
99− # functions.
100− #
101− # > import Data.Foldable (Foldable (fold, foldl, foldMap))
102− #
103− # - false: There is no space between Foldable type and list of it's
104− # functions.
105− #
106− # > import Data.Foldable (Foldable(fold, foldl, foldMap))
107− #
108− # Default: true
109− separate_lists: true
110−
111− # Language pragmas
112− - language_pragmas:
113− # We can generate different styles of language pragma lists.
114− #
115− # - vertical: Vertical-spaced language pragmas, one per line.
116− #
117− # - compact: A more compact style.
118− #
119− # - compact_line: Similar to compact, but wrap each line with
120− # `{-#LANGUAGE #-}'.
121− #
122− # Default: vertical.
123− style: vertical
124−
125− # Align affects alignment of closing pragma brackets.
126− #
127− # - true: Brackets are aligned in same column.
128− #
129− # - false: Brackets are not aligned together. There is only one space
130− # between actual import and closing bracket.
131− #
132− # Default: true
133− align: true
134−
135− # stylish-haskell can detect redundancy of some language pragmas. If this
136− # is set to true, it will remove those redundant pragmas. Default: true.
137− remove_redundant: true
138−
139− # Replace tabs by spaces. This is disabled by default.
140− # - tabs:
141− # # Number of spaces to use for each tab. Default: 8, as specified by the
142− # # Haskell report.
143− # spaces: 8
144−
145− # Remove trailing whitespace
146− - trailing_whitespace: {}
147−
148−# A common setting is the number of columns (parts of) code will be wrapped
149−# to. Different steps take this into account. Default: 80.
150−columns: 80
151−
152−# By default, line endings are converted according to the OS. You can override
153−# preferred format here.
154−#
155−# - native: Native newline format. CRLF on Windows, LF on other OSes.
156−#
157−# - lf: Convert to LF ("\n").
158−#
159−# - crlf: Convert to CRLF ("\r\n").
160−#
161−# Default: native.
162−newline: native
163−
164−# Sometimes, language extensions are specified in a cabal file or from the
165−# command line instead of using language pragmas in the file. stylish-haskell
166−# needs to be aware of these, so it can parse the file correctly.
167−#
168−# No language extensions are enabled by default.
169−# language_extensions:
170− # - TemplateHaskell
171− # - QuasiQuotes
.travis.ymlnew file+126
@@ -0,0 +1,126 @@
1+# Copy these contents into the root directory of your Github project in a file
2+# named .travis.yml
3+
4+# Use new container infrastructure to enable caching
5+sudo: false
6+
7+# Choose a lightweight base image; we provide our own build tools.
8+language: c
9+
10+# Caching so the next build will be fast too.
11+cache:
12+ directories:
13+ - $HOME/.ghc
14+ - $HOME/.cabal
15+ - $HOME/.stack
16+
17+# The different configurations we want to test. We have BUILD=cabal which uses
18+# cabal-install, and BUILD=stack which uses Stack. More documentation on each
19+# of those below.
20+#
21+# We set the compiler values here to tell Travis to use a different
22+# cache file per set of arguments.
23+#
24+# If you need to have different apt packages for each combination in the
25+# matrix, you can use a line such as:
26+# addons: {apt: {packages: [libfcgi-dev,libgmp-dev]}}
27+matrix:
28+ include:
29+ # We grab the appropriate GHC and cabal-install versions from hvr's PPA. See:
30+ # https://github.com/hvr/multi-ghc-travis
31+ - env: BUILD=cabal GHCVER=7.6.3 CABALVER=1.16
32+ compiler: ": #GHC 7.6.3"
33+ addons: {apt: {packages: [cabal-install-1.16,ghc-7.6.3], sources: [hvr-ghc]}}
34+ - env: BUILD=cabal GHCVER=7.8.4 CABALVER=1.18
35+ compiler: ": #GHC 7.8.4"
36+ addons: {apt: {packages: [cabal-install-1.18,ghc-7.8.4], sources: [hvr-ghc]}}
37+ - env: BUILD=cabal GHCVER=7.10.3 CABALVER=1.22
38+ compiler: ": #GHC 7.10.3"
39+ addons: {apt: {packages: [cabal-install-1.22,ghc-7.10.3], sources: [hvr-ghc]}}
40+
41+ - env: BUILD=cabal GHCVER=8.0.1 CABALVER=1.24
42+ compiler: ": #GHC 8.0.1"
43+ addons: {apt: {packages: [cabal-install-1.24,ghc-8.0.1], sources: [hvr-ghc]}}
44+
45+ # Build with the newest GHC and cabal-install. This is an accepted failure,
46+ # see below.
47+ - env: BUILD=cabal GHCVER=head CABALVER=head
48+ compiler: ": #GHC HEAD"
49+ addons: {apt: {packages: [cabal-install-head,ghc-head], sources: [hvr-ghc]}}
50+
51+ # The Stack builds. We can pass in arbitrary Stack arguments via the ARGS
52+ # variable, such as using --stack-yaml to point to a different file.
53+ - env: BUILD=stack ARGS="--resolver lts-6 --stack-yaml stack.lts6.yaml"
54+ compiler: ": #stack 7.10.3"
55+ addons: {apt: {packages: [ghc-7.10.3], sources: [hvr-ghc]}}
56+
57+ # Nightly builds are allowed to fail
58+ - env: BUILD=stack ARGS="--resolver nightly"
59+ compiler: ": #stack nightly"
60+ addons: {apt: {packages: [libgmp-dev]}}
61+
62+ - env: BUILD=stack ARGS="--resolver lts-6 --stack-yaml stack.lts6.yaml"
63+ compiler: ": #stack 7.10.3 osx"
64+ os: osx
65+
66+ - env: BUILD=stack ARGS="--resolver nightly"
67+ compiler: ": #stack nightly osx"
68+ os: osx
69+
70+ allow_failures:
71+ - env: BUILD=cabal GHCVER=head CABALVER=head
72+ - env: BUILD=stack ARGS="--resolver nightly"
73+
74+before_install:
75+# Using compiler above sets CC to an invalid value, so unset it
76+- unset CC
77+
78+# We want to always allow newer versions of packages when building on GHC HEAD
79+- CABALARGS=""
80+- if [ "x$GHCVER" = "xhead" ]; then CABALARGS=--allow-newer; fi
81+
82+# Download and unpack the stack executable
83+- export PATH=/opt/ghc/$GHCVER/bin:/opt/cabal/$CABALVER/bin:$HOME/.local/bin:$PATH
84+- mkdir -p ~/.local/bin
85+- |
86+ if [ `uname` = "Darwin" ]
87+ then
88+ curl --insecure -L https://www.stackage.org/stack/osx-x86_64 | tar xz --strip-components=1 --include '*/stack' -C ~/.local/bin
89+ else
90+ curl -L https://www.stackage.org/stack/linux-x86_64 | tar xz --wildcards --strip-components=1 -C ~/.local/bin '*/stack'
91+ fi
92+
93+install:
94+- echo "$(ghc --version) [$(ghc --print-project-git-commit-id 2> /dev/null || echo '?')]"
95+- if [ -f configure.ac ]; then autoreconf -i; fi
96+- |
97+ case "$BUILD" in
98+ stack)
99+ stack --no-terminal --install-ghc $ARGS test --only-dependencies
100+ ;;
101+ cabal)
102+ cabal --version
103+ travis_retry cabal update
104+ cabal install --only-dependencies --enable-tests --enable-benchmarks --force-reinstalls --ghc-options=-O0 --reorder-goals --max-backjumps=-1 $CABALARGS
105+ ;;
106+ esac
107+
108+script:
109+- |
110+ case "$BUILD" in
111+ stack)
112+ stack --no-terminal $ARGS test --haddock --no-haddock-deps --ghc-options="-Wall -fno-warn-unused-do-bind -Werror"
113+ ;;
114+ cabal)
115+ cabal configure --enable-tests --enable-benchmarks -v2 --ghc-options="-O0 -Werror"
116+ cabal build
117+ cabal check || [ "$CABALVER" == "1.16" ]
118+ cabal test
119+ cabal copy
120+ # cabal sdist fails on cabal 1.16:
121+ cabal sdist || [ "$CABALVER" == "1.16" ]
122+ SRC_TGZ=$(cabal info . | awk '{print $2;exit}').tar.gz && \
123+ (cd dist && cabal install --enable-tests --force-reinstalls "$SRC_TGZ" || \
124+ [ "$CABALVER" == "1.16" ])
125+ ;;
126+ esac
AUTHORS.mddeleted−330
@@ -1,330 +0,0 @@
1−# Contributors
2−
3−- Anabra
4−- Aner Lucero
5−- Arata Mizuki
6−- Arfon Smith
7−- Aaron Wolen
8−- Albert Krewinkel
9−- Alex Ivkin
10−- Alex Toldaiev
11−- Alex Vong
12−- Alexander Kondratskiy
13−- Alexander Krotov
14−- Alexander Sulfrian
15−- Alexander V Vershilov
16−- Alexandre Franke
17−- Alfred Wechselberger
18−- Amogh Rathore
19−- Anders Waldenborg
20−- Andreas Lööw
21−- Andrew Dunning
22−- Andy Morris
23−- Anti-Distinctlyminty
24−- Antoine Latter
25−- Antonio Terceiro
26−- Arata Mizuki
27−- Arfon Smith
28−- Arlo O'Keeffe
29−- Artyom Kazak
30−- Agustín Martín Barbero
31−- B. Scott Michel
32−- Ben Firshman
33−- Ben Gamari
34−- Ben Steinberg
35−- Beni Cherniavsky-Paskin
36−- Benoit Schweblin
37−- Bjorn Buckwalter
38−- Blake Eryx
39−- Bodigrim
40−- Bradley Kuhn
41−- Brent Yorgey
42−- Brian Leung
43−- Bryan O'Sullivan
44−- Caleb McDaniel
45−- Caleb Mclennan
46−- Calvin Beck
47−- Carlos Sosa
48−- Cécile Chemin
49−- Cédric Couralet
50−- Charanjit Singh
51−- Chris Black
52−- Christian Conkle
53−- Christian Despres
54−- Christoffer Ackelman
55−- Christoffer Sawicki
56−- Clare Macrae
57−- Clint Adams
58−- Conal Elliott
59−- Cormac Relf
60−- Craig S. Bosma
61−- Damien Clochard
62−- Daniel Bergey
63−- Daniel Maslowski
64−- Daniel T. Staal
65−- Daniele D'Orazio
66−- David A Roberts
67−- David Lazar
68−- David Martschenko
69−- David Röthlisberger
70−- Denis Laxalde
71−- Denis Maier
72−- Derek Chen-Becker
73−- Diego Balseiro
74−- Dimitri Sabadie
75−- Dmitry Pogodin
76−- Dmitry Volodin
77−- Douglas Calvert
78−- Eigil Rischel
79−- Emanuel Evans
80−- Emerson Harkin
81−- Emily Bourke
82−- Emily Eisenberg
83−- Eric Kow
84−- Erik Rask
85−- Eric Seidel
86−- Eric Schrijver
87−- Ethan Riley
88−- Étienne Bersac
89−- Felix Yan
90−- Félix Baylac-Jacqué
91−- Florian Beeres
92−- Florian Eitel
93−- Florian Klink
94−- Florian Kohrt
95−- Francesco Occhipinti
96−- François Gannaz
97−- Frederik Elwert
98−- Freiric Barral
99−- Freirich Raabe
100−- Frerich Raabe
101−- Fyodor Sheremetyev
102−- Gabor Pali
103−- Gavin Beatty
104−- Gottfried Haider
105−- Greg Maslov
106−- Greg Rundlett
107−- Grégory Bataille
108−- Gwern Branwen
109−- Hamish Mackenzie
110−- Hans-Peter Deifel
111−- Heiko Schlittermann
112−- Henrik Tramberend
113−- Henry de Valence
114−- Hubert Plociniczak
115−- Ian Max Andolina
116−- Igor Khorlo
117−- Igor Pashev
118−- Ilya V. Portnov
119−- Ivan Trubach
120−- Ivo Clarysse
121−- Jared Lander
122−- J. B. Rainsberger
123−- J. Lewis Muir
124−- Jaime Marquínez Ferrándiz
125−- Jake Zimmerman
126−- Jakob Voß
127−- James Aspnes
128−- Jamie F. Olson
129−- Jan Larres
130−- Jan Schulz
131−- Jan Tojnar
132−- Jan-Otto Kröpke
133−- Jason Ronallo
134−- Jeff Arnold
135−- Jeff Runningen
136−- Jens Getreu
137−- Jens Petersen
138−- Jeroen de Haas
139−- Jerry Sky
140−- Jesse Rosenthal
141−- Joe Hermaszewski
142−- Joe Hillenbrand
143−- John KetzerX
144−- John MacFarlane
145−- John Muccigrosso
146−- John Luke Bentley
147−- Jonas Smedegaard
148−- Jonas Scholl
149−- Jonathan Daugherty
150−- Jose Luis Duran
151−- José de Mattos Neto
152−- Josef Svenningsson
153−- Joseph C. Sible
154−- Julien Cretel
155−- Julien Dutant
156−- Juliette Fourcot
157−- Juliusz Gonera
158−- Justin Bogner
159−- Jérémy Bobbio
160−- Karl Pettersson
161−- Keiichiro Shikano
162−- Kelsey Hightower
163−- Kolen Cheung
164−- Konstantin Zudov
165−- Kristof Bastiaensen
166−- Krystof Beuermann
167−- Herwig Stuetz
168−- Lars-Dominik Braun
169−- Laurent P. René de Cotret
170−- Leif Metcalf
171−- Leonard Rosenthol
172−- Lila
173−- Loïc Grobol
174−- Lorenzo
175−- Lucas Escot
176−- Luke Plant
177−- Marc Schreiber
178−- Mark Szepieniec
179−- Mark Wright
180−- Martin Linn
181−- Masayoshi Takahashi
182−- Matej Kollar
183−- Mathias Schenner
184−- Mathias Walter
185−- Mathieu Boespflug
186−- Mathieu Duponchelle
187−- Matthew Doty
188−- Matthew Eddey
189−- Matthew Pickering
190−- Matthias C. M. Troffaes
191−- Mauro Bieg
192−- Max Bolingbroke
193−- Max Rydahl Andersen
194−- Merijn Verstraaten
195−- Michael Beaumont
196−- Michael Chladek
197−- Michael Hoffmann
198−- Michael Peyton Jones
199−- Michael Reed
200−- Michael Snoyman
201−- Michael Thompson
202−- Mike Tzou
203−- MinRK
204−- Morton Fox
205−- Nathan Gass
206−- Neil Mayhew
207−- Nick Bart
208−- Nick Berendsen
209−- Nick Fleisher
210−- Nicolas Kaiser
211−- Nikolay Yakimov
212−- Nils Carlson
213−- Nixon Enraght-Moony
214−- Nokome Bentley
215−- Ole Martin Ruud
216−- Oliver Matthews
217−- Ophir Lifshitz
218−- Or Neeman
219−- OvidiusCicero
220−- Owen McGrath
221−- Pablo Rodríguez
222−- Pascal Wagler
223−- Paul Tilley
224−- Paul Rivier
225−- Paulo Tanimoto
226−- Pete Ryland
227−- Peter Wang
228−- Philip Pesca
229−- Philippe Ombredanne
230−- Phillip Alday
231−- Prayag Verma
232−- Puneeth Chaganti
233−- Ralf Stephan
234−- Raniere Silva
235−- Raymond Ehlers
236−- Recai Oktaş
237−- Roland Hieber
238−- Roman Beránek
239−- RyanGlScott
240−- Salim B
241−- Sascha Wilde
242−- Scott Morrison
243−- Sebastian Talmon
244−- Sergei Trofimovich
245−- Sergey Astanin
246−- Shahbaz Youssefi
247−- Shaun Attfield
248−- Shim Myeongseob
249−- Shin Sang-jae
250−- Sidarth Kapur
251−- Sidharth Kapur
252−- Simon Hengel
253−- Stefan Dresselhaus
254−- Sumit Sahrawat
255−- Tarik Graba
256−- Tatiana Porras
257−- Thenaesh Elango
258−- Thomas Hodgson
259−- Thomas Weißschuh
260−- Tim Lin
261−- Timm Albers
262−- Timothy Humphries
263−- Tiziano Müller
264−- Todd Sifleet
265−- Tom Leese
266−- Tristan de Cacqueray
267−- Tristan Stenner
268−- Uli Köhler
269−- Urs Liska
270−- Václav Zeman
271−- Václav Haisman
272−- Vaibhav Sagar
273−- Vanessa McHale
274−- Vasily Alferov
275−- Viktor Kronvall
276−- Vincent
277−- Vlad Hanciuta
278−- Wandmalfarbe
279−- Waldir Pimenta
280−- Wikiwide
281−- Winnie Hellmann
282−- Xavier Olive
283−- Yan Pashkovsky
284−- Yoan Blanc
285−- Yuchen Pei
286−- Zihang Chen
287−- a-vrma
288−- andrebauer
289−- argent0
290−- badumont
291−- blmage
292−- bucklereed
293−- bumper314
294−- chinapedia
295−- cholonam
296−- csforste
297−- dbecher-ito
298−- d-dorazio
299−- ebiim
300−- favonia
301−- infinity0x
302−- jeongminkim-islab
303−- kaizshang91
304−- lux-lth
305−- lwolfsonkin
306−- mbrackeantidot
307−- nkalvi
308−- niszet
309−- nuew
310−- obcat
311−- oltolm
312−- oquechy
313−- quasicomputational
314−- qerub
315−- robabla
316−- roblabla
317−- rodja.trappe
318−- rski
319−- shreevatsa.public
320−- takahashim
321−- taotieren
322−- tecosaur
323−- TEC
324−- tgkokk
325−- the-solipsist
326−- timo-a
327−- thsutton
328−- vijayphoenix
329−- wiefling
330−- wuffi
CONTRIBUTING.md+88−274
@@ -1,99 +1,29 @@
1Contributing to pandoc
1Contributing to pandoc
2======================
2======================
3
3
4−Welcome to pandoc! Very soon after its beginnings in 2006, pandoc
5−has been influenced, improved, and modified, by users, devs, and
6−newcomers alike. The project thrives on its active community. It is
7−great to have you here.
8−
9−How can I help?
10−---------------
11−
12−There are many ways in which you can support pandoc. Here are a few
13−ideas:
14−
15− * Participate in online discussions. The [pandoc-discuss] mailing
16− list is a good place for this. This gives valuable input and
17− makes it easier to improve the program.
18−
19− * Help with questions. Every request that is answered by the wider
20− community frees time for programming contributors. This will
21− speed up development of new features and issue fixes. Don't
22− underestimate your knowledge, please share it!
23−
24− Good places to help are the [pandoc-discuss] mailing list, Q/A
25− sites like StackOverflow, community forums (e.g.
26− [RStudio][RStudio Community], [Zettlr][Zettlr Forum]), and, for
27− technical questions, the GitHub [issue tracker].
28−
29− * Write or improve documentation. If you ran into a problem which
30− took more time to figure out than expected, please consider to
31− save other users from the same experience. People writing the
32− documentation tend to lack an outside view, so please help
33− provide one. Good documentation is both difficult and extremely
34− important.
35−
36− The official docs are not the only place for documentation.
37− Pandoc also has a [Wiki][pandoc wiki]. Private blogs can serve
38− as documentation just as the official manual can.
39−
40− * Contribute code. No matter whether it's a small fix in a format
41− template or a huge lump of Haskell code: help is welcome. It's
42− usually a good idea to talk about the plans early, as this can
43− prevent unnecessary work. See below for more information.
44−
45− * Last but not least: consider funding the development and
46− maintenance of pandoc financially. You can find sponsor buttons
47− on the [pandoc website] and the [GitHub repository][GitHub
48− repo].
49−
50−A rich ecosystem of libraries, editors, filters, and templates has
51−developed around pandoc; conversely, pandoc builds and depends on a
52−large number of libraries. Contributing to any of these projects is
53−another way that can help to ensure stability, and to keep pushing
54−the boundaries of what is possible with pandoc.
55−
56−[RStudio Community]: https://community.rstudio.com/
57−[Zettlr Forum]: https://forum.zettlr.com/
58−[pandoc wiki]: https://github.com/jgm/pandoc/wiki
59−[pandoc website]: https://pandoc.org
60−[GitHub repo]: https://github.com/jgm/pandoc
61−
62−Have a question?
63−----------------
64−
65−Ask on [pandoc-discuss].
66−
67−
68Found a bug?
4Found a bug?
69------------
5------------
70
6
71−Bug reports are welcome! Please report all bugs on pandoc's GitHub
7+Bug reports are welcome! Please report all bugs on pandoc's github
72[issue tracker].
8[issue tracker].
73
9
74−Before you submit a bug report, search the [open issues] *and* [closed issues]
10+Before you submit a bug report, search the (open *and* closed) issues to make
75−to make sure the issue hasn't come up before. Also, check the [User's Guide] and
11+sure the issue hasn't come up before. Also, check the [User's Guide] and [FAQs]
76−[FAQs] for anything relevant.
12+for anything relevant.
77
13
78−Make sure you can reproduce the bug with the [latest released
14+Make sure you can reproduce the bug with the latest released version of pandoc
79−version] of pandoc---or, even better, the development version,
15+(or, even better, the development version).
80−since the bug may have been fixed since the last release.
81−[Nightly builds] are available, so you don't need to compile
82−from source to test against the development version.
83−(To fetch a nightly, visit the link, click the topmost "Nightly"
84−in the table, then choose your platform under "Artifacts." Note
85−that you must be logged in with a GitHub account.)
86
16
87−Your report should give detailed, *reproducible* instructions, including
17+Your report should give detailed instructions for how to reproduce the problem,
18+including
88
19
89− * the pandoc version (check using `pandoc -v`)
90 * the exact command line used
20 * the exact command line used
91 * the exact input used
21 * the exact input used
92 * the output received
22 * the output received
93 * the output you expected instead
23 * the output you expected instead
94
24
95A small test case (just a few lines) is ideal. If your input is large,
25A small test case (just a few lines) is ideal. If your input is large,
96−try to whittle it down to a *minimum working example*.
26+try to whittle it down to the minimum necessary to illustrate the problem.
97
27
98Out of scope?
28Out of scope?
99-------------
29-------------
@@ -101,74 +31,63 @@ Out of scope?
101A less than perfect conversion does not necessarily mean there's
31A less than perfect conversion does not necessarily mean there's
102a bug in pandoc. Quoting from the MANUAL:
32a bug in pandoc. Quoting from the MANUAL:
103
33
104−> Because pandoc's intermediate representation of a document is less
34+> Because Pandoc's intermediate representation of a document is less
105> expressive than many of the formats it converts between, one should
35> expressive than many of the formats it converts between, one should
106> not expect perfect conversions between every format and every other.
36> not expect perfect conversions between every format and every other.
107> Pandoc attempts to preserve the structural elements of a document, but
37> Pandoc attempts to preserve the structural elements of a document, but
108> not formatting details such as margin size. And some document elements,
38> not formatting details such as margin size. And some document elements,
109−> such as complex tables, may not fit into pandoc's simple document
39+> such as complex tables, may not fit into Pandoc's simple document
110−> model. While conversions from pandoc's Markdown to all formats aspire
40+> model. While conversions from Pandoc's Markdown to all formats aspire
111−> to be perfect, conversions from formats more expressive than pandoc's
41+> to be perfect, conversions from formats more expressive than Pandoc's
112> Markdown can be expected to be lossy.
42> Markdown can be expected to be lossy.
113
43
114−For example, both `docx` and `odt` formats can represent margin size, but
44+For example, both docx and odt can represent margin size, but because
115−because pandoc's internal document model does not contain a representation of
45+pandoc's internal document model does not contain a representation of
116margin size, this information will be lost on converting from docx
46margin size, this information will be lost on converting from docx
117−to `odt`. (You can, however, customize margin size using `--reference-doc`.)
47+to odt. (You can, however, customize margin size using `--reference-odt`.)
118
48
119So before submitting a bug report, consider whether it might be
49So before submitting a bug report, consider whether it might be
120−"out of scope." If it concerns a feature of documents that isn't
50+"out of scope." If it concerns a feature of documents that isn't
121representable in pandoc's Markdown, then it very likely is.
51representable in pandoc's Markdown, then it very likely is.
122−(If in doubt, you can always ask on [pandoc-discuss].)
52+(If in doubt, you can always ask on pandoc-discuss.)
123
53
124Fixing bugs from the issue tracker
54Fixing bugs from the issue tracker
125----------------------------------
55----------------------------------
126
56
127Almost all the bugs on the issue tracker have one or more associated
57Almost all the bugs on the issue tracker have one or more associated
128−tags. These are used to indicate the *complexity* and *nature* of a
58+tags. These are used to indicate the *difficulty* and *nature* of a
129bug. There is not yet a way to indicate priority. An up to date
59bug. There is not yet a way to indicate priority. An up to date
130−summary of issues can be found on [GitHub labels].
60+summary of issues can be found [here](https://github.com/jgm/pandoc/labels).
131
61
132−* [good first issue] — The perfect starting point for new contributors. The
133− issue is generic and can be resolved without deep knowledge of the code
134− base.
135−* [enhancement] — A feature which would be desirable. We recommend
62+* [enhancement] -- A feature which would be desirable. We recommend
136 you discuss any proposed enhancement on pandoc-discuss before
63 you discuss any proposed enhancement on pandoc-discuss before
137 writing code.
64 writing code.
138−* [bug] — A problem which needs to be fixed.
65+* [bug] -- A problem which needs to be fixed.
139−* [complexity:low] — The fix should only be a couple of lines.
66+* [minor] -- The fix should only be a couple of lines.
140−* [complexity:high] — The fix might require structural changes or in depth
67+* [major] -- The fix might require structural changes or in depth knowledge of
141− knowledge of the code base.
68+the code base.
142−* [new:reader] — A request to add a new input format.
69+* [reader] -- A request to add a new input format.
143−* [new:writer] — A request to add a new output format.
70+* [writer] -- A request to add a new output format.
144−* [docs] — A discrepancy, or ambiguity in the documentation.
71+* [docs] -- A discrepency or ambiguity in the documentation.
145−* [status:in-progress] — Someone is actively working on or planning to work on the
72+* [inprogress] -- Someone is actively working on or planning to work on the
146 ticket.
73 ticket.
147−* [status:more-discussion-needed] — It is unclear what the correct approach
74+* [more discussion needed] -- It is unclear what the correct approach
148 to solving the ticket is. Before starting on tickets such as this it
75 to solving the ticket is. Before starting on tickets such as this it
149 would be advisable to post on the ticket.
76 would be advisable to post on the ticket.
150−* [status:more-info-needed] — We require more information from a user before
77+* [more info needed] -- We require more information from a user before
151 we can classify a report properly.
78 we can classify a report properly.
152
79
153−Issues related to a specific format are tagged accordingly, e.g. feature request
154−or bug reports related to Markdown are labelled with [format:markdown].
155−
156Have an idea for a new feature?
80Have an idea for a new feature?
157-------------------------------
81-------------------------------
158
82
159−First, search [pandoc-discuss] and the issue tracker (both [open issues] *and*
83+First, search [pandoc-discuss] and the issue tracker (both open and closed
160−[closed issues]) to make sure that the idea has not been discussed before.
84+issues) to make sure that the idea has not been discussed before.
161
85
162Explain the rationale for the feature you're requesting. Why would this
86Explain the rationale for the feature you're requesting. Why would this
163feature be useful? Consider also any possible drawbacks, including backwards
87feature be useful? Consider also any possible drawbacks, including backwards
164compatibility, new library dependencies, and performance issues.
88compatibility, new library dependencies, and performance issues.
165
89
166−Features are very rarely "implement and forget", as all code must be
167−maintained. This is especially relevant for large or complex
168−contributions. It is helpful to be sympathetic to that fact, and to
169−communicate future plans and availability clearly.
170−
171−Any potential new feature is best discussed on [pandoc-discuss]
90+It is best to discuss a potential new feature on [pandoc-discuss]
172before opening an issue.
91before opening an issue.
173
92
174Patches and pull requests
93Patches and pull requests
@@ -205,7 +124,7 @@ Please follow these guidelines:
205 below under [Tests](#tests).) If you are adding a new writer or reader,
124 below under [Tests](#tests).) If you are adding a new writer or reader,
206 you must include tests.
125 you must include tests.
207
126
208−7. If you are adding a new feature, include updates to `MANUAL.txt`.
127+7. If you are adding a new feature, include updates to the README and MANUAL.
209
128
2108. All code must be released under the general license governing pandoc
1298. All code must be released under the general license governing pandoc
211 (GPL v2).
130 (GPL v2).
@@ -213,9 +132,13 @@ Please follow these guidelines:
2139. It is better not to introduce new dependencies. Dependencies on
1329. It is better not to introduce new dependencies. Dependencies on
214 external C libraries should especially be avoided.
133 external C libraries should especially be avoided.
215
134
216−10. We aim for compatibility with ghc versions from 8.0 to the
135+10. We aim for compatibility with ghc versions from 7.4.2 to the
217 latest release. All pull requests and commits are tested
136 latest release. All pull requests and commits are tested
218− automatically on GitHub Actions.
137+ automatically on travis-ci.org, using GHC versions in the
138+ `Tested-With` stanza of `pandoc.cabal`. We currently relax
139+ the "`-Wall` clean" requirement for GHC 7.10.x, because
140+ there are so many warnings relating to the addition of type
141+ classes to the Prelude.
219
142
220Tests
143Tests
221-----
144-----
@@ -229,81 +152,10 @@ Tests can be run as follows:
229
152
230or, if you're using [stack],
153or, if you're using [stack],
231
154
232− stack setup
155+ stack init
233 stack test
156 stack test
234
157
235−The test program is `test/test-pandoc.hs`.
158+The test program is `tests/test-pandoc.hs`.
236−
237−To run particular tests (pattern-matching on their names), use
238−the `-p` option:
239−
240− cabal install pandoc --enable-tests
241− cabal test --test-options='-p markdown'
242−
243−Or with stack:
244−
245− stack test --test-arguments='-p markdown'
246−
247−It is often helpful to add `-j4` (run tests in parallel) and
248−`--hide-successes` (don't clutter output with successes) to the test
249−arguments as well. Collecting all options in a `cabal.project.local`
250−file in the project's root directory can help to keep `cabal`
251−commands short. E.g.:
252−
253− flags: +embed_data_files
254− tests: True
255− test-show-details: direct
256− test-options: -j4 --hide-successes
257−
258−If you add a new feature to pandoc, please add tests as well, following
259−the pattern of the existing tests. The test suite code is in
260−`test/test-pandoc.hs`. If you are adding a new reader or writer, it is
261−probably easiest to add some data files to the `test` directory, and
262−modify `test/Tests/Old.hs`. Otherwise, it is better to modify the module
263−under the `test/Tests` hierarchy corresponding to the pandoc module you
264−are changing. Alternatively, you may add a "command test" to
265−the `/test/command/` hierarchy, following the pattern of the tests there.
266−These test files should have a meaningful name, which can include the issue
267−number and/or the feature that's being tested. For example, `5474-tables.md`
268−refers to both issue and feature.
269−
270−You can rebuild the golden tests in `tests/` by passing
271−`--accept` to the test script. (If you're using stack, `stack
272−test --test-arguments "--accept"`; or `make TESTARGS=--accept`).
273−Then check the changed golden files for accuracy, and
274−commit the changes. For docx or pptx tests, open the files in Word
275−or Powerpoint to ensure that they weren't corrupted and that
276−they had the expected result, and mention the Word/Powerpoint
277−version and OS in your commit comment.
278−
279−Code style
280−----------
281−
282−Pandoc uses [hlint] to identify opportunities for code improvements
283−like redundant brackets or unnecessary `Language` extensions.
284−However, sometimes there are cases where there are good reasons to
285−use code different from what hlint proposes. In these cases, the
286−respective warning should be disabled in the file `.hlint.yaml`.
287−
288−There should be no errors when running `hlint .`; this is checked by
289−the continuous integration (CI) setup. It is recommended that
290−contributors check their code with a local hlint installation, but
291−relying on the CI is fine, too.
292−
293−A good way to ensure no new warnings are introduced is to use a Git
294−[pre-commit hook] which runs hlint on all updated Haskell files
295−before creating a commit:
296−
297− #!/bin/sh
298− git diff --diff-filter=MA --cached --name-only | grep '\.hs$' | \
299− xargs hlint --hint .hlint.yaml
300−
301−(If you are using GNU `xargs`, add the `-r` option immediately
302−after `xargs`.)
303−
304−Saving this to `.git/hooks/pre-commit`, and making the script
305−executable, will prevent accidental introduction of potentially
306−problematic code.
307
159
308Benchmarks
160Benchmarks
309----------
161----------
@@ -318,75 +170,53 @@ With stack:
318
170
319 stack bench
171 stack bench
320
172
321−
322Using the REPL
173Using the REPL
323--------------
174--------------
324
175
325With a recent version of cabal, you can do `cabal repl` and get
176With a recent version of cabal, you can do `cabal repl` and get
326a ghci REPL for working with pandoc. With [stack], use
177a ghci REPL for working with pandoc. With [stack], use
327−`stack ghci`.
178+`cabal ghci`.
328
179
329We recommend using the following `.ghci` file (which can be
180We recommend using the following `.ghci` file (which can be
330placed in the source directory):
181placed in the source directory):
331
182
183+```
332− :set -fobject-code
184+:set -fobject-code
333− :set -XTypeSynonymInstances
185+:set -XTypeSynonymInstances
334− :set -XScopedTypeVariables
186+:set -XScopedTypeVariables
335− :set -XOverloadedStrings
187+:set -XOverloadedStrings
336−
188+```
337−Profiling
338−---------
339−
340−To diagnose a performance issue with parsing, first try using
341−the `--trace` option. This will give you a record of when block
342−parsers succeed, so you can spot backtracking issues.
343
189
344−To use the GHC profiler with cabal:
190+The code
345−
191+--------
346− cabal clean
347− cabal install --enable-library-profiling --enable-executable-profiling
348− pandoc +RTS -p -RTS [file]...
349− less pandoc.prof
350−
351−With stack:
352−
353− stack clean
354− stack install --profile
355− pandoc +RTS -p -RTS [file]...
356− less pandoc.prof
357
192
358−Templates
193+Pandoc has a publicly accessible git repository on
359−---------
194+github: <http://github.com/jgm/pandoc>. To get a local copy of the source:
360
195
361−The default templates live in `data/templates`, which is a git
362−subtree linked to <https://github.com/jgm/pandoc-templates.git>.
196+ git clone git://github.com/jgm/pandoc.git
363−The purpose of maintaining a separate repository is to allow
364−people to maintain variant templates as a fork.
365
197
366−You can modify the templates and submit patches without worrying
198+Note: after cloning the repository (and in the future after pulling from it),
367−much about this: when these patches are merged, we will
199+you should do
368−push them to the main templates repository by doing
369
200
370− git subtree push --prefix=data/templates templates master
201+ git submodule update --init
371
202
372−where `templates` is a remote pointing to the templates
203+to pull in changes to the templates (`data/templates/`). You can automate this
373−repository.
204+by creating a file `.git/hooks/post-merge` with the contents:
374
205
375−The code
206+ #!/bin/sh
376−--------
207+ git submodule update --init
377
208
378−Pandoc has a publicly accessible git repository on
209+and making it executable:
379−GitHub: <https://github.com/jgm/pandoc>. To get a local copy of the source:
380
210
381− git clone https://github.com/jgm/pandoc.git
211+ chmod +x .git/hooks/post-merge
382
212
383The source for the main pandoc program is `pandoc.hs`. The source for
213The source for the main pandoc program is `pandoc.hs`. The source for
384the pandoc library is in `src/`, the source for the tests is in
214the pandoc library is in `src/`, the source for the tests is in
385−`test/`, and the source for the benchmarks is in `benchmark/`.
215+`tests/`, and the source for the benchmarks is in `benchmark/`.
386
216
387The modules `Text.Pandoc.Definition`, `Text.Pandoc.Builder`, and
217The modules `Text.Pandoc.Definition`, `Text.Pandoc.Builder`, and
388`Text.Pandoc.Generic` are in a separate library `pandoc-types`. The code can
218`Text.Pandoc.Generic` are in a separate library `pandoc-types`. The code can
389−be found in <https://github.com/jgm/pandoc-types>.
219+be found in a <http://github.com/jgm/pandoc-types>.
390
220
391To build pandoc, you will need a working installation of the
221To build pandoc, you will need a working installation of the
392[Haskell platform].
222[Haskell platform].
@@ -399,20 +229,20 @@ The library is structured as follows:
399 - `Text.Pandoc.Definition` (in `pandoc-types`) defines the types
229 - `Text.Pandoc.Definition` (in `pandoc-types`) defines the types
400 used for representing a pandoc document.
230 used for representing a pandoc document.
401 - `Text.Pandoc.Builder` (in `pandoc-types`) provides functions for
231 - `Text.Pandoc.Builder` (in `pandoc-types`) provides functions for
402− building pandoc documents programmatically.
232+ building pandoc documents programatically.
403 - `Text.Pandoc.Generics` (in `pandoc-types`) provides functions allowing
233 - `Text.Pandoc.Generics` (in `pandoc-types`) provides functions allowing
404 you to promote functions that operate on parts of pandoc documents
234 you to promote functions that operate on parts of pandoc documents
405 to functions that operate on whole pandoc documents, walking the
235 to functions that operate on whole pandoc documents, walking the
406 tree automatically.
236 tree automatically.
407 - `Text.Pandoc.Readers.*` are the readers, and `Text.Pandoc.Writers.*`
237 - `Text.Pandoc.Readers.*` are the readers, and `Text.Pandoc.Writers.*`
408 are the writers.
238 are the writers.
409− - `Text.Pandoc.Citeproc.*` contain the code for citation handling,
239+ - `Text.Pandoc.Biblio` is a utility module for formatting citations
410− including an interface to the [citeproc] library.
240+ using citeproc-hs.
411 - `Text.Pandoc.Data` is used to embed data files when the `embed_data_files`
241 - `Text.Pandoc.Data` is used to embed data files when the `embed_data_files`
412− cabal flag is used.
242+ cabal flag is used. It is generated from `src/Text/Pandoc/Data.hsb` using
413− - `Text.Pandoc.Emoji` is a thin wrapper around [emojis].
243+ the preprocessor [hsb2hs].
414 - `Text.Pandoc.Highlighting` contains the interface to the
244 - `Text.Pandoc.Highlighting` contains the interface to the
415− skylighting library, which is used for code syntax highlighting.
245+ highlighting-kate library, which is used for code syntax highlighting.
416 - `Text.Pandoc.ImageSize` is a utility module containing functions for
246 - `Text.Pandoc.ImageSize` is a utility module containing functions for
417 calculating image sizes from the contents of image files.
247 calculating image sizes from the contents of image files.
418 - `Text.Pandoc.MIME` contains functions for associating MIME types
248 - `Text.Pandoc.MIME` contains functions for associating MIME types
@@ -421,10 +251,11 @@ The library is structured as follows:
421 - `Text.Pandoc.PDF` contains functions for producing a PDF from a
251 - `Text.Pandoc.PDF` contains functions for producing a PDF from a
422 LaTeX source.
252 LaTeX source.
423 - `Text.Pandoc.Parsing` contains parsing functions used in multiple readers.
253 - `Text.Pandoc.Parsing` contains parsing functions used in multiple readers.
254+ - `Text.Pandoc.Pretty` is a pretty-printing library specialized to
424 the needs of pandoc.
255 the needs of pandoc.
425 - `Text.Pandoc.SelfContained` contains functions for making an HTML
256 - `Text.Pandoc.SelfContained` contains functions for making an HTML
426 file "self-contained," by importing remotely linked images, CSS,
257 file "self-contained," by importing remotely linked images, CSS,
427− and JavaScript and turning them into `data:` URLs.
258+ and javascript and turning them into `data:` URLs.
428 - `Text.Pandoc.Shared` is a grab-bag of shared utility functions.
259 - `Text.Pandoc.Shared` is a grab-bag of shared utility functions.
429 - `Text.Pandoc.Writers.Shared` contains utilities used in writers only.
260 - `Text.Pandoc.Writers.Shared` contains utilities used in writers only.
430 - `Text.Pandoc.Slides` contains functions for splitting a markdown document
261 - `Text.Pandoc.Slides` contains functions for splitting a markdown document
@@ -437,39 +268,22 @@ The library is structured as follows:
437 - `Text.Pandoc.UUID` contains functions for generating UUIDs.
268 - `Text.Pandoc.UUID` contains functions for generating UUIDs.
438 - `Text.Pandoc.XML` contains functions for formatting XML.
269 - `Text.Pandoc.XML` contains functions for formatting XML.
439
270
440−Lua filters
441−-----------
442−
443−If you've written a useful pandoc [lua filter](lua-filters.html),
444−you may want to consider submitting a pull request to the
445−[lua-filters repository](https://github.com/pandoc/lua-filters).
446−
447−[open issues]: https://github.com/jgm/pandoc/issues
448−[closed issues]: https://github.com/jgm/pandoc/issues?q=is%3Aissue+is%3Aclosed
449−[latest released version]: https://github.com/jgm/pandoc/releases/latest
450−[Nightly builds]: https://github.com/jgm/pandoc/actions?query=workflow%3ANightly
451−[pandoc-discuss]: https://groups.google.com/group/pandoc-discuss
271+[pandoc-discuss]: http://groups.google.com/group/pandoc-discuss
452[issue tracker]: https://github.com/jgm/pandoc/issues
272[issue tracker]: https://github.com/jgm/pandoc/issues
453−[User's Guide]: https://pandoc.org/MANUAL.html
273+[User's Guide]: http://pandoc.org/MANUAL.html
454−[FAQs]: https://pandoc.org/faqs.html
274+[FAQs]: http://pandoc.org/faqs.html
455−[EditorConfig]: https://editorconfig.org/
275+[EditorConfig]: http://editorconfig.org/
456−[Haskell platform]: https://www.haskell.org/platform/
276+[Haskell platform]: http://www.haskell.org/platform/
457−[hlint]: https://hackage.haskell.org/package/hlint
458−[citeproc]: https://hackage.haskell.org/package/citeproc
459−[emojis]: https://hackage.haskell.org/package/emojis
460−[hsb2hs]: https://hackage.haskell.org/package/hsb2hs
277+[hsb2hs]: http://hackage.haskell.org/package/hsb2hs
461−[pre-commit hook]: https://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks
462−[GitHub labels]: https://github.com/jgm/pandoc/labels
463−[good first issue]:https://github.com/jgm/pandoc/labels/good%20first%20issue
464[enhancement]: https://github.com/jgm/pandoc/labels/enhancement
278[enhancement]: https://github.com/jgm/pandoc/labels/enhancement
465[bug]: https://github.com/jgm/pandoc/labels/bug
279[bug]: https://github.com/jgm/pandoc/labels/bug
280+[minor]: https://github.com/jgm/pandoc/labels/Minor
466−[complexity:low]: https://github.com/jgm/pandoc/labels/complexity:low
281+[major]: https://github.com/jgm/pandoc/labels/Major
282+[reader]: https://github.com/jgm/pandoc/labels/Reader
467−[complexity:high]: https://github.com/jgm/pandoc/labels/complexity:high
283+[writer]: https://github.com/jgm/pandoc/labels/Writer
468[docs]: https://github.com/jgm/pandoc/labels/docs
284[docs]: https://github.com/jgm/pandoc/labels/docs
469−[format:markdown]: https://github.com/jgm/pandoc/labels/format:markdown
470−[new:reader]: https://github.com/jgm/pandoc/labels/new:reader
471−[new:writer]: https://github.com/jgm/pandoc/labels/new:writer
472−[status:in-progress]: https://github.com/jgm/pandoc/labels/status:in-progress
285+[inprogress]: https://github.com/jgm/pandoc/labels/inprogress
473−[status:more-discussion-needed]: https://github.com/jgm/pandoc/labels/status:more-discussion-needed
286+[more discussion needed]: https://github.com/jgm/pandoc/labels/More%20discussion%20needed
474−[status:more-info-needed]: https://github.com/jgm/pandoc/labels/status:more-info-needed
287+[more info needed]: https://github.com/jgm/pandoc/labels/More%20info%20needed
475[stack]: https://github.com/commercialhaskell/stack
288[stack]: https://github.com/commercialhaskell/stack
289+
COPYINGnew file+346
@@ -0,0 +1,346 @@
1+GNU GENERAL PUBLIC LICENSE
2+==========================
3+
4+Version 2, June 1991
5+
6+Copyright (C) 1989, 1991 Free Software Foundation, Inc.
7+51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
8+
9+Everyone is permitted to copy and distribute verbatim copies
10+of this license document, but changing it is not allowed.
11+
12+Preamble
13+--------
14+
15+The licenses for most software are designed to take away your
16+freedom to share and change it. By contrast, the GNU General Public
17+License is intended to guarantee your freedom to share and change free
18+software--to make sure the software is free for all its users. This
19+General Public License applies to most of the Free Software
20+Foundation's software and to any other program whose authors commit to
21+using it. (Some other Free Software Foundation software is covered by
22+the GNU Library General Public License instead.) You can apply it to
23+your programs, too.
24+
25+When we speak of free software, we are referring to freedom, not
26+price. Our General Public Licenses are designed to make sure that you
27+have the freedom to distribute copies of free software (and charge for
28+this service if you wish), that you receive source code or can get it
29+if you want it, that you can change the software or use pieces of it
30+in new free programs; and that you know you can do these things.
31+
32+To protect your rights, we need to make restrictions that forbid
33+anyone to deny you these rights or to ask you to surrender the rights.
34+These restrictions translate to certain responsibilities for you if you
35+distribute copies of the software, or if you modify it.
36+
37+For example, if you distribute copies of such a program, whether
38+gratis or for a fee, you must give the recipients all the rights that
39+you have. You must make sure that they, too, receive or can get the
40+source code. And you must show them these terms so they know their
41+rights.
42+
43+We protect your rights with two steps: (1) copyright the software, and
44+(2) offer you this license which gives you legal permission to copy,
45+distribute and/or modify the software.
46+
47+Also, for each author's protection and ours, we want to make certain
48+that everyone understands that there is no warranty for this free
49+software. If the software is modified by someone else and passed on, we
50+want its recipients to know that what they have is not the original, so
51+that any problems introduced by others will not reflect on the original
52+authors' reputations.
53+
54+Finally, any free program is threatened constantly by software
55+patents. We wish to avoid the danger that redistributors of a free
56+program will individually obtain patent licenses, in effect making the
57+program proprietary. To prevent this, we have made it clear that any
58+patent must be licensed for everyone's free use or not licensed at all.
59+
60+The precise terms and conditions for copying, distribution and
61+modification follow.
62+
63+GNU GENERAL PUBLIC LICENSE
64+--------------------------
65+
66+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
67+
68+0. This License applies to any program or other work which contains
69+ a notice placed by the copyright holder saying it may be distributed
70+ under the terms of this General Public License. The "Program", below,
71+ refers to any such program or work, and a "work based on the Program"
72+ means either the Program or any derivative work under copyright law:
73+ that is to say, a work containing the Program or a portion of it,
74+ either verbatim or with modifications and/or translated into another
75+ language. (Hereinafter, translation is included without limitation in
76+ the term "modification".) Each licensee is addressed as "you".
77+
78+ Activities other than copying, distribution and modification are not
79+ covered by this License; they are outside its scope. The act of
80+ running the Program is not restricted, and the output from the Program
81+ is covered only if its contents constitute a work based on the
82+ Program (independent of having been made by running the Program).
83+ Whether that is true depends on what the Program does.
84+
85+1. You may copy and distribute verbatim copies of the Program's
86+ source code as you receive it, in any medium, provided that you
87+ conspicuously and appropriately publish on each copy an appropriate
88+ copyright notice and disclaimer of warranty; keep intact all the
89+ notices that refer to this License and to the absence of any warranty;
90+ and give any other recipients of the Program a copy of this License
91+ along with the Program.
92+
93+ You may charge a fee for the physical act of transferring a copy, and
94+ you may at your option offer warranty protection in exchange for a fee.
95+
96+2. You may modify your copy or copies of the Program or any portion
97+ of it, thus forming a work based on the Program, and copy and
98+ distribute such modifications or work under the terms of Section 1
99+ above, provided that you also meet all of these conditions:
100+
101+ a) You must cause the modified files to carry prominent notices
102+ stating that you changed the files and the date of any change.
103+
104+ b) You must cause any work that you distribute or publish, that in
105+ whole or in part contains or is derived from the Program or any
106+ part thereof, to be licensed as a whole at no charge to all third
107+ parties under the terms of this License.
108+
109+ c) If the modified program normally reads commands interactively
110+ when run, you must cause it, when started running for such
111+ interactive use in the most ordinary way, to print or display an
112+ announcement including an appropriate copyright notice and a
113+ notice that there is no warranty (or else, saying that you provide
114+ a warranty) and that users may redistribute the program under
115+ these conditions, and telling the user how to view a copy of this
116+ License. (Exception: if the Program itself is interactive but
117+ does not normally print such an announcement, your work based on
118+ the Program is not required to print an announcement.)
119+
120+ These requirements apply to the modified work as a whole. If
121+ identifiable sections of that work are not derived from the Program,
122+ and can be reasonably considered independent and separate works in
123+ themselves, then this License, and its terms, do not apply to those
124+ sections when you distribute them as separate works. But when you
125+ distribute the same sections as part of a whole which is a work based
126+ on the Program, the distribution of the whole must be on the terms of
127+ this License, whose permissions for other licensees extend to the
128+ entire whole, and thus to each and every part regardless of who wrote it.
129+
130+ Thus, it is not the intent of this section to claim rights or contest
131+ your rights to work written entirely by you; rather, the intent is to
132+ exercise the right to control the distribution of derivative or
133+ collective works based on the Program.
134+
135+ In addition, mere aggregation of another work not based on the Program
136+ with the Program (or with a work based on the Program) on a volume of
137+ a storage or distribution medium does not bring the other work under
138+ the scope of this License.
139+
140+3. You may copy and distribute the Program (or a work based on it,
141+ under Section 2) in object code or executable form under the terms of
142+ Sections 1 and 2 above provided that you also do one of the following:
143+
144+ a) Accompany it with the complete corresponding machine-readable
145+ source code, which must be distributed under the terms of Sections
146+ 1 and 2 above on a medium customarily used for software interchange; or,
147+
148+ b) Accompany it with a written offer, valid for at least three
149+ years, to give any third party, for a charge no more than your
150+ cost of physically performing source distribution, a complete
151+ machine-readable copy of the corresponding source code, to be
152+ distributed under the terms of Sections 1 and 2 above on a medium
153+ customarily used for software interchange; or,
154+
155+ c) Accompany it with the information you received as to the offer
156+ to distribute corresponding source code. (This alternative is
157+ allowed only for noncommercial distribution and only if you
158+ received the program in object code or executable form with such
159+ an offer, in accord with Subsection b above.)
160+
161+ The source code for a work means the preferred form of the work for
162+ making modifications to it. For an executable work, complete source
163+ code means all the source code for all modules it contains, plus any
164+ associated interface definition files, plus the scripts used to
165+ control compilation and installation of the executable. However, as a
166+ special exception, the source code distributed need not include
167+ anything that is normally distributed (in either source or binary
168+ form) with the major components (compiler, kernel, and so on) of the
169+ operating system on which the executable runs, unless that component
170+ itself accompanies the executable.
171+
172+ If distribution of executable or object code is made by offering
173+ access to copy from a designated place, then offering equivalent
174+ access to copy the source code from the same place counts as
175+ distribution of the source code, even though third parties are not
176+ compelled to copy the source along with the object code.
177+
178+4. You may not copy, modify, sublicense, or distribute the Program
179+ except as expressly provided under this License. Any attempt
180+ otherwise to copy, modify, sublicense or distribute the Program is
181+ void, and will automatically terminate your rights under this License.
182+ However, parties who have received copies, or rights, from you under
183+ this License will not have their licenses terminated so long as such
184+ parties remain in full compliance.
185+
186+5. You are not required to accept this License, since you have not
187+ signed it. However, nothing else grants you permission to modify or
188+ distribute the Program or its derivative works. These actions are
189+ prohibited by law if you do not accept this License. Therefore, by
190+ modifying or distributing the Program (or any work based on the
191+ Program), you indicate your acceptance of this License to do so, and
192+ all its terms and conditions for copying, distributing or modifying
193+ the Program or works based on it.
194+
195+6. Each time you redistribute the Program (or any work based on the
196+ Program), the recipient automatically receives a license from the
197+ original licensor to copy, distribute or modify the Program subject to
198+ these terms and conditions. You may not impose any further
199+ restrictions on the recipients' exercise of the rights granted herein.
200+ You are not responsible for enforcing compliance by third parties to
201+ this License.
202+
203+7. If, as a consequence of a court judgment or allegation of patent
204+ infringement or for any other reason (not limited to patent issues),
205+ conditions are imposed on you (whether by court order, agreement or
206+ otherwise) that contradict the conditions of this License, they do not
207+ excuse you from the conditions of this License. If you cannot
208+ distribute so as to satisfy simultaneously your obligations under this
209+ License and any other pertinent obligations, then as a consequence you
210+ may not distribute the Program at all. For example, if a patent
211+ license would not permit royalty-free redistribution of the Program by
212+ all those who receive copies directly or indirectly through you, then
213+ the only way you could satisfy both it and this License would be to
214+ refrain entirely from distribution of the Program.
215+
216+ If any portion of this section is held invalid or unenforceable under
217+ any particular circumstance, the balance of the section is intended to
218+ apply and the section as a whole is intended to apply in other
219+ circumstances.
220+
221+ It is not the purpose of this section to induce you to infringe any
222+ patents or other property right claims or to contest validity of any
223+ such claims; this section has the sole purpose of protecting the
224+ integrity of the free software distribution system, which is
225+ implemented by public license practices. Many people have made
226+ generous contributions to the wide range of software distributed
227+ through that system in reliance on consistent application of that
228+ system; it is up to the author/donor to decide if he or she is willing
229+ to distribute software through any other system and a licensee cannot
230+ impose that choice.
231+
232+ This section is intended to make thoroughly clear what is believed to
233+ be a consequence of the rest of this License.
234+
235+8. If the distribution and/or use of the Program is restricted in
236+ certain countries either by patents or by copyrighted interfaces, the
237+ original copyright holder who places the Program under this License
238+ may add an explicit geographical distribution limitation excluding
239+ those countries, so that distribution is permitted only in or among
240+ countries not thus excluded. In such case, this License incorporates
241+ the limitation as if written in the body of this License.
242+
243+9. The Free Software Foundation may publish revised and/or new versions
244+ of the General Public License from time to time. Such new versions will
245+ be similar in spirit to the present version, but may differ in detail to
246+ address new problems or concerns.
247+
248+ Each version is given a distinguishing version number. If the Program
249+ specifies a version number of this License which applies to it and "any
250+ later version", you have the option of following the terms and conditions
251+ either of that version or of any later version published by the Free
252+ Software Foundation. If the Program does not specify a version number of
253+ this License, you may choose any version ever published by the Free Software
254+ Foundation.
255+
256+10. If you wish to incorporate parts of the Program into other free
257+ programs whose distribution conditions are different, write to the author
258+ to ask for permission. For software which is copyrighted by the Free
259+ Software Foundation, write to the Free Software Foundation; we sometimes
260+ make exceptions for this. Our decision will be guided by the two goals
261+ of preserving the free status of all derivatives of our free software and
262+ of promoting the sharing and reuse of software generally.
263+
264+NO WARRANTY
265+
266+11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
267+ FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
268+ OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
269+ PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
270+ OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
271+ MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
272+ TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
273+ PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
274+ REPAIR OR CORRECTION.
275+
276+12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
277+ WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
278+ REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
279+ INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
280+ OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
281+ TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
282+ YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
283+ PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
284+ POSSIBILITY OF SUCH DAMAGES.
285+
286+END OF TERMS AND CONDITIONS
287+
288+How to Apply These Terms to Your New Programs
289+---------------------------------------------
290+
291+If you develop a new program, and you want it to be of the greatest
292+possible use to the public, the best way to achieve this is to make it
293+free software which everyone can redistribute and change under these terms.
294+
295+To do so, attach the following notices to the program. It is safest
296+to attach them to the start of each source file to most effectively
297+convey the exclusion of warranty; and each file should have at least
298+the "copyright" line and a pointer to where the full notice is found.
299+
300+ <one line to give the program's name and a brief idea of what it does.>
301+ Copyright (C) <year> <name of author>
302+
303+ This program is free software; you can redistribute it and/or modify
304+ it under the terms of the GNU General Public License as published by
305+ the Free Software Foundation; either version 2 of the License, or
306+ (at your option) any later version.
307+
308+ This program is distributed in the hope that it will be useful,
309+ but WITHOUT ANY WARRANTY; without even the implied warranty of
310+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
311+ GNU General Public License for more details.
312+
313+ You should have received a copy of the GNU General Public License
314+ along with this program; if not, write to the Free Software
315+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
316+
317+Also add information on how to contact you by electronic and paper mail.
318+
319+If the program is interactive, make it output a short notice like this
320+when it starts in an interactive mode:
321+
322+ Gnomovision version 69, Copyright (C) year name of author
323+ Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
324+ This is free software, and you are welcome to redistribute it
325+ under certain conditions; type `show c' for details.
326+
327+The hypothetical commands `show w' and `show c' should show the appropriate
328+parts of the General Public License. Of course, the commands you use may
329+be called something other than `show w' and `show c'; they could even be
330+mouse-clicks or menu items--whatever suits your program.
331+
332+You should also get your employer (if you work as a programmer) or your
333+school, if any, to sign a "copyright disclaimer" for the program, if
334+necessary. Here is a sample; alter the names:
335+
336+ Yoyodyne, Inc., hereby disclaims all copyright interest in the program
337+ `Gnomovision' (which makes passes at compilers) written by James Hacker.
338+
339+ <signature of Ty Coon>, 1 April 1989
340+ Ty Coon, President of Vice
341+
342+This General Public License does not permit incorporating your program into
343+proprietary programs. If your program is a subroutine library, you may
344+consider it more useful to permit linking proprietary applications with the
345+library. If this is what you want to do, use the GNU Library General
346+Public License instead of this License.
COPYING.mddeleted−361
@@ -1,361 +0,0 @@
1−### GNU GENERAL PUBLIC LICENSE
2−
3−Version 2, June 1991
4−
5− Copyright (C) 1989, 1991 Free Software Foundation, Inc.
6− 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
7−
8− Everyone is permitted to copy and distribute verbatim copies
9− of this license document, but changing it is not allowed.
10−
11−### Preamble
12−
13−The licenses for most software are designed to take away your freedom
14−to share and change it. By contrast, the GNU General Public License is
15−intended to guarantee your freedom to share and change free
16−software--to make sure the software is free for all its users. This
17−General Public License applies to most of the Free Software
18−Foundation's software and to any other program whose authors commit to
19−using it. (Some other Free Software Foundation software is covered by
20−the GNU Lesser General Public License instead.) You can apply it to
21−your programs, too.
22−
23−When we speak of free software, we are referring to freedom, not
24−price. Our General Public Licenses are designed to make sure that you
25−have the freedom to distribute copies of free software (and charge for
26−this service if you wish), that you receive source code or can get it
27−if you want it, that you can change the software or use pieces of it
28−in new free programs; and that you know you can do these things.
29−
30−To protect your rights, we need to make restrictions that forbid
31−anyone to deny you these rights or to ask you to surrender the rights.
32−These restrictions translate to certain responsibilities for you if
33−you distribute copies of the software, or if you modify it.
34−
35−For example, if you distribute copies of such a program, whether
36−gratis or for a fee, you must give the recipients all the rights that
37−you have. You must make sure that they, too, receive or can get the
38−source code. And you must show them these terms so they know their
39−rights.
40−
41−We protect your rights with two steps: (1) copyright the software, and
42−(2) offer you this license which gives you legal permission to copy,
43−distribute and/or modify the software.
44−
45−Also, for each author's protection and ours, we want to make certain
46−that everyone understands that there is no warranty for this free
47−software. If the software is modified by someone else and passed on,
48−we want its recipients to know that what they have is not the
49−original, so that any problems introduced by others will not reflect
50−on the original authors' reputations.
51−
52−Finally, any free program is threatened constantly by software
53−patents. We wish to avoid the danger that redistributors of a free
54−program will individually obtain patent licenses, in effect making the
55−program proprietary. To prevent this, we have made it clear that any
56−patent must be licensed for everyone's free use or not licensed at
57−all.
58−
59−The precise terms and conditions for copying, distribution and
60−modification follow.
61−
62−### TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
63−
64−**0.** This License applies to any program or other work which
65−contains a notice placed by the copyright holder saying it may be
66−distributed under the terms of this General Public License. The
67−"Program", below, refers to any such program or work, and a "work
68−based on the Program" means either the Program or any derivative work
69−under copyright law: that is to say, a work containing the Program or
70−a portion of it, either verbatim or with modifications and/or
71−translated into another language. (Hereinafter, translation is
72−included without limitation in the term "modification".) Each licensee
73−is addressed as "you".
74−
75−Activities other than copying, distribution and modification are not
76−covered by this License; they are outside its scope. The act of
77−running the Program is not restricted, and the output from the Program
78−is covered only if its contents constitute a work based on the Program
79−(independent of having been made by running the Program). Whether that
80−is true depends on what the Program does.
81−
82−**1.** You may copy and distribute verbatim copies of the Program's
83−source code as you receive it, in any medium, provided that you
84−conspicuously and appropriately publish on each copy an appropriate
85−copyright notice and disclaimer of warranty; keep intact all the
86−notices that refer to this License and to the absence of any warranty;
87−and give any other recipients of the Program a copy of this License
88−along with the Program.
89−
90−You may charge a fee for the physical act of transferring a copy, and
91−you may at your option offer warranty protection in exchange for a
92−fee.
93−
94−**2.** You may modify your copy or copies of the Program or any
95−portion of it, thus forming a work based on the Program, and copy and
96−distribute such modifications or work under the terms of Section 1
97−above, provided that you also meet all of these conditions:
98−
99−
100−**a)** You must cause the modified files to carry prominent notices
101−stating that you changed the files and the date of any change.
102−
103−
104−**b)** You must cause any work that you distribute or publish, that in
105−whole or in part contains or is derived from the Program or any part
106−thereof, to be licensed as a whole at no charge to all third parties
107−under the terms of this License.
108−
109−
110−**c)** If the modified program normally reads commands interactively
111−when run, you must cause it, when started running for such interactive
112−use in the most ordinary way, to print or display an announcement
113−including an appropriate copyright notice and a notice that there is
114−no warranty (or else, saying that you provide a warranty) and that
115−users may redistribute the program under these conditions, and telling
116−the user how to view a copy of this License. (Exception: if the
117−Program itself is interactive but does not normally print such an
118−announcement, your work based on the Program is not required to print
119−an announcement.)
120−
121−These requirements apply to the modified work as a whole. If
122−identifiable sections of that work are not derived from the Program,
123−and can be reasonably considered independent and separate works in
124−themselves, then this License, and its terms, do not apply to those
125−sections when you distribute them as separate works. But when you
126−distribute the same sections as part of a whole which is a work based
127−on the Program, the distribution of the whole must be on the terms of
128−this License, whose permissions for other licensees extend to the
129−entire whole, and thus to each and every part regardless of who wrote
130−it.
131−
132−Thus, it is not the intent of this section to claim rights or contest
133−your rights to work written entirely by you; rather, the intent is to
134−exercise the right to control the distribution of derivative or
135−collective works based on the Program.
136−
137−In addition, mere aggregation of another work not based on the Program
138−with the Program (or with a work based on the Program) on a volume of
139−a storage or distribution medium does not bring the other work under
140−the scope of this License.
141−
142−**3.** You may copy and distribute the Program (or a work based on it,
143−under Section 2) in object code or executable form under the terms of
144−Sections 1 and 2 above provided that you also do one of the following:
145−
146−
147−**a)** Accompany it with the complete corresponding machine-readable
148−source code, which must be distributed under the terms of Sections 1
149−and 2 above on a medium customarily used for software interchange; or,
150−
151−
152−**b)** Accompany it with a written offer, valid for at least three
153−years, to give any third party, for a charge no more than your cost of
154−physically performing source distribution, a complete machine-readable
155−copy of the corresponding source code, to be distributed under the
156−terms of Sections 1 and 2 above on a medium customarily used for
157−software interchange; or,
158−
159−
160−**c)** Accompany it with the information you received as to the offer
161−to distribute corresponding source code. (This alternative is allowed
162−only for noncommercial distribution and only if you received the
163−program in object code or executable form with such an offer, in
164−accord with Subsection b above.)
165−
166−The source code for a work means the preferred form of the work for
167−making modifications to it. For an executable work, complete source
168−code means all the source code for all modules it contains, plus any
169−associated interface definition files, plus the scripts used to
170−control compilation and installation of the executable. However, as a
171−special exception, the source code distributed need not include
172−anything that is normally distributed (in either source or binary
173−form) with the major components (compiler, kernel, and so on) of the
174−operating system on which the executable runs, unless that component
175−itself accompanies the executable.
176−
177−If distribution of executable or object code is made by offering
178−access to copy from a designated place, then offering equivalent
179−access to copy the source code from the same place counts as
180−distribution of the source code, even though third parties are not
181−compelled to copy the source along with the object code.
182−
183−**4.** You may not copy, modify, sublicense, or distribute the Program
184−except as expressly provided under this License. Any attempt otherwise
185−to copy, modify, sublicense or distribute the Program is void, and
186−will automatically terminate your rights under this License. However,
187−parties who have received copies, or rights, from you under this
188−License will not have their licenses terminated so long as such
189−parties remain in full compliance.
190−
191−**5.** You are not required to accept this License, since you have not
192−signed it. However, nothing else grants you permission to modify or
193−distribute the Program or its derivative works. These actions are
194−prohibited by law if you do not accept this License. Therefore, by
195−modifying or distributing the Program (or any work based on the
196−Program), you indicate your acceptance of this License to do so, and
197−all its terms and conditions for copying, distributing or modifying
198−the Program or works based on it.
199−
200−**6.** Each time you redistribute the Program (or any work based on
201−the Program), the recipient automatically receives a license from the
202−original licensor to copy, distribute or modify the Program subject to
203−these terms and conditions. You may not impose any further
204−restrictions on the recipients' exercise of the rights granted herein.
205−You are not responsible for enforcing compliance by third parties to
206−this License.
207−
208−**7.** If, as a consequence of a court judgment or allegation of
209−patent infringement or for any other reason (not limited to patent
210−issues), conditions are imposed on you (whether by court order,
211−agreement or otherwise) that contradict the conditions of this
212−License, they do not excuse you from the conditions of this License.
213−If you cannot distribute so as to satisfy simultaneously your
214−obligations under this License and any other pertinent obligations,
215−then as a consequence you may not distribute the Program at all. For
216−example, if a patent license would not permit royalty-free
217−redistribution of the Program by all those who receive copies directly
218−or indirectly through you, then the only way you could satisfy both it
219−and this License would be to refrain entirely from distribution of the
220−Program.
221−
222−If any portion of this section is held invalid or unenforceable under
223−any particular circumstance, the balance of the section is intended to
224−apply and the section as a whole is intended to apply in other
225−circumstances.
226−
227−It is not the purpose of this section to induce you to infringe any
228−patents or other property right claims or to contest validity of any
229−such claims; this section has the sole purpose of protecting the
230−integrity of the free software distribution system, which is
231−implemented by public license practices. Many people have made
232−generous contributions to the wide range of software distributed
233−through that system in reliance on consistent application of that
234−system; it is up to the author/donor to decide if he or she is willing
235−to distribute software through any other system and a licensee cannot
236−impose that choice.
237−
238−This section is intended to make thoroughly clear what is believed to
239−be a consequence of the rest of this License.
240−
241−**8.** If the distribution and/or use of the Program is restricted in
242−certain countries either by patents or by copyrighted interfaces, the
243−original copyright holder who places the Program under this License
244−may add an explicit geographical distribution limitation excluding
245−those countries, so that distribution is permitted only in or among
246−countries not thus excluded. In such case, this License incorporates
247−the limitation as if written in the body of this License.
248−
249−**9.** The Free Software Foundation may publish revised and/or new
250−versions of the General Public License from time to time. Such new
251−versions will be similar in spirit to the present version, but may
252−differ in detail to address new problems or concerns.
253−
254−Each version is given a distinguishing version number. If the Program
255−specifies a version number of this License which applies to it and
256−"any later version", you have the option of following the terms and
257−conditions either of that version or of any later version published by
258−the Free Software Foundation. If the Program does not specify a
259−version number of this License, you may choose any version ever
260−published by the Free Software Foundation.
261−
262−**10.** If you wish to incorporate parts of the Program into other
263−free programs whose distribution conditions are different, write to
264−the author to ask for permission. For software which is copyrighted by
265−the Free Software Foundation, write to the Free Software Foundation;
266−we sometimes make exceptions for this. Our decision will be guided by
267−the two goals of preserving the free status of all derivatives of our
268−free software and of promoting the sharing and reuse of software
269−generally.
270−
271−**NO WARRANTY**
272−
273−**11.** BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO
274−WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
275−EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
276−OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY
277−KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
278−IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
279−PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
280−PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME
281−THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
282−
283−**12.** IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
284−WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
285−AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU
286−FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
287−CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
288−PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
289−RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
290−FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF
291−SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
292−DAMAGES.
293−
294−### END OF TERMS AND CONDITIONS
295−
296−### How to Apply These Terms to Your New Programs
297−
298−If you develop a new program, and you want it to be of the greatest
299−possible use to the public, the best way to achieve this is to make it
300−free software which everyone can redistribute and change under these
301−terms.
302−
303−To do so, attach the following notices to the program. It is safest to
304−attach them to the start of each source file to most effectively
305−convey the exclusion of warranty; and each file should have at least
306−the "copyright" line and a pointer to where the full notice is found.
307−
308− one line to give the program's name and an idea of what it does.
309− Copyright (C) yyyy name of author
310−
311− This program is free software; you can redistribute it and/or
312− modify it under the terms of the GNU General Public License
313− as published by the Free Software Foundation; either version 2
314− of the License, or (at your option) any later version.
315−
316− This program is distributed in the hope that it will be useful,
317− but WITHOUT ANY WARRANTY; without even the implied warranty of
318− MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
319− GNU General Public License for more details.
320−
321− You should have received a copy of the GNU General Public License
322− along with this program; if not, write to the Free Software
323− Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
324−
325−Also add information on how to contact you by electronic and paper
326−mail.
327−
328−If the program is interactive, make it output a short notice like this
329−when it starts in an interactive mode:
330−
331− Gnomovision version 69, Copyright (C) year name of author
332− Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
333− type `show w'. This is free software, and you are welcome
334− to redistribute it under certain conditions; type `show c'
335− for details.
336−
337−The hypothetical commands \`show w' and \`show c' should show the
338−appropriate parts of the General Public License. Of course, the
339−commands you use may be called something other than \`show w' and
340−\`show c'; they could even be mouse-clicks or menu items--whatever
341−suits your program.
342−
343−You should also get your employer (if you work as a programmer) or
344−your school, if any, to sign a "copyright disclaimer" for the program,
345−if necessary. Here is a sample; alter the names:
346−
347− Yoyodyne, Inc., hereby disclaims all copyright
348− interest in the program `Gnomovision'
349− (which makes passes at compilers) written
350− by James Hacker.
351−
352− signature of Ty Coon, 1 April 1989
353− Ty Coon, President of Vice
354−
355−This General Public License does not permit incorporating your program
356−into proprietary programs. If your program is a subroutine library,
357−you may consider it more useful to permit linking proprietary
358−applications with the library. If this is what you want to do, use the
359−[GNU Lesser General Public
360−License](https://www.gnu.org/licenses/lgpl.html) instead of this
361−License.
COPYRIGHT+25−122
@@ -1,8 +1,7 @@
1Pandoc
1Pandoc
2−Copyright (C) 2006-2021 John MacFarlane <jgm at berkeley dot edu>
2+Copyright (C) 2006-2016 John MacFarlane <jgm at berkeley dot edu>
3
3
4−With the exceptions noted below, this code is released under the [GPL],
4+This code is released under the [GPL], version 2 or later:
5−version 2 or later:
6
5
7 This program is free software; you can redistribute it and/or modify
6 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
7 it under the terms of the GNU General Public License as published by
@@ -18,172 +17,76 @@ version 2 or later:
18 along with this program; if not, write to the Free Software
17 along with this program; if not, write to the Free Software
19 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
18 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
20
19
21−The GNU General Public License is available in the file COPYING.md in
20+The GNU General Public License is available in the file COPYING in
22the source distribution. On Debian systems, the complete text of the
21the source distribution. On Debian systems, the complete text of the
23GPL can be found in `/usr/share/common-licenses/GPL`.
22GPL can be found in `/usr/share/common-licenses/GPL`.
24
23
25−[GPL]: https://www.gnu.org/copyleft/gpl.html
24+[GPL]: http://www.gnu.org/copyleft/gpl.html
26
25
27Pandoc's complete source code is available from the [Pandoc home page].
26Pandoc's complete source code is available from the [Pandoc home page].
28
27
29−[Pandoc home page]: https://pandoc.org
28+[Pandoc home page]: http://pandoc.org
30
29
31−Pandoc includes some code with different copyrights, or subject to different
30+Pandoc includes some code from other authors. The copyright and license
32−licenses. The copyright and license statements for these sources are included
31+statements for these sources are included below. All are GPL-compatible
33−below. All are GPL-compatible licenses.
32+licenses.
34−
35−----------------------------------------------------------------------
36−The modules in the `pandoc-types` repository (Text.Pandoc.Definition,
37−Text.Pandoc.Builder, Text.Pandoc.Generics, Text.Pandoc.JSON,
38−Text.Pandoc.Walk) are licensed under the BSD 3-clause license:
39−
40−Copyright (c) 2006-2021, John MacFarlane
41−
42−All rights reserved.
43−
44−Redistribution and use in source and binary forms, with or without
45−modification, are permitted provided that the following conditions are met:
46−
47− * Redistributions of source code must retain the above copyright
48− notice, this list of conditions and the following disclaimer.
49−
50− * Redistributions in binary form must reproduce the above
51− copyright notice, this list of conditions and the following
52− disclaimer in the documentation and/or other materials provided
53− with the distribution.
54−
55− * Neither the name of John MacFarlane nor the names of other
56− contributors may be used to endorse or promote products derived
57− from this software without specific prior written permission.
58−
59−THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
60−"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
61−LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
62−A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
63−OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
64−SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
65−LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
66−DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
67−THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
68−(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
69−OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
70−
71−----------------------------------------------------------------------
72−Pandoc's templates (in `data/templates`) are dual-licensed as either
73−GPL (v2 or higher, same as pandoc) or (at your option) the BSD
74−3-clause license.
75−
76−Copyright (c) 2014--2021, John MacFarlane
77−
78−----------------------------------------------------------------------
79−src/Text/Pandoc/Writers/Muse.hs
80−Copyright (C) 2017-2020 Alexander Krotov
81−
82−Released under the GNU General Public License version 2 or later.
83
33
84----------------------------------------------------------------------
34----------------------------------------------------------------------
85src/Text/Pandoc/Writers/Texinfo.hs
35src/Text/Pandoc/Writers/Texinfo.hs
86−Copyright (C) 2008-2021 John MacFarlane and Peter Wang
36+Copyright (C) 2008-2015 John MacFarlane and Peter Wang
87
37
88Released under the GNU General Public License version 2 or later.
38Released under the GNU General Public License version 2 or later.
89
39
90----------------------------------------------------------------------
40----------------------------------------------------------------------
91src/Text/Pandoc/Writers/OpenDocument.hs
41src/Text/Pandoc/Writers/OpenDocument.hs
92−Copyright (C) 2008-2021 Andrea Rossato and John MacFarlane
42+Copyright (C) 2008-2015 Andrea Rossato and John MacFarlane
93
43
94Released under the GNU General Public License version 2 or later.
44Released under the GNU General Public License version 2 or later.
95
45
96----------------------------------------------------------------------
46----------------------------------------------------------------------
97src/Text/Pandoc/Writers/Org.hs
47src/Text/Pandoc/Writers/Org.hs
98−Copyright (C) 2010-2021 Puneeth Chaganti, John MacFarlane, and
48+Copyright (C) 2010-2015 Puneeth Chaganti and John MacFarlane
99− Albert Krewinkel
100−
101−Released under the GNU General Public License version 2 or later.
102−
103−----------------------------------------------------------------------
104−src/Text/Pandoc/Writers/ZimWiki.hs
105−Copyright (C) 2017 Alex Ivkin
106−
107−Released under the GNU General Public License version 2 or later.
108−
109−----------------------------------------------------------------------
110−src/Text/Pandoc/Readers/Docx.hs
111−src/Text/Pandoc/Readers/Docx/*
112−Copyright (C) 2014-2020 Jesse Rosenthal
113
49
114Released under the GNU General Public License version 2 or later.
50Released under the GNU General Public License version 2 or later.
115
51
116----------------------------------------------------------------------
52----------------------------------------------------------------------
117src/Text/Pandoc/Readers/Textile.hs
53src/Text/Pandoc/Readers/Textile.hs
118−Copyright (C) 2010-2021 Paul Rivier and John MacFarlane
54+Copyright (C) 2010-2015 Paul Rivier and John MacFarlane
119−
120−Released under the GNU General Public License version 2 or later.
121−
122−----------------------------------------------------------------------
123−src/Text/Pandoc/Readers/TikiWiki.hs
124−Copyright (C) 2017 Robin Lee Powell
125−
126−Released under the GNU General Public License version 2 or later.
127−
128−----------------------------------------------------------------------
129−src/Text/Pandoc/Readers/JATS.hs
130−Copyright (C) 2017-2018 Hamish Mackenzie
131−
132−Released under the GNU General Public License version 2 or later.
133−
134−----------------------------------------------------------------------
135−src/Text/Pandoc/Readers/EPUB.hs
136−Copyright (C) 2014-2021 Matthew Pickering and John MacFarlane
137
55
138Released under the GNU General Public License version 2 or later.
56Released under the GNU General Public License version 2 or later.
139
57
140----------------------------------------------------------------------
58----------------------------------------------------------------------
141src/Text/Pandoc/Readers/Org.hs
59src/Text/Pandoc/Readers/Org.hs
142−src/Text/Pandoc/Readers/Org/*
143−test/Tests/Readers/Org/*
60+tests/Tests/Readers/Org.hs
144−Copyright (C) 2014-2021 Albert Krewinkel
61+Copyright (C) 2014-2015 Albert Krewinkel
145−
146−Released under the GNU General Public License version 2 or later.
147−
148−----------------------------------------------------------------------
149−src/Text/Pandoc/Lua.hs
150−src/Text/Pandoc/Lua/*
151−test/lua/*
152−Copyright (C) 2017--2021 Albert Krewinkel and John MacFarlane
153
62
154Released under the GNU General Public License version 2 or later.
63Released under the GNU General Public License version 2 or later.
155
64
156----------------------------------------------------------------------
65----------------------------------------------------------------------
157−src/Text/Pandoc/Readers/Jira.hs
66+data/LaTeXMathML.js
158−src/Text/Pandoc/Writers/Jira.hs
67+Adapted by Jeff Knisely and Douglas Woodall from
159−test/Tests/Readers/Jira.hs
68+ASCIIMathML.js v. 1.4.7
160−Copyright (C) 2019--2021 Albert Krewinkel
69+Copyright (C) 2005 Peter Jipsen
161
70
162Released under the GNU General Public License version 2 or later.
71Released under the GNU General Public License version 2 or later.
163
72
164----------------------------------------------------------------------
73----------------------------------------------------------------------
165−src/Text/Pandoc/Readers/FB2.hs
74+data/MathMLinHTML.js
166−Copyright (C) 2018--2019 Alexander Krotov
75+Copyright (C) 2004 Peter Jipsen http://www.chapman.edu/~jipsen
167
76
168Released under the GNU General Public License version 2 or later.
77Released under the GNU General Public License version 2 or later.
169
78
170−----------------------------------------------------------------------
79+------------------------------------------------------------------------
171−data/pandoc.lua
172−Copyright (C) 2017-2021 Albert Krewinkel
173−
174−Released under the GNU General Public License version 2 or later.
175−
176−----------------------------------------------------------------------
177−The dzslides template contains JavaScript and CSS from Paul Rouget's
80+The dzslides template contains javascript and CSS from Paul Rouget's
178dzslides template.
81dzslides template.
179−https://github.com/paulrouget/dzslides
82+http://github.com/paulrouget/dzslides
180
83
181Released under the Do What the Fuck You Want To Public License.
84Released under the Do What the Fuck You Want To Public License.
182
85
183------------------------------------------------------------------------
86------------------------------------------------------------------------
184−Pandoc embeds a Lua interpreter (via hslua).
87+Pandoc embeds a lua interpreter (via hslua).
185
88
186−Copyright © 1994–2020 Lua.org, PUC-Rio.
89+Copyright © 1994–2015 Lua.org, PUC-Rio.
187
90
188Permission is hereby granted, free of charge, to any person obtaining
91Permission is hereby granted, free of charge, to any person obtaining
189a copy of this software and associated documentation files (the
92a copy of this software and associated documentation files (the
HCAR-Pandoc.texnew file+35
@@ -0,0 +1,35 @@
1+% Pandoc-JP.tex
2+\begin{hcarentry}{Pandoc}
3+\label{pandoc}
4+\report{John MacFarlane}%05/11
5+\status{active development}
6+\participants{Andrea Rossato, Peter Wang, Paulo Tanimoto, Eric Kow,
7+Luke Plant, Justin Bogner, Paul Rivier, Nathan Gass, Puneeth Chaganti,
8+Josef Svenningsson, Etienne Millon, Joost Kremers}
9+\makeheader
10+
11+Pandoc aspires to be the swiss army knife of text markup formats: it
12+can read markdown and (with some limitations) HTML, LaTeX, Textile, and
13+reStructuredText, and it can write markdown, reStructuredText, HTML,
14+DocBook XML, OpenDocument XML, ODT, RTF, groff man, MediaWiki markup,
15+GNU Texinfo, LaTeX, ConTeXt, EPUB, Textile, Emacs org-mode,
16+Slidy, and S5. Pandoc's markdown syntax includes extensions for LaTeX math,
17+tables, definition lists, footnotes, and more.
18+
19+Since the last report, many new features have been added and improvements
20+made. Some highlights:
21+\begin{compactitem}
22+\item Support for Textile input and output.
23+\item Support for Emacs org-mode output.
24+\item A new ``builder'' module for constructing Pandoc documents programatically.
25+\item Support for \LaTeX math macros in markdown documents.
26+\item Support for automatic citations and bibliographies using Andrea
27+Rossato's citeproc-hs library.
28+\end{compactitem}
29+
30+These last two changes bring two of the most powerful features of \LaTeX
31+to pandoc.
32+
33+\FurtherReading
34+ \url{http://pandoc.org}
35+\end{hcarentry}
INSTALLnew file+260
@@ -0,0 +1,260 @@
1+% Installing pandoc
2+
3+These instructions explain how to install pandoc from source.
4+Binary packages or ports of pandoc are available for freebsd
5+and several linux distributions, so check your package manager.
6+There are also binary installers for Windows and Mac OS X.
7+
8+If you are installing the development version from github, see also:
9+https://github.com/jgm/pandoc/wiki/Installing-the-development-version-of-pandoc
10+
11+How to get the source
12+---------------------
13+
14+Source tarballs can be found at
15+<https://hackage.haskell.org/package/pandoc>. The tarball
16+for a particular version `VERSION` can be found at
17+
18+ https://hackage.haskell.org/package/pandoc-VERSION/pandoc-VERSION.tar.gz
19+
20+**Do not use the automatically generated tarball that can be
21+downloaded from pandoc's GitHub releases page.** It does not
22+include some essential template files, which come from a GitHub
23+submodule.
24+
25+If you want the latest development code, you can fetch it
26+by cloning the repository:
27+
28+ git clone https://github.com/jgm/pandoc
29+ cd pandoc
30+ git submodule update --init # to fetch the templates
31+
32+Note: there may be times when the development code is broken
33+or depends on other libraries which must be installed
34+separately. Unless you really know what you're doing, install
35+the last released version.
36+
37+Quick install with stack
38+------------------------
39+
40+1. Install [stack](http://docs.haskellstack.org/en/stable/install_and_upgrade.html).
41+
42+2. If you used git to get the pandoc source (as opposed to unpacking
43+ a release tarball), do
44+
45+ git submodule update --init
46+
47+3. In the pandoc source directory,
48+
49+ stack install
50+
51+ You may be prompted to run `stack setup`, which will automatically
52+ download the ghc compiler if needed.
53+
54+
55+Quick install with cabal
56+------------------------
57+
58+1. Install the [Haskell platform]. This will give you [GHC] and
59+ the [cabal-install] build tool.
60+
61+2. Update your package database:
62+
63+ cabal update
64+
65+3. Use `cabal` to install pandoc and its dependencies:
66+
67+ cabal install pandoc
68+
69+ This procedure will install the released version of pandoc,
70+ which will be downloaded automatically from HackageDB.
71+
72+ If this step fails, and you are using an older version
73+ of the Haskell Platform, e.g. on Debian stable, you may need to
74+ upgrade your version of cabal:
75+
76+ cabal install cabal-install
77+ ~/.cabal/bin/cabal update
78+ ~/.cabal/bin/cabal install pandoc
79+
80+ If you want to install a modified or development version
81+ of pandoc instead, switch to the source directory and do
82+ as above, but without the 'pandoc':
83+
84+ cabal install
85+
86+ Note: If you obtained the source from the git repository (rather
87+ than a release tarball), you'll need to do
88+
89+ git submodule update --init
90+
91+ to fetch the contents of `data/templates` before `cabal install`.
92+
93+4. Make sure the `$CABALDIR/bin` directory is in your path. You should
94+ now be able to run `pandoc`:
95+
96+ pandoc --help
97+
98+ [Not sure where `$CABALDIR` is?](http://www.haskell.org/haskellwiki/Cabal-Install#The_cabal-install_configuration_file)
99+
100+5. If you want to process citations with pandoc, you will also need to
101+ install a separate package, `pandoc-citeproc`. This can be installed
102+ using cabal:
103+
104+ cabal install pandoc-citeproc
105+
106+ By default `pandoc-citeproc` uses the "i;unicode-casemap" method
107+ to sort bibliography entries (RFC 5051). If you would like to
108+ use the locale-sensitive unicode collation algorithm instead,
109+ specify the `unicode_collation` flag:
110+
111+ cabal install pandoc-citeproc -funicode_collation
112+
113+ Note that this requires the `text-icu` library, which in turn
114+ depends on the C library `icu4c`. Installation directions
115+ vary by platform. Here is how it might work on OSX with homebrew:
116+
117+ brew install icu4c
118+ cabal install --extra-lib-dirs=/usr/local/Cellar/icu4c/51.1/lib \
119+ --extra-include-dirs=/usr/local/Cellar/icu4c/51.1/include \
120+ -funicode_collation text-icu pandoc-citeproc
121+
122+The `pandoc.1` man page will be installed automatically. cabal shows
123+you where it is installed: you may need to set your `MANPATH`
124+accordingly. If `MANUAL.txt` has been modified, the man page can be
125+rebuilt: `make man/pandoc.1`.
126+
127+The `pandoc-citeproc.1` man page will also be installed automatically.
128+
129+[GHC]: http://www.haskell.org/ghc/
130+[Haskell platform]: http://hackage.haskell.org/platform/
131+[cabal-install]: http://hackage.haskell.org/trac/hackage/wiki/CabalInstall
132+
133+Custom install
134+--------------
135+
136+This is a step-by-step procedure that offers maximal control
137+over the build and installation. Most users should use the
138+quick install, but this information may be of use to packagers.
139+For more details, see the [Cabal User's Guide]. These instructions
140+assume that the pandoc source directory is your working directory.
141+
142+1. Install dependencies: in addition to the [Haskell platform],
143+ you will need a number of additional libraries. You can install
144+ them all with
145+
146+ cabal update
147+ cabal install --only-dependencies
148+
149+2. Configure:
150+
151+ cabal configure --prefix=DIR --bindir=DIR --libdir=DIR \
152+ --datadir=DIR --libsubdir=DIR --datasubdir=DIR --docdir=DIR \
153+ --htmldir=DIR --program-prefix=PREFIX --program-suffix=SUFFIX \
154+ --mandir=DIR --flags=FLAGSPEC
155+
156+ All of the options have sensible defaults that can be overridden
157+ as needed.
158+
159+ `FLAGSPEC` is a list of Cabal configuration flags, optionally
160+ preceded by a `-` (to force the flag to `false`), and separated
161+ by spaces. Pandoc's flags include:
162+
163+ - `embed_data_files`: embed all data files into the binary (default no).
164+ This is helpful if you want to create a relocatable binary.
165+ Note: if this option is selected, you need to install the
166+ `hsb2hs` preprocessor: `cabal install hsb2hs` (version 0.3.1 or
167+ higher is required).
168+
169+ - `https`: enable support for downloading resources over https
170+ (using the `http-client` and `http-client-tls` libraries).
171+
172+3. Build:
173+
174+ cabal build
175+
176+4. Build API documentation:
177+
178+ cabal haddock --html-location=URL --hyperlink-source
179+
180+5. Copy the files:
181+
182+ cabal copy --destdir=PATH
183+
184+ The default destdir is `/`.
185+
186+6. Register pandoc as a GHC package:
187+
188+ cabal register
189+
190+ Package managers may want to use the `--gen-script` option to
191+ generate a script that can be run to register the package at
192+ install time.
193+
194+Creating a relocatable binary
195+-----------------------------
196+
197+It is possible to compile pandoc such that the data files
198+pandoc uses are embedded in the binary. The resulting binary
199+can be run from any directory and is completely self-contained.
200+
201+ cabal install hsb2hs # a required build tool
202+ cabal install --flags="embed_data_files" citeproc-hs
203+ cabal configure --flags="embed_data_files"
204+ cabal build
205+
206+You can find the pandoc executable in `dist/build/pandoc`. Copy this wherever
207+you please.
208+
209+Or alternatively with `stack`:
210+
211+ stack install pandoc --flag pandoc:embed_data_files
212+
213+[zip-archive]: http://hackage.haskell.org/package/zip-archive
214+[highlighting-kate]: http://hackage.haskell.org/package/highlighting-kate
215+[blaze-html]: http://hackage.haskell.org/package/blaze-html
216+[Cabal User's Guide]: http://www.haskell.org/cabal/release/latest/doc/users-guide/builders.html#setup-configure-paths
217+
218+Running tests
219+-------------
220+
221+Pandoc comes with an automated test suite integrated to cabal.
222+To build the tests:
223+
224+ cabal configure --enable-tests && cabal build
225+
226+To run the tests:
227+
228+ cabal test
229+
230+To run particular tests (pattern-matching on their names), use
231+the `-t` option:
232+
233+ cabal test --test-options='-t markdown'
234+
235+If you add a new feature to pandoc, please add tests as well, following
236+the pattern of the existing tests. The test suite code is in
237+`tests/test-pandoc.hs`. If you are adding a new reader or writer, it is
238+probably easiest to add some data files to the `tests` directory, and
239+modify `tests/Tests/Old.hs`. Otherwise, it is better to modify the module
240+under the `tests/Tests` hierarchy corresponding to the pandoc module you
241+are changing.
242+
243+Running benchmarks
244+------------------
245+
246+To build the benchmarks:
247+
248+ cabal configure --enable-benchmarks && cabal build
249+
250+To run the benchmarks:
251+
252+ cabal bench
253+
254+To use a smaller sample size so the benchmarks run faster:
255+
256+ cabal bench --benchmark-options='-s 20'
257+
258+To run just the markdown benchmarks:
259+
260+ cabal bench --benchmark-options='markdown'
INSTALL.mddeleted−415
@@ -1,415 +0,0 @@
1−# Installing pandoc
2−
3−The simplest way to get the latest pandoc release is to use the installer.
4−
5−<a href="https://github.com/jgm/pandoc/releases/latest"
6− class="btn btn-primary" id="downloadInstallerBtn">
7− Download the latest installer
8−</a>
9−
10−For alternative ways to install pandoc, see below
11−under the heading for your operating system.
12−
13−## Windows
14−
15−There is a package installer at pandoc's [download page].
16−This will install pandoc, replacing older versions, and
17−update your path to include the directory where pandoc's
18−binaries are installed.
19−
20−If you prefer not to use the msi installer, we also provide
21−a zip file that contains pandoc's binaries and
22−documentation. Simply unzip this file and move the binaries
23−to a directory of your choice.
24−
25−Alternatively, you can install pandoc using
26−[Chocolatey](https://chocolatey.org):
27−
28− choco install pandoc
29−
30−Chocolatey can also install other software that integrates with Pandoc.
31−For example, to install `rsvg-convert` (from [librsvg], covering formats
32−without SVG support), [Python] (to use Pandoc filters), and
33−[MiKTeX] (to typeset PDFs with [LaTeX]):
34−
35− choco install rsvg-convert python miktex
36−
37−Using multiple installation methods can result in two separate
38−installations of pandoc; it is recommended to properly uninstall
39−pandoc before switching to an alternative installation method.
40−
41−By default, Pandoc creates PDFs using LaTeX.
42−We recommend installing it via [MiKTeX].
43−
44−## macOS
45−
46−There is a package installer at pandoc's [download page].
47−If you later want to uninstall the package, you can do so
48−by downloading [this script][uninstaller]
49−and running it with `perl uninstall-pandoc.pl`.
50−
51−Alternatively, you can install pandoc using
52−[Homebrew](https://brew.sh):
53−
54− brew install pandoc
55−
56−Homebrew can also install other software that integrates with Pandoc.
57−For example, to install [librsvg] (its `rsvg-convert` covers formats
58−without SVG support), [Python] (to use Pandoc filters), and
59−[BasicTeX] (to typeset PDFs with [LaTeX]):
60−
61− brew install librsvg python homebrew/cask/basictex
62−
63−Note: On unsupported versions of macOS (more than three releases old),
64−Homebrew installs from source, which takes additional time and disk space
65−for the `ghc` compiler and dependent Haskell libraries.
66−
67−We also provide a zip file containing the binaries and man
68−pages, for those who prefer not to use the installer. Simply
69−unzip the file and move the binaries and man pages to
70−whatever directory you like.
71−
72−By default, Pandoc creates PDFs using LaTeX. Because a full [MacTeX]
73−installation uses four gigabytes of disk space, we recommend
74−[BasicTeX] or [TinyTeX](https://yihui.org/tinytex/)
75−and using the `tlmgr` tool to install additional packages
76−as needed. If you receive errors warning of fonts not found:
77−
78− tlmgr install collection-fontsrecommended
79−
80−## Linux
81−
82−Check whether the pandoc version in your package manager is
83−not outdated. Pandoc is in the [Debian], [Ubuntu], [Slackware],
84−[Arch], [Fedora], [NiXOS], [openSUSE], [gentoo] and [Void] repositories.
85−
86−To get the latest release, we provide a binary package for amd64
87−architecture on the **[download page]**.
88−
89−The executable is statically linked and
90−has no dynamic dependencies or dependencies on external
91−data files. Note: because of the static
92−linking, the pandoc binary from this package cannot use lua
93−filters that require external lua modules written in C.
94−
95−Both a tarball and a deb installer are provided. To install the deb:
96−
97− sudo dpkg -i $DEB
98−
99−where `$DEB` is the path to the downloaded deb. This will
100−install the `pandoc` executable and man page.
101−
102−If you use an RPM-based distro, you may be able to install
103−the deb from our download page using `alien`.
104−
105−On any distro, you may install from the tarball into `$DEST`
106−(say, `/usr/local/` or `$HOME/.local`) by doing
107−
108− tar xvzf $TGZ --strip-components 1 -C $DEST
109−
110−where `$TGZ` is the path to the downloaded zipped tarball.
111−For Pandoc versions before 2.0, which don't provide
112−a tarball, try instead
113−
114− ar p $DEB data.tar.gz | tar xvz --strip-components 2 -C $DEST
115−
116−You can also install from source, using the
117−instructions below under [Compiling from source].
118−Note that most distros have the Haskell platform in their
119−package repositories. For example, on Debian/Ubuntu,
120−you can install it with `apt-get install haskell-platform`.
121−
122−For PDF output, you'll need LaTeX. We recommend installing
123−[TeX Live](https://www.tug.org/texlive/) via your package
124−manager. (On Debian/Ubuntu, `apt-get install texlive`.)
125−
126−## Chrome OS
127−
128−On Chrome OS, pandoc can be installed using the
129−[chromebrew](https://github.com/skycocker/chromebrew) package manager
130−with the command:
131−
132−```sh
133−crew install pandoc
134−```
135−
136−This will automatically build and configure pandoc for the specific
137−device you are using.
138−
139−## BSD
140−
141−Pandoc is in the [NetBSD] and [FreeBSD ports] repositories.
142−
143−## Docker
144−
145−The official Docker images for pandoc can be found at
146−<https://github.com/pandoc/dockerfiles> and at
147−[dockerhub](https://hub.docker.com/).
148−
149−The [pandoc/core](https://hub.docker.com/r/pandoc/core)
150−image contains `pandoc`.
151−
152−The [pandoc/latex](https://hub.docker.com/r/pandoc/latex)
153−image also contains the minimal LaTeX installation needed
154−to produce PDFs using pandoc.
155−
156−To run pandoc using Docker, converting `README.md` to `README.pdf`:
157−
158− docker run --rm --volume "`pwd`:/data" --user `id -u`:`id -g` pandoc/latex README.md -o README.pdf
159−
160−## GitHub Actions
161−
162−Pandoc can be run through
163−[GitHub Actions](https://github.com/features/actions). For some
164−examples, see <https://github.com/pandoc/pandoc-action-example>.
165−
166−## Compiling from source
167−
168−If for some reason a binary package is not available for your
169−platform, or if you want to hack on pandoc or use a non-released
170−version, you can install from source.
171−
172−### Getting the pandoc source code
173−
174−Source tarballs can be found at
175−<https://hackage.haskell.org/package/pandoc>. For example, to
176−fetch the source for version 1.17.0.3:
177−
178− wget https://hackage.haskell.org/package/pandoc-1.17.0.3/pandoc-1.17.0.3.tar.gz
179− tar xvzf pandoc-1.17.0.3.tar.gz
180− cd pandoc-1.17.0.3
181−
182−Or you can fetch the development code by cloning the repository:
183−
184− git clone https://github.com/jgm/pandoc
185− cd pandoc
186−
187−Note: there may be times when the development code is broken
188−or depends on other libraries which must be installed
189−separately. Unless you really know what you're doing, install
190−the last released version.
191−
192−### Quick stack method
193−
194−The easiest way to build pandoc from source is to use [stack][stack]:
195−
196−1. Install [stack][stack]. Note that Pandoc requires stack >= 1.7.0.
197−
198−2. Change to the pandoc source directory and issue the following commands:
199−
200− stack setup
201− stack install
202−
203− `stack setup` will automatically download the ghc compiler
204− if you don't have it. `stack install` will install the
205− `pandoc` executable into `~/.local/bin`, which you should
206− add to your `PATH`. This process will take a while, and
207− will consume a considerable amount of disk space.
208−
209−### Quick cabal method
210−
211−1. Install the [Haskell platform]. This will give you [GHC] and
212− the [cabal-install] build tool. Note that pandoc requires
213− GHC >= 7.10 and cabal >= 2.0.
214−
215−2. Update your package database:
216−
217− cabal update
218−
219−3. Check your cabal version with
220−
221− cabal --version
222−
223− If you have a version less than 2.0, install the latest with:
224−
225− cabal install cabal-install
226−
227−4. Use `cabal` to install pandoc and its dependencies:
228−
229− cabal install pandoc
230−
231− This procedure will install the released version of pandoc,
232− which will be downloaded automatically from HackageDB.
233−
234− If you want to install a modified or development version
235− of pandoc instead, switch to the source directory and do
236− as above, but without the 'pandoc':
237−
238− cabal install
239−
240−5. Make sure the `$CABALDIR/bin` directory is in your path. You should
241− now be able to run `pandoc`:
242−
243− pandoc --help
244−
245− [Not sure where `$CABALDIR` is?](https://wiki.haskell.org/Cabal-Install#The_cabal-install_configuration_file)
246−
247−5. By default `pandoc` uses the "i;unicode-casemap" method
248− to sort bibliography entries (RFC 5051). If you would like to
249− use the locale-sensitive unicode collation algorithm instead,
250− specify the `icu` flag (which affects the dependency `citeproc`):
251−
252− cabal install pandoc -ficu
253−
254− Note that this requires the `text-icu` library, which in turn
255− depends on the C library `icu4c`. Installation directions
256− vary by platform. Here is how it might work on macOS with Homebrew:
257−
258− brew install icu4c
259− stack install pandoc \
260− --flag "citeproc:icu" \
261− --extra-lib-dirs=/usr/local/opt/icu4c/lib \
262− --extra-include-dirs=/usr/local/opt/icu4c/include
263−
264−6. The `pandoc.1` man page will be installed automatically. cabal shows
265− you where it is installed: you may need to set your `MANPATH`
266− accordingly. If `MANUAL.txt` has been modified, the man page can be
267− rebuilt: `make man/pandoc.1`.
268−
269−
270−### Custom cabal method
271−
272−This is a step-by-step procedure that offers maximal control
273−over the build and installation. Most users should use the
274−quick install, but this information may be of use to packagers.
275−For more details, see the [Cabal User's Guide]. These instructions
276−assume that the pandoc source directory is your working directory.
277−You will need cabal version 2.0 or higher.
278−
279−1. Install dependencies: in addition to the [Haskell platform],
280− you will need a number of additional libraries. You can install
281− them all with
282−
283− cabal update
284− cabal install --only-dependencies
285−
286−2. Configure:
287−
288− cabal configure --prefix=DIR --bindir=DIR --libdir=DIR \
289− --datadir=DIR --libsubdir=DIR --datasubdir=DIR --docdir=DIR \
290− --htmldir=DIR --program-prefix=PREFIX --program-suffix=SUFFIX \
291− --mandir=DIR --flags=FLAGSPEC --enable-tests
292−
293− All of the options have sensible defaults that can be overridden
294− as needed.
295−
296− `FLAGSPEC` is a list of Cabal configuration flags, optionally
297− preceded by a `-` (to force the flag to `false`), and separated
298− by spaces. Pandoc's flags include:
299−
300− - `embed_data_files`: embed all data files into the binary (default no).
301− This is helpful if you want to create a relocatable binary.
302−
303− - `https`: enable support for downloading resources over https
304− (using the `http-client` and `http-client-tls` libraries).
305−
306−3. Build:
307−
308− cabal build
309− cabal test
310−
311−4. Build API documentation:
312−
313− cabal haddock --html-location=URL --hyperlink-source
314−
315−5. Copy the files:
316−
317− cabal copy --destdir=PATH
318−
319− The default destdir is `/`.
320−
321−6. Register pandoc as a GHC package:
322−
323− cabal register
324−
325− Package managers may want to use the `--gen-script` option to
326− generate a script that can be run to register the package at
327− install time.
328−
329−### Creating a relocatable binary
330−
331−It is possible to compile pandoc such that the data files
332−pandoc uses are embedded in the binary. The resulting binary
333−can be run from any directory and is completely self-contained.
334−With cabal, add `-fembed_data_files` to the `cabal configure`
335−or `cabal install` commands.
336−
337−With stack, use `--flag pandoc:embed_data_files`.
338−
339−
340−
341−### Running tests
342−
343−Pandoc comes with an automated test suite.
344−To run with cabal, `cabal test`; to run with stack, `stack
345−test`.
346−
347−To run particular tests (pattern-matching on their names), use
348−the `-p` option:
349−
350− cabal install pandoc --enable-tests
351− cabal test --test-options='-p markdown'
352−
353−Or with stack:
354−
355− stack test --test-arguments='-p markdown'
356−
357−It is often helpful to add `-j4` (run tests in parallel)
358−and `--hide-successes` (don't clutter output with successes)
359−to the test arguments as well.
360−
361−If you add a new feature to pandoc, please add tests as well, following
362−the pattern of the existing tests. The test suite code is in
363−`test/test-pandoc.hs`. If you are adding a new reader or writer, it is
364−probably easiest to add some data files to the `test` directory, and
365−modify `test/Tests/Old.hs`. Otherwise, it is better to modify the module
366−under the `test/Tests` hierarchy corresponding to the pandoc module you
367−are changing.
368−
369−### Running benchmarks
370−
371−To build and run the benchmarks:
372−
373− cabal configure --enable-benchmarks && cabal build
374− cabal bench
375−
376−or with stack:
377−
378− stack bench
379−
380−To use a smaller sample size so the benchmarks run faster:
381−
382− cabal bench --benchmark-options='-s 20'
383−
384−To run just the markdown benchmarks:
385−
386− cabal bench --benchmark-options='markdown'
387−
388−
389−[Arch]: https://www.archlinux.org/packages/community/x86_64/pandoc/
390−[Cabal User's Guide]: https://cabal.readthedocs.io/
391−[Debian]: https://packages.debian.org/pandoc
392−[Fedora]: https://apps.fedoraproject.org/packages/pandoc
393−[FreeBSD ports]: https://www.freshports.org/textproc/hs-pandoc/
394−[GHC]: https://www.haskell.org/ghc/
395−[Haskell platform]: https://hackage.haskell.org/platform/
396−[MacPorts]: https://trac.macports.org/browser/trunk/dports/textproc/pandoc/Portfile
397−[MacTeX]: https://tug.org/mactex/
398−[BasicTeX]: https://www.tug.org/mactex/morepackages.html
399−[LaTeX]: https://www.latex-project.org
400−[MiKTeX]: https://miktex.org/
401−[librsvg]: https://wiki.gnome.org/Projects/LibRsvg
402−[Python]: https://www.python.org
403−[NetBSD]: https://pkgsrc.se/wip/pandoc
404−[NixOS]: https://nixos.org/nixos/packages.html
405−[Slackware]: https://www.slackbuilds.org/result/?search=pandoc&sv=
406−[Ubuntu]: https://packages.ubuntu.com/pandoc
407−[download page]: https://github.com/jgm/pandoc/releases/latest
408−[gentoo]: https://packages.gentoo.org/package/app-text/pandoc
409−[haskell repository]: https://wiki.archlinux.org/index.php/Haskell_Package_Guidelines#.5Bhaskell.5D
410−[openSUSE]: https://software.opensuse.org/package/pandoc
411−[source tarball]: https://hackage.haskell.org/package/pandoc
412−[stack]: https://docs.haskellstack.org/en/stable/install_and_upgrade.html
413−[cabal-install]: https://hackage.haskell.org/package/cabal-install
414−[Void]: https://voidlinux.org/
415−[uninstaller]: https://raw.githubusercontent.com/jgm/pandoc/master/macos/uninstall-pandoc.pl
Interact.hsnew file+34
@@ -0,0 +1,34 @@
1+-- Get an interactive shell with the right packages to load
2+-- pandoc modules.
3+
4+-- To use:
5+-- runghc Interact.hs
6+-- then,
7+-- :l Text/Pandoc.hs
8+-- (or whichever package you like)
9+
10+-- You must have first done a 'cabal configure' or 'cabal install'
11+
12+-- Note: Interact.hs doesn't work with Cabal >= 1.18. I recommend
13+-- using cabal sandboxes and the new 'cabal repl' command if you are
14+-- using a recent version.
15+
16+import System.Process
17+import Distribution.Simple.LocalBuildInfo
18+import Distribution.Package
19+import Distribution.Version
20+import Data.List (intercalate)
21+
22+main = do
23+ setupConfig' <- readFile "dist/setup-config"
24+ let setupConfig = read $ unlines $ drop 1 $ lines setupConfig'
25+ let (Just (ComponentLocalBuildInfo { componentPackageDeps = deps })) = libraryConfig setupConfig
26+ let packageSpecs = map (toPackageSpec . snd) deps
27+ let args = ["-optP-include", "-optP../dist/build/autogen/cabal_macros.h","-cpp","-I../dist/build/autogen","-i../dist/build/autogen"] ++ concatMap (\p -> ["-package",p]) packageSpecs
28+ print args
29+ ph <- runProcess "ghci" args (Just "src") Nothing Nothing Nothing Nothing
30+ waitForProcess ph
31+
32+toPackageSpec pkg = pkgN ++ "-" ++ pkgV
33+ where (PackageName pkgN) = pkgName pkg
34+ pkgV = intercalate "." $ map show $ versionBranch $ pkgVersion pkg
MANUAL.txt+1723−4229
@@ -1,34 +1,46 @@
1−---
2−title: Pandoc User's Guide
1+% Pandoc User's Guide
3−author: John MacFarlane
2+% John MacFarlane
4−date: June 20, 2021
3+% July 17, 2016
5−---
6
4
7−# Synopsis
5+Synopsis
6+========
8
7
9`pandoc` [*options*] [*input-file*]...
8`pandoc` [*options*] [*input-file*]...
10
9
11−# Description
10+Description
11+===========
12
12
13Pandoc is a [Haskell] library for converting from one markup format to
13Pandoc is a [Haskell] library for converting from one markup format to
14−another, and a command-line tool that uses this library.
14+another, and a command-line tool that uses this library. It can read
15−
15+[Markdown], [CommonMark], [PHP Markdown Extra], [GitHub-Flavored Markdown],
16−Pandoc can convert between numerous markup and word processing formats,
16+[MultiMarkdown], and (subsets of) [Textile], [reStructuredText], [HTML],
17−including, but not limited to, various flavors of [Markdown], [HTML],
17+[LaTeX], [MediaWiki markup], [TWiki markup], [Haddock markup], [OPML], [Emacs
18−[LaTeX] and [Word docx]. For the full lists of input and output formats,
18+Org mode], [DocBook], [txt2tags], [EPUB], [ODT] and [Word docx]; and it can
19−see the `--from` and `--to` [options below][General options].
19+write plain text, [Markdown], [CommonMark], [PHP Markdown Extra],
20−Pandoc can also produce [PDF] output: see [creating a PDF], below.
20+[GitHub-Flavored Markdown], [MultiMarkdown], [reStructuredText], [XHTML],
21−
21+[HTML5], [LaTeX] (including [`beamer`] slide shows), [ConTeXt], [RTF], [OPML],
22+[DocBook], [OpenDocument], [ODT], [Word docx], [GNU Texinfo], [MediaWiki
23+markup], [DokuWiki markup], [ZimWiki markup], [Haddock markup],
24+[EPUB] (v2 or v3), [FictionBook2], [Textile], [groff man] pages,
25+[Emacs Org mode], [AsciiDoc], [InDesign ICML], [TEI Simple], and [Slidy],
26+[Slideous], [DZSlides], [reveal.js] or [S5] HTML slide shows. It can also
27+produce [PDF] output on systems where LaTeX, ConTeXt, or `wkhtmltopdf` is
28+installed.
29+
22−Pandoc's enhanced version of Markdown includes syntax for [tables],
30+Pandoc's enhanced version of Markdown includes syntax for [footnotes],
23−[definition lists], [metadata blocks], [footnotes], [citations], [math],
31+[tables], flexible [ordered lists], [definition lists], [fenced code blocks],
32+[superscripts and subscripts], [strikeout], [metadata blocks], automatic tables of
33+contents, embedded LaTeX [math], [citations], and [Markdown inside HTML block
34+elements][Extension: `markdown_in_html_blocks`]. (These enhancements, described below under
24−and much more. See below under [Pandoc's Markdown].
35+[Pandoc's Markdown], can be disabled using the
25−
36+`markdown_strict` input or output format.)
37+
38+In contrast to most existing tools for converting Markdown to HTML, which
26−Pandoc has a modular design: it consists of a set of readers, which parse
39+use regex substitutions, pandoc has a modular design: it consists of a
27−text in a given format and produce a native representation of the document
40+set of readers, which parse text in a given format and produce a native
28−(an _abstract syntax tree_ or AST), and a set of writers, which convert
41+representation of the document, and a set of writers, which convert
29this native representation into a target format. Thus, adding an input
42this native representation into a target format. Thus, adding an input
30−or output format requires only adding a reader or writer. Users can also
43+or output format requires only adding a reader or writer.
31−run custom [pandoc filters] to modify the intermediate AST.
32
44
33Because pandoc's intermediate representation of a document is less
45Because pandoc's intermediate representation of a document is less
34expressive than many of the formats it converts between, one should
46expressive than many of the formats it converts between, one should
@@ -40,33 +52,83 @@ model. While conversions from pandoc's Markdown to all formats aspire
40to be perfect, conversions from formats more expressive than pandoc's
52to be perfect, conversions from formats more expressive than pandoc's
41Markdown can be expected to be lossy.
53Markdown can be expected to be lossy.
42
54
55+[Markdown]: http://daringfireball.net/projects/markdown/
56+[CommonMark]: http://commonmark.org
57+[PHP Markdown Extra]: https://michelf.ca/projects/php-markdown/extra/
58+[GitHub-Flavored Markdown]: https://help.github.com/articles/github-flavored-markdown/
59+[MultiMarkdown]: http://fletcherpenney.net/multimarkdown/
60+[reStructuredText]: http://docutils.sourceforge.net/docs/ref/rst/introduction.html
61+[S5]: http://meyerweb.com/eric/tools/s5/
62+[Slidy]: http://www.w3.org/Talks/Tools/Slidy/
63+[Slideous]: http://goessner.net/articles/slideous/
64+[HTML]: http://www.w3.org/html/
65+[HTML5]: http://www.w3.org/TR/html5/
66+[XHTML]: http://www.w3.org/TR/xhtml1/
67+[LaTeX]: http://latex-project.org
68+[`beamer`]: https://ctan.org/pkg/beamer
69+[Beamer User's Guide]: http://ctan.math.utah.edu/ctan/tex-archive/macros/latex/contrib/beamer/doc/beameruserguide.pdf
70+[ConTeXt]: http://contextgarden.net/
71+[RTF]: http://en.wikipedia.org/wiki/Rich_Text_Format
72+[DocBook]: http://docbook.org
73+[txt2tags]: http://txt2tags.org
74+[EPUB]: http://idpf.org/epub
75+[OPML]: http://dev.opml.org/spec2.html
76+[OpenDocument]: http://opendocument.xml.org
77+[ODT]: http://en.wikipedia.org/wiki/OpenDocument
78+[Textile]: http://redcloth.org/textile
79+[MediaWiki markup]: https://www.mediawiki.org/wiki/Help:Formatting
80+[DokuWiki markup]: https://www.dokuwiki.org/dokuwiki
81+[ZimWiki markup]: http://zim-wiki.org/manual/Help/Wiki_Syntax.html
82+[TWiki markup]: http://twiki.org/cgi-bin/view/TWiki/TextFormattingRules
83+[Haddock markup]: https://www.haskell.org/haddock/doc/html/ch03s08.html
84+[groff man]: http://developer.apple.com/DOCUMENTATION/Darwin/Reference/ManPages/man7/groff_man.7.html
85+[Haskell]: https://www.haskell.org
86+[GNU Texinfo]: http://www.gnu.org/software/texinfo/
87+[Emacs Org mode]: http://orgmode.org
88+[AsciiDoc]: http://www.methods.co.nz/asciidoc/
89+[DZSlides]: http://paulrouget.com/dzslides/
90+[Word docx]: http://www.microsoft.com/interop/openup/openxml/default.aspx
91+[PDF]: https://www.adobe.com/pdf/
92+[reveal.js]: http://lab.hakim.se/reveal-js/
93+[FictionBook2]: http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1
94+[InDesign ICML]: https://www.adobe.com/content/dam/Adobe/en/devnet/indesign/cs55-docs/IDML/idml-specification.pdf
95+[TEI Simple]: https://github.com/TEIC/TEI-Simple
96+
43−## Using pandoc
97+Using `pandoc`
98+--------------
44
99
45−If no *input-files* are specified, input is read from *stdin*.
100+If no *input-file* is specified, input is read from *stdin*.
101+Otherwise, the *input-files* are concatenated (with a blank
46−Output goes to *stdout* by default. For output to a file,
102+line between each) and used as input. Output goes to *stdout* by
103+default (though output to *stdout* is disabled for the `odt`, `docx`,
104+`epub`, and `epub3` output formats). For output to a file, use the
47−use the `-o` option:
105+`-o` option:
48
106
49 pandoc -o output.html input.txt
107 pandoc -o output.html input.txt
50
108
51−By default, pandoc produces a document fragment. To produce a standalone
109+By default, pandoc produces a document fragment, not a standalone
52−document (e.g. a valid HTML file including `<head>` and `<body>`),
110+document with a proper header and footer. To produce a standalone
53−use the `-s` or `--standalone` flag:
111+document, use the `-s` or `--standalone` flag:
54
112
55 pandoc -s -o output.html input.txt
113 pandoc -s -o output.html input.txt
56
114
57For more information on how standalone documents are produced, see
115For more information on how standalone documents are produced, see
58−[Templates] below.
116+[Templates], below.
59
117
60−If multiple input files are given, `pandoc` will concatenate them all (with
118+Instead of a file, an absolute URI may be given. In this case
61−blank lines between them) before parsing. (Use `--file-scope` to parse files
119+pandoc will fetch the content using HTTP:
62−individually.)
120+
121+ pandoc -f html -t markdown http://www.fsf.org
63
122
64−## Specifying formats
123+If multiple input files are given, `pandoc` will concatenate them all (with
124+blank lines between them) before parsing. This feature is disabled for
125+ binary input formats such as `EPUB`, `odt`, and `docx`.
65
126
66The format of the input and output can be specified explicitly using
127The format of the input and output can be specified explicitly using
67command-line options. The input format can be specified using the
128command-line options. The input format can be specified using the
68−`-f/--from` option, the output format using the `-t/--to` option.
129+`-r/--read` or `-f/--from` options, the output format using the
130+`-w/--write` or `-t/--to` options. Thus, to convert `hello.txt` from
69−Thus, to convert `hello.txt` from Markdown to LaTeX, you could type:
131+Markdown to LaTeX, you could type:
70
132
71 pandoc -f markdown -t latex hello.txt
133 pandoc -f markdown -t latex hello.txt
72
134
@@ -74,15 +136,14 @@ To convert `hello.html` from HTML to Markdown:
74
136
75 pandoc -f html -t markdown hello.html
137 pandoc -f html -t markdown hello.html
76
138
77−Supported input and output formats are listed below under [Options]
139+Supported output formats are listed below under the `-t/--to` option.
78−(see `-f` for input formats and `-t` for output formats). You
140+Supported input formats are listed below under the `-f/--from` option. Note
79−can also use `pandoc --list-input-formats` and
141+that the `rst`, `textile`, `latex`, and `html` readers are not complete;
80−`pandoc --list-output-formats` to print lists of supported
142+there are some constructs that they do not parse.
81−formats.
82
143
83If the input or output format is not specified explicitly, `pandoc`
144If the input or output format is not specified explicitly, `pandoc`
84−will attempt to guess it from the extensions of the filenames.
145+will attempt to guess it from the extensions of
85−Thus, for example,
146+the input and output filenames. Thus, for example,
86
147
87 pandoc -o hello.tex hello.txt
148 pandoc -o hello.tex hello.txt
88
149
@@ -91,9 +152,7 @@ is specified (so that output goes to *stdout*), or if the output file's
91extension is unknown, the output format will default to HTML.
152extension is unknown, the output format will default to HTML.
92If no input file is specified (so that input comes from *stdin*), or
153If no input file is specified (so that input comes from *stdin*), or
93if the input files' extensions are unknown, the input format will
154if the input files' extensions are unknown, the input format will
94−be assumed to be Markdown.
155+be assumed to be Markdown unless explicitly specified.
95−
96−## Character encoding
97
156
98Pandoc uses the UTF-8 character encoding for both input and output.
157Pandoc uses the UTF-8 character encoding for both input and output.
99If your local character encoding is not UTF-8, you
158If your local character encoding is not UTF-8, you
@@ -106,432 +165,219 @@ RTF, OPML, DocBook, and Texinfo), information about
106the character encoding is included in the document header, which
165the character encoding is included in the document header, which
107will only be included if you use the `-s/--standalone` option.
166will only be included if you use the `-s/--standalone` option.
108
167
109−[`iconv`]: https://www.gnu.org/software/libiconv/
168+[`iconv`]: http://www.gnu.org/software/libiconv/
110
169
111−## Creating a PDF
170+Creating a PDF
171+--------------
112
172
113−To produce a PDF, specify an output file with a `.pdf` extension:
173+To produce a PDF, specify an output file with a `.pdf` extension.
174+By default, pandoc will use LaTeX to convert it to PDF:
114
175
115 pandoc test.txt -o test.pdf
176 pandoc test.txt -o test.pdf
116
177
117−By default, pandoc will use LaTeX to create the PDF, which requires
118−that a LaTeX engine be installed (see `--pdf-engine` below).
178+Production of a PDF requires that a LaTeX engine be installed (see
119−Alternatively, pandoc can use ConTeXt, roff ms, or HTML as an
179+`--latex-engine`, below), and assumes that the following LaTeX packages
120−intermediate format. To do this, specify an output file with a
121−`.pdf` extension, as before, but add the `--pdf-engine` option
122−or `-t context`, `-t html`, or `-t ms` to the command line.
123−The tool used to generate the PDF from the intermediate format
124−may be specified using `--pdf-engine`.
125−
126−You can control the PDF style using variables, depending on
127−the intermediate format used: see [variables for LaTeX],
128−[variables for ConTeXt], [variables for `wkhtmltopdf`],
129−[variables for ms]. When HTML is used as an intermediate
130−format, the output can be styled using `--css`.
131−
132−To debug the PDF creation, it can be useful to look at the intermediate
133−representation: instead of `-o test.pdf`, use for example `-s -o test.tex`
134−to output the generated LaTeX. You can then test it with `pdflatex test.tex`.
135−
136−When using LaTeX, the following packages need to be available
137−(they are included with all recent versions of [TeX Live]):
138−[`amsfonts`], [`amsmath`], [`lm`], [`unicode-math`],
180+are available: [`amsfonts`], [`amsmath`], [`lm`],
139−[`iftex`], [`listings`] (if the
181+[`ifxetex`], [`ifluatex`], [`eurosym`], [`listings`] (if the
140`--listings` option is used), [`fancyvrb`], [`longtable`],
182`--listings` option is used), [`fancyvrb`], [`longtable`],
141−[`booktabs`], [`graphicx`] (if the document
183+[`booktabs`], [`graphicx`] and [`grffile`] (if the
142−contains images), [`hyperref`], [`xcolor`],
184+document contains images), [`hyperref`], [`ulem`],
143−[`ulem`], [`geometry`] (with the `geometry` variable set),
185+[`geometry`] (with the `geometry` variable set), [`setspace`] (with
144−[`setspace`] (with `linestretch`), and
145−[`babel`] (with `lang`). The use of `xelatex` or `lualatex` as
186+`linestretch`), and [`babel`] (with `lang`). The use of `xelatex` or
146−the PDF engine requires [`fontspec`]. `lualatex` uses
187+`lualatex` as the LaTeX engine requires [`fontspec`]; `xelatex` uses
147−[`selnolig`]. `xelatex` uses [`polyglossia`] (with `lang`),
188+[`mathspec`], [`polyglossia`] (with `lang`), [`xecjk`], and
148−[`xecjk`], and [`bidi`] (with the `dir` variable set). If the
189+[`bidi`] (with the `dir` variable set). The [`upquote`] and
149−`mathspec` variable is set, `xelatex` will use [`mathspec`]
150−instead of [`unicode-math`]. The [`upquote`] and [`microtype`]
151−packages are used if available, and [`csquotes`] will be used
190+[`microtype`] packages are used if available, and [`csquotes`] will
152−for [typography] if the `csquotes` variable or metadata field is
191+be used for [smart punctuation] if added to the template or included in
153−set to a true value. The [`natbib`], [`biblatex`], [`bibtex`],
192+any header file. The [`natbib`], [`biblatex`], [`bibtex`], and [`biber`]
154−and [`biber`] packages can optionally be used for [citation
193+packages can optionally be used for [citation rendering]. These are
155−rendering]. The following packages will be used to improve
194+included with all recent versions of [TeX Live].
156−output quality if present, but pandoc does not require them to
195+
157−be present: [`upquote`] (for straight quotes in verbatim
196+Alternatively, pandoc can use ConTeXt or `wkhtmltopdf` to create a PDF.
158−environments), [`microtype`] (for better spacing adjustments),
197+To do this, specify an output file with a `.pdf` extension,
159−[`parskip`] (for better inter-paragraph spaces), [`xurl`] (for
198+as before, but add `-t context` or `-t html5` to the command line.
160−better line breaks in URLs), [`bookmark`] (for better PDF
199+
161−bookmarks), and [`footnotehyper`] or [`footnote`] (to allow
200+PDF output can be controlled using [variables for LaTeX] (if
162−footnotes in tables).
201+LaTeX is used) and [variables for ConTeXt] (if ConTeXt is used).
163−
202+If `wkhtmltopdf` is used, then the variables `margin-left`,
164−[TeX Live]: https://www.tug.org/texlive/
203+`margin-right`, `margin-top`, `margin-bottom`, and `papersize`
204+will affect the output, as will `--css`.
205+
165[`amsfonts`]: https://ctan.org/pkg/amsfonts
206[`amsfonts`]: https://ctan.org/pkg/amsfonts
166[`amsmath`]: https://ctan.org/pkg/amsmath
207[`amsmath`]: https://ctan.org/pkg/amsmath
167−[`babel`]: https://ctan.org/pkg/babel
168−[`biber`]: https://ctan.org/pkg/biber
169−[`biblatex`]: https://ctan.org/pkg/biblatex
170−[`bibtex`]: https://ctan.org/pkg/bibtex
208+[`lm`]: https://ctan.org/pkg/lm
171−[`bidi`]: https://ctan.org/pkg/bidi
209+[`ifxetex`]: https://ctan.org/pkg/ifxetex
172−[`bookmark`]: https://ctan.org/pkg/bookmark
210+[`ifluatex`]: https://ctan.org/pkg/ifluatex
173−[`booktabs`]: https://ctan.org/pkg/booktabs
211+[`eurosym`]: https://ctan.org/pkg/eurosym
174−[`csquotes`]: https://ctan.org/pkg/csquotes
212+[`listings`]: https://ctan.org/pkg/listings
175[`fancyvrb`]: https://ctan.org/pkg/fancyvrb
213[`fancyvrb`]: https://ctan.org/pkg/fancyvrb
176−[`fontspec`]: https://ctan.org/pkg/fontspec
214+[`longtable`]: https://ctan.org/pkg/longtable
177−[`footnote`]: https://ctan.org/pkg/footnote
215+[`booktabs`]: https://ctan.org/pkg/booktabs
178−[`footnotehyper`]: https://ctan.org/pkg/footnotehyper
179−[`geometry`]: https://ctan.org/pkg/geometry
180[`graphicx`]: https://ctan.org/pkg/graphicx
216[`graphicx`]: https://ctan.org/pkg/graphicx
181[`grffile`]: https://ctan.org/pkg/grffile
217[`grffile`]: https://ctan.org/pkg/grffile
218+[`geometry`]: https://ctan.org/pkg/geometry
219+[`setspace`]: https://ctan.org/pkg/setspace
220+[`xecjk`]: https://ctan.org/pkg/xecjk
182[`hyperref`]: https://ctan.org/pkg/hyperref
221[`hyperref`]: https://ctan.org/pkg/hyperref
183−[`iftex`]: https://ctan.org/pkg/iftex
184−[`listings`]: https://ctan.org/pkg/listings
222+[`ulem`]: https://ctan.org/pkg/ulem
185−[`lm`]: https://ctan.org/pkg/lm
223+[`babel`]: https://ctan.org/pkg/babel
186−[`longtable`]: https://ctan.org/pkg/longtable
224+[`bidi`]: https://ctan.org/pkg/bidi
187[`mathspec`]: https://ctan.org/pkg/mathspec
225[`mathspec`]: https://ctan.org/pkg/mathspec
188−[`microtype`]: https://ctan.org/pkg/microtype
189−[`natbib`]: https://ctan.org/pkg/natbib
190−[`parskip`]: https://ctan.org/pkg/parskip
191[`polyglossia`]: https://ctan.org/pkg/polyglossia
226[`polyglossia`]: https://ctan.org/pkg/polyglossia
192−[`prince`]: https://www.princexml.com/
193−[`setspace`]: https://ctan.org/pkg/setspace
227+[`fontspec`]: https://ctan.org/pkg/fontspec
194−[`ulem`]: https://ctan.org/pkg/ulem
195−[`unicode-math`]: https://ctan.org/pkg/unicode-math
196[`upquote`]: https://ctan.org/pkg/upquote
228[`upquote`]: https://ctan.org/pkg/upquote
197−[`weasyprint`]: https://weasyprint.org
229+[`microtype`]: https://ctan.org/pkg/microtype
198−[`wkhtmltopdf`]: https://wkhtmltopdf.org
230+[`csquotes`]: https://ctan.org/pkg/csquotes
199−[`xcolor`]: https://ctan.org/pkg/xcolor
231+[`natbib`]: https://ctan.org/pkg/natbib
200−[`xecjk`]: https://ctan.org/pkg/xecjk
232+[`biblatex`]: https://ctan.org/pkg/biblatex
201−[`xurl`]: https://ctan.org/pkg/xurl
233+[`bibtex`]: https://ctan.org/pkg/bibtex
202−[`selnolig`]: https://ctan.org/pkg/selnolig
234+[`biber`]: https://ctan.org/pkg/biber
203−
235+[TeX Live]: http://www.tug.org/texlive/
204−
205−
206−## Reading from the Web
207−
208−Instead of an input file, an absolute URI may be given. In this case
209−pandoc will fetch the content using HTTP:
210−
211− pandoc -f html -t markdown https://www.fsf.org
212−
213−It is possible to supply a custom User-Agent string or other
214−header when requesting a document from a URL:
215−
216− pandoc -f html -t markdown --request-header User-Agent:"Mozilla/5.0" \
217− https://www.fsf.org
218
236
219−# Options
237+Options
238+=======
220
239
221−## General options {.options}
240+General options
241+---------------
222
242
223`-f` *FORMAT*, `-r` *FORMAT*, `--from=`*FORMAT*, `--read=`*FORMAT*
243`-f` *FORMAT*, `-r` *FORMAT*, `--from=`*FORMAT*, `--read=`*FORMAT*
224
244
225−: Specify input format. *FORMAT* can be:
245+: Specify input format. *FORMAT* can be `native` (native Haskell),
226−
227− ::: {#input-formats}
228− - `bibtex` ([BibTeX] bibliography)
229− - `biblatex` ([BibLaTeX] bibliography)
230− - `commonmark` ([CommonMark] Markdown)
231− - `commonmark_x` ([CommonMark] Markdown with extensions)
232− - `creole` ([Creole 1.0])
233− - `csljson` ([CSL JSON] bibliography)
234− - `csv` ([CSV] table)
235− - `docbook` ([DocBook])
236− - `docx` ([Word docx])
237− - `dokuwiki` ([DokuWiki markup])
238− - `epub` ([EPUB])
239− - `fb2` ([FictionBook2] e-book)
240− - `gfm` ([GitHub-Flavored Markdown]),
241− or the deprecated and less accurate `markdown_github`;
242− use [`markdown_github`](#markdown-variants) only
243− if you need extensions not supported in [`gfm`](#markdown-variants).
244− - `haddock` ([Haddock markup])
245− - `html` ([HTML])
246− - `ipynb` ([Jupyter notebook])
247− - `jats` ([JATS] XML)
248− - `jira` ([Jira]/Confluence wiki markup)
249− - `json` (JSON version of native AST)
246+ `json` (JSON version of native AST), `markdown` (pandoc's
250− - `latex` ([LaTeX])
247+ extended Markdown), `markdown_strict` (original unextended
251− - `markdown` ([Pandoc's Markdown])
252− - `markdown_mmd` ([MultiMarkdown])
253− - `markdown_phpextra` ([PHP Markdown Extra])
248+ Markdown), `markdown_phpextra` (PHP Markdown Extra), `markdown_github`
254− - `markdown_strict` (original unextended [Markdown])
249+ (GitHub-Flavored Markdown), `markdown_mmd` (MultiMarkdown),
255− - `mediawiki` ([MediaWiki markup])
250+ `commonmark` (CommonMark Markdown), `textile` (Textile), `rst`
256− - `man` ([roff man])
251+ (reStructuredText), `html` (HTML), `docbook` (DocBook), `t2t`
257− - `muse` ([Muse])
252+ (txt2tags), `docx` (docx), `odt` (ODT), `epub` (EPUB), `opml` (OPML),
258− - `native` (native Haskell)
259− - `odt` ([ODT])
260− - `opml` ([OPML])
261− - `org` ([Emacs Org mode])
253+ `org` (Emacs Org mode), `mediawiki` (MediaWiki markup), `twiki` (TWiki
262− - `rst` ([reStructuredText])
254+ markup), `haddock` (Haddock markup), or `latex` (LaTeX). If
263− - `t2t` ([txt2tags])
255+ `+lhs` is appended to `markdown`, `rst`, `latex`, or `html`, the
264− - `textile` ([Textile])
256+ input will be treated as literate Haskell source: see [Literate
265− - `tikiwiki` ([TikiWiki markup])
257+ Haskell support], below. Markdown
266− - `twiki` ([TWiki markup])
267− - `vimwiki` ([Vimwiki])
268− :::
269−
270− Extensions can be individually enabled or disabled by
258+ syntax extensions can be individually enabled or disabled by
271− appending `+EXTENSION` or `-EXTENSION` to the format name.
259+ appending `+EXTENSION` or `-EXTENSION` to the format name. So, for
260+ example, `markdown_strict+footnotes+definition_lists` is strict
261+ Markdown with footnotes and definition lists enabled, and
262+ `markdown-pipe_tables+hard_line_breaks` is pandoc's Markdown
263+ without pipe tables and with hard line breaks. See [Pandoc's
272− See [Extensions] below, for a list of extensions and
264+ Markdown], below, for a list of extensions and
273− their names. See `--list-input-formats` and `--list-extensions`,
265+ their names.
274− below.
275
266
276`-t` *FORMAT*, `-w` *FORMAT*, `--to=`*FORMAT*, `--write=`*FORMAT*
267`-t` *FORMAT*, `-w` *FORMAT*, `--to=`*FORMAT*, `--write=`*FORMAT*
277
268
278−: Specify output format. *FORMAT* can be:
269+: Specify output format. *FORMAT* can be `native` (native Haskell),
279−
280− ::: {#output-formats}
281− - `asciidoc` ([AsciiDoc]) or `asciidoctor` ([AsciiDoctor])
282− - `beamer` ([LaTeX beamer][`beamer`] slide show)
283− - `bibtex` ([BibTeX] bibliography)
284− - `biblatex` ([BibLaTeX] bibliography)
285− - `commonmark` ([CommonMark] Markdown)
286− - `commonmark_x` ([CommonMark] Markdown with extensions)
287− - `context` ([ConTeXt])
288− - `csljson` ([CSL JSON] bibliography)
289− - `docbook` or `docbook4` ([DocBook] 4)
290− - `docbook5` (DocBook 5)
291− - `docx` ([Word docx])
292− - `dokuwiki` ([DokuWiki markup])
293− - `epub` or `epub3` ([EPUB] v3 book)
294− - `epub2` (EPUB v2)
295− - `fb2` ([FictionBook2] e-book)
296− - `gfm` ([GitHub-Flavored Markdown]),
297− or the deprecated and less accurate `markdown_github`;
298− use [`markdown_github`](#markdown-variants) only
299− if you need extensions not supported in [`gfm`](#markdown-variants).
300− - `haddock` ([Haddock markup])
301− - `html` or `html5` ([HTML], i.e. [HTML5]/XHTML [polyglot markup])
302− - `html4` ([XHTML] 1.0 Transitional)
303− - `icml` ([InDesign ICML])
304− - `ipynb` ([Jupyter notebook])
305− - `jats_archiving` ([JATS] XML, Archiving and Interchange Tag Set)
306− - `jats_articleauthoring` ([JATS] XML, Article Authoring Tag Set)
307− - `jats_publishing` ([JATS] XML, Journal Publishing Tag Set)
308− - `jats` (alias for `jats_archiving`)
309− - `jira` ([Jira]/Confluence wiki markup)
310− - `json` (JSON version of native AST)
270+ `json` (JSON version of native AST), `plain` (plain text),
311− - `latex` ([LaTeX])
312− - `man` ([roff man])
313− - `markdown` ([Pandoc's Markdown])
271+ `markdown` (pandoc's extended Markdown), `markdown_strict`
314− - `markdown_mmd` ([MultiMarkdown])
315− - `markdown_phpextra` ([PHP Markdown Extra])
272+ (original unextended Markdown), `markdown_phpextra` (PHP Markdown
316− - `markdown_strict` (original unextended [Markdown])
273+ Extra), `markdown_github` (GitHub-Flavored Markdown), `markdown_mmd`
274+ (MultiMarkdown), `commonmark` (CommonMark Markdown), `rst`
275+ (reStructuredText), `html` (XHTML), `html5` (HTML5), `latex`
276+ (LaTeX), `beamer` (LaTeX beamer slide show), `context` (ConTeXt),
317− - `mediawiki` ([MediaWiki markup])
277+ `man` (groff man), `mediawiki` (MediaWiki markup),
318− - `ms` ([roff ms])
278+ `dokuwiki` (DokuWiki markup), `zimwiki` (ZimWiki markup),
319− - `muse` ([Muse]),
320− - `native` (native Haskell),
321− - `odt` ([OpenOffice text document][ODT])
322− - `opml` ([OPML])
323− - `opendocument` ([OpenDocument])
324− - `org` ([Emacs Org mode])
279+ `textile` (Textile), `org` (Emacs Org mode),
325− - `pdf` ([PDF])
326− - `plain` (plain text),
327− - `pptx` ([PowerPoint] slide show)
328− - `rst` ([reStructuredText])
329− - `rtf` ([Rich Text Format])
330− - `texinfo` ([GNU Texinfo])
280+ `texinfo` (GNU Texinfo), `opml` (OPML), `docbook` (DocBook 4),
331− - `textile` ([Textile])
281+ `docbook5` (DocBook 5), `opendocument` (OpenDocument), `odt`
332− - `slideous` ([Slideous] HTML and JavaScript slide show)
282+ (OpenOffice text document), `docx` (Word docx), `haddock`
283+ (Haddock markup), `rtf` (rich text format), `epub` (EPUB v2
284+ book), `epub3` (EPUB v3), `fb2` (FictionBook2 e-book),
285+ `asciidoc` (AsciiDoc), `icml` (InDesign ICML), `tei` (TEI
333− - `slidy` ([Slidy] HTML and JavaScript slide show)
286+ Simple), `slidy` (Slidy HTML and javascript slide show),
287+ `slideous` (Slideous HTML and javascript slide show),
334− - `dzslides` ([DZSlides] HTML5 + JavaScript slide show),
288+ `dzslides` (DZSlides HTML5 + javascript slide show),
335− - `revealjs` ([reveal.js] HTML5 + JavaScript slide show)
289+ `revealjs` (reveal.js HTML5 + javascript slide show), `s5`
336− - `s5` ([S5] HTML and JavaScript slide show)
290+ (S5 HTML and javascript slide show), or the path of a custom
337− - `tei` ([TEI Simple])
338− - `xwiki` ([XWiki markup])
339− - `zimwiki` ([ZimWiki markup])
340− - the path of a custom Lua writer, see [Custom writers] below
291+ lua writer (see [Custom writers], below). Note that `odt`,
341− :::
342−
343− Note that `odt`, `docx`, `epub`, and `pdf` output will not be directed
292+ `epub`, and `epub3` output will not be directed to *stdout*;
344− to *stdout* unless forced with `-o -`.
293+ an output filename must be specified using the `-o/--output`
345−
294+ option. If `+lhs` is appended to `markdown`, `rst`, `latex`,
295+ `beamer`, `html`, or `html5`, the output will be rendered as
296+ literate Haskell source: see [Literate Haskell support],
346− Extensions can be individually enabled or
297+ below. Markdown syntax extensions can be individually
347− disabled by appending `+EXTENSION` or `-EXTENSION` to the format
298+ enabled or disabled by appending `+EXTENSION` or
348− name. See [Extensions] below, for a list of extensions and their
299+ `-EXTENSION` to the format name, as described above under `-f`.
349− names. See `--list-output-formats` and `--list-extensions`, below.
350
300
351`-o` *FILE*, `--output=`*FILE*
301`-o` *FILE*, `--output=`*FILE*
352
302
353: Write output to *FILE* instead of *stdout*. If *FILE* is
303: Write output to *FILE* instead of *stdout*. If *FILE* is
354− `-`, output will go to *stdout*, even if a non-textual format
304+ `-`, output will go to *stdout*. (Exception: if the output
355− (`docx`, `odt`, `epub2`, `epub3`) is specified.
305+ format is `odt`, `docx`, `epub`, or `epub3`, output to stdout is disabled.)
356
306
357`--data-dir=`*DIRECTORY*
307`--data-dir=`*DIRECTORY*
358
308
359: Specify the user data directory to search for pandoc data files.
309: Specify the user data directory to search for pandoc data files.
360 If this option is not specified, the default user data directory
310 If this option is not specified, the default user data directory
361− will be used. On \*nix and macOS systems this will be the `pandoc`
311+ will be used. This is, in Unix:
362− subdirectory of the XDG data directory (by default,
363− `$HOME/.local/share`, overridable by setting the `XDG_DATA_HOME`
364− environment variable). If that directory does not exist and
365− `$HOME/.pandoc` exists, it will be used (for backwards compatibility).
366− On Windows the default user data directory is
367− `C:\Users\USERNAME\AppData\Roaming\pandoc`.
368− You can find the default user data directory on your system by
369− looking at the output of `pandoc --version`.
370− Data files placed in this directory (for example, `reference.odt`,
371− `reference.docx`, `epub.css`, `templates`) will override
372− pandoc's normal defaults.
373−
374−`-d` *FILE*, `--defaults=`*FILE*
375−
376−: Specify a set of default option settings. *FILE* is a YAML
377− file whose fields correspond to command-line option
378− settings. All options for document conversion, including input
379− and output files, can be set using a defaults file. The file will
380− be searched for first in the working directory, and then in
381− the `defaults` subdirectory of the user data directory
382− (see `--data-dir`). The `.yaml` extension may be omitted.
383− See the section [Default files] for more information on the
384− file format. Settings from the defaults file may be
385− overridden or extended by subsequent options on the command
386− line.
387−
388−`--bash-completion`
389−
390−: Generate a bash completion script. To enable bash completion
391− with pandoc, add this to your `.bashrc`:
392−
393− eval "$(pandoc --bash-completion)"
394−
395−`--verbose`
396
312
397−: Give verbose debugging output.
313+ $HOME/.pandoc
398
314
399−`--quiet`
315+ in Windows XP:
400
316
401−: Suppress warning messages.
317+ C:\Documents And Settings\USERNAME\Application Data\pandoc
402
318
403−`--fail-if-warnings`
319+ and in Windows Vista or later:
404
320
405−: Exit with error status if there are any warnings.
321+ C:\Users\USERNAME\AppData\Roaming\pandoc
406
322
407−`--log=`*FILE*
323+ You can find the default user data directory on your system by
324+ looking at the output of `pandoc --version`.
325+ A `reference.odt`, `reference.docx`, `epub.css`, `templates`,
326+ `slidy`, `slideous`, or `s5` directory
327+ placed in this directory will override pandoc's normal defaults.
408
328
409−: Write log messages in machine-readable JSON format to
329+`--bash-completion`
410− *FILE*. All messages above DEBUG level will be written,
411− regardless of verbosity settings (`--verbose`, `--quiet`).
412
330
413−`--list-input-formats`
331+: Generate a bash completion script. To enable bash completion
332+ with pandoc, add this to your `.bashrc`:
414
333
415−: List supported input formats, one per line.
334+ eval "$(pandoc --bash-completion)"
416
335
417−`--list-output-formats`
336+`--verbose`
418
337
419−: List supported output formats, one per line.
338+: Give verbose debugging output. Currently this only has an effect
339+ with PDF output.
420
340
421−`--list-extensions`[`=`*FORMAT*]
341+`-v`, `--version`
422
342
423−: List supported extensions for *FORMAT*, one per line, preceded
343+: Print version.
424− by a `+` or `-` indicating whether it is enabled by default
425− in *FORMAT*. If *FORMAT* is not specified, defaults for
426− pandoc's Markdown are given.
427
344
428−`--list-highlight-languages`
345+`-h`, `--help`
429
346
430−: List supported languages for syntax highlighting, one per
347+: Show usage message.
431− line.
432
348
433−`--list-highlight-styles`
349+Reader options
350+--------------
434
351
435−: List supported styles for syntax highlighting, one per line.
352+`-R`, `--parse-raw`
436− See `--highlight-style`.
437
353
438−`-v`, `--version`
354+: Parse untranslatable HTML codes and LaTeX environments as raw HTML
355+ or LaTeX, instead of ignoring them. Affects only HTML and LaTeX
356+ input. Raw HTML can be printed in Markdown, reStructuredText, Emacs Org
357+ mode, HTML, Slidy, Slideous, DZSlides, reveal.js, and S5 output; raw LaTeX
358+ can be printed in Markdown, reStructuredText, Emacs Org mode, LaTeX, and
359+ ConTeXt output. The default is for the readers to omit untranslatable
360+ HTML codes and LaTeX environments. (The LaTeX reader does pass through
361+ untranslatable LaTeX *commands*, even if `-R` is not specified.)
439
362
440−: Print version.
363+`-S`, `--smart`
441
364
442−`-h`, `--help`
365+: Produce typographically correct output, converting straight quotes
366+ to curly quotes, `---` to em-dashes, `--` to en-dashes, and
367+ `...` to ellipses. Nonbreaking spaces are inserted after certain
368+ abbreviations, such as "Mr." (Note: This option is selected automatically
369+ when the output format is `latex` or `context`, unless `--no-tex-ligatures`
370+ is used. It has no effect for `latex` input.)
443
371
444−: Show usage message.
372+`--old-dashes`
445
373
446−[Markdown]: https://daringfireball.net/projects/markdown/
374+: Selects the pandoc <= 1.8.2.1 behavior for parsing smart dashes: `-` before
447−[CommonMark]: https://commonmark.org
375+ a numeral is an en-dash, and `--` is an em-dash. This option is selected
448−[PHP Markdown Extra]: https://michelf.ca/projects/php-markdown/extra/
376+ automatically for `textile` input.
449−[GitHub-Flavored Markdown]: https://help.github.com/articles/github-flavored-markdown/
450−[MultiMarkdown]: https://fletcherpenney.net/multimarkdown/
451−[reStructuredText]: https://docutils.sourceforge.io/docs/ref/rst/introduction.html
452−[S5]: https://meyerweb.com/eric/tools/s5/
453−[Slidy]: https://www.w3.org/Talks/Tools/Slidy2/
454−[Slideous]: https://goessner.net/articles/slideous/
455−[HTML]: https://www.w3.org/html/
456−[HTML5]: https://html.spec.whatwg.org/
457−[polyglot markup]: https://www.w3.org/TR/html-polyglot/
458−[XHTML]: https://www.w3.org/TR/xhtml1/
459−[LaTeX]: https://www.latex-project.org/
460−[`beamer`]: https://ctan.org/pkg/beamer
461−[Beamer User's Guide]: http://mirrors.ctan.org/macros/latex/contrib/beamer/doc/beameruserguide.pdf
462−[ConTeXt]: https://www.contextgarden.net/
463−[Rich Text Format]: https://en.wikipedia.org/wiki/Rich_Text_Format
464−[DocBook]: https://docbook.org
465−[JATS]: https://jats.nlm.nih.gov
466−[Jira]: https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all
467−[txt2tags]: https://txt2tags.org
468−[EPUB]: http://idpf.org/epub
469−[OPML]: http://dev.opml.org/spec2.html
470−[OpenDocument]: http://opendocument.xml.org
471−[ODT]: https://en.wikipedia.org/wiki/OpenDocument
472−[Textile]: https://www.promptworks.com/textile
473−[MediaWiki markup]: https://www.mediawiki.org/wiki/Help:Formatting
474−[DokuWiki markup]: https://www.dokuwiki.org/dokuwiki
475−[ZimWiki markup]: https://zim-wiki.org/manual/Help/Wiki_Syntax.html
476−[XWiki markup]: https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiSyntax/
477−[TWiki markup]: https://twiki.org/cgi-bin/view/TWiki/TextFormattingRules
478−[TikiWiki markup]: https://doc.tiki.org/Wiki-Syntax-Text#The_Markup_Language_Wiki-Syntax
479−[Haddock markup]: https://www.haskell.org/haddock/doc/html/ch03s08.html
480−[Creole 1.0]: http://www.wikicreole.org/wiki/Creole1.0
481−[CSV]: https://tools.ietf.org/html/rfc4180
482−[roff man]: https://man.cx/groff_man(7)
483−[roff ms]: https://man.cx/groff_ms(7)
484−[Haskell]: https://www.haskell.org
485−[GNU Texinfo]: https://www.gnu.org/software/texinfo/
486−[Emacs Org mode]: https://orgmode.org
487−[AsciiDoc]: https://www.methods.co.nz/asciidoc/
488−[AsciiDoctor]: https://asciidoctor.org/
489−[DZSlides]: https://paulrouget.com/dzslides/
490−[Word docx]: https://en.wikipedia.org/wiki/Office_Open_XML
491−[PDF]: https://www.adobe.com/pdf/
492−[reveal.js]: https://revealjs.com/
493−[FictionBook2]: http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1
494−[Jupyter notebook]: https://nbformat.readthedocs.io/en/latest/
495−[InDesign ICML]: https://wwwimages.adobe.com/www.adobe.com/content/dam/acom/en/devnet/indesign/sdk/cs6/idml/idml-cookbook.pdf
496−[TEI Simple]: https://github.com/TEIC/TEI-Simple
497−[Muse]: https://amusewiki.org/library/manual
498−[PowerPoint]: https://en.wikipedia.org/wiki/Microsoft_PowerPoint
499−[Vimwiki]: https://vimwiki.github.io
500−[CSL JSON]: https://citeproc-js.readthedocs.io/en/latest/csl-json/markup.html
501−[BibTeX]: https://ctan.org/pkg/bibtex
502−[BibLaTeX]: https://ctan.org/pkg/biblatex
503−
504−## Reader options {.options}
505−
506−`--shift-heading-level-by=`*NUMBER*
507−
508−: Shift heading levels by a positive or negative integer.
509− For example, with `--shift-heading-level-by=-1`, level 2
510− headings become level 1 headings, and level 3 headings
511− become level 2 headings. Headings cannot have a level
512− less than 1, so a heading that would be shifted below level 1
513− becomes a regular paragraph. Exception: with a shift of -N,
514− a level-N heading at the beginning of the document
515− replaces the metadata title. `--shift-heading-level-by=-1`
516− is a good choice when converting HTML or Markdown documents that
517− use an initial level-1 heading for the document title and
518− level-2+ headings for sections. `--shift-heading-level-by=1`
519− may be a good choice for converting Markdown documents that
520− use level-1 headings for sections to HTML, since pandoc uses
521− a level-1 heading to render the document title.
522
377
523`--base-header-level=`*NUMBER*
378`--base-header-level=`*NUMBER*
524
379
525−: *Deprecated. Use `--shift-heading-level-by`=X instead,
526− where X = NUMBER - 1.* Specify the base level for headings
380+: Specify the base level for headers (defaults to 1).
527− (defaults to 1).
528−
529−`--strip-empty-paragraphs`
530−
531−: *Deprecated. Use the `+empty_paragraphs` extension instead.*
532− Ignore paragraphs with no content. This option is useful
533− for converting word processing documents where users have
534− used empty paragraphs to create inter-paragraph space.
535
381
536`--indented-code-classes=`*CLASSES*
382`--indented-code-classes=`*CLASSES*
537
383
@@ -554,7 +400,7 @@ header when requesting a document from a URL:
554 footnotes and links will not work across files. Reading binary
400 footnotes and links will not work across files. Reading binary
555 files (docx, odt, epub) implies `--file-scope`.
401 files (docx, odt, epub) implies `--file-scope`.
556
402
557−`-F` *PROGRAM*, `--filter=`*PROGRAM*
403+`--filter=`*EXECUTABLE*
558
404
559: Specify an executable to be used as a filter transforming the
405: Specify an executable to be used as a filter transforming the
560 pandoc AST after the input is parsed and before the output is
406 pandoc AST after the input is parsed and before the output is
@@ -575,79 +421,34 @@ header when requesting a document from a URL:
575 exports `toJSONFilter` to facilitate writing filters in Haskell.
421 exports `toJSONFilter` to facilitate writing filters in Haskell.
576 Those who would prefer to write filters in python can use the
422 Those who would prefer to write filters in python can use the
577 module [`pandocfilters`], installable from PyPI. There are also
423 module [`pandocfilters`], installable from PyPI. There are also
578− pandoc filter libraries in [PHP], [perl], and
424+ pandoc filter libraries in [PHP], [perl], and [javascript/node.js].
579− [JavaScript/node.js].
580−
581− In order of preference, pandoc will look for filters in
582−
583− 1. a specified full or relative path (executable or
584− non-executable)
585−
586− 2. `$DATADIR/filters` (executable or non-executable)
587− where `$DATADIR` is the user data directory (see
588− `--data-dir`, above).
589−
590− 3. `$PATH` (executable only)
591−
592− Filters, Lua-filters, and citeproc processing are applied in
593− the order specified on the command line.
594−
595−`-L` *SCRIPT*, `--lua-filter=`*SCRIPT*
596−
597−: Transform the document in a similar fashion as JSON filters (see
598− `--filter`), but use pandoc's built-in Lua filtering system. The given
599− Lua script is expected to return a list of Lua filters which will be
600− applied in order. Each Lua filter must contain element-transforming
601− functions indexed by the name of the AST element on which the filter
602− function should be applied.
603
425
604− The `pandoc` Lua module provides helper functions for element
426+ Note that the *EXECUTABLE* will be sought in the user's
605− creation. It is always loaded into the script's Lua environment.
427+ `PATH`, and not in the working directory, if no directory is
606−
428+ provided. If you want to run a script in the working directory,
607− See the [Lua filters documentation] for further details.
429+ preface the filename with `./`.
608−
609− In order of preference, pandoc will look for Lua filters in
610−
611− 1. a specified full or relative path
612−
613− 2. `$DATADIR/filters` where `$DATADIR` is the user data
614− directory (see `--data-dir`, above).
615−
616− Filters, Lua filters, and citeproc processing are applied in
617− the order specified on the command line.
618
430
619`-M` *KEY*[`=`*VAL*], `--metadata=`*KEY*[`:`*VAL*]
431`-M` *KEY*[`=`*VAL*], `--metadata=`*KEY*[`:`*VAL*]
620
432
621: Set the metadata field *KEY* to the value *VAL*. A value specified
433: Set the metadata field *KEY* to the value *VAL*. A value specified
622− on the command line overrides a value specified in the document
434+ on the command line overrides a value specified in the document.
623− using [YAML metadata blocks][Extension: `yaml_metadata_block`].
624 Values will be parsed as YAML boolean or string values. If no value is
435 Values will be parsed as YAML boolean or string values. If no value is
625 specified, the value will be treated as Boolean true. Like
436 specified, the value will be treated as Boolean true. Like
626 `--variable`, `--metadata` causes template variables to be set.
437 `--variable`, `--metadata` causes template variables to be set.
627 But unlike `--variable`, `--metadata` affects the metadata of the
438 But unlike `--variable`, `--metadata` affects the metadata of the
628 underlying document (which is accessible from filters and may be
439 underlying document (which is accessible from filters and may be
629− printed in some output formats) and metadata values will be escaped
440+ printed in some output formats).
630− when inserted into the template.
441+
631−
442+`--normalize`
632−`--metadata-file=`*FILE*
443+
633−
444+: Normalize the document after reading: merge adjacent
634−: Read metadata from the supplied YAML (or JSON) file. This
445+ `Str` or `Emph` elements, for example, and remove repeated `Space`s.
635− option can be used with every input format, but string scalars
636− in the YAML file will always be parsed as Markdown. Generally,
637− the input will be handled the same as in [YAML metadata
638− blocks][Extension: `yaml_metadata_block`]. This option can be
639− used repeatedly to include multiple metadata files; values in
640− files specified later on the command line will be preferred
641− over those specified in earlier files. Metadata values
642− specified inside the document, or by using `-M`, overwrite
643− values specified with this option.
644
446
645`-p`, `--preserve-tabs`
447`-p`, `--preserve-tabs`
646
448
647−: Preserve tabs instead of converting them to spaces. (By default, pandoc
449+: Preserve tabs instead of converting them to spaces (the default).
648− converts tabs to spaces before parsing its input.) Note that this will
649− only affect tabs in literal code spans and code blocks. Tabs in regular
450+ Note that this will only affect tabs in literal code spans and code
650− text are always treated as spaces.
451+ blocks; tabs in regular text will be treated as spaces.
651
452
652`--tab-stop=`*NUMBER*
453`--tab-stop=`*NUMBER*
653
454
@@ -657,64 +458,42 @@ header when requesting a document from a URL:
657
458
658: Specifies what to do with insertions, deletions, and comments
459: Specifies what to do with insertions, deletions, and comments
659 produced by the MS Word "Track Changes" feature. `accept` (the
460 produced by the MS Word "Track Changes" feature. `accept` (the
660− default) processes all the insertions and deletions.
461+ default), inserts all insertions, and ignores all
462+ deletions. `reject` inserts all deletions and ignores
661− `reject` ignores them. Both `accept` and `reject` ignore comments.
463+ insertions. Both `accept` and `reject` ignore comments. `all` puts
662− `all` includes all insertions, deletions, and comments, wrapped
464+ in insertions, deletions, and comments, wrapped in spans with
663− in spans with `insertion`, `deletion`, `comment-start`, and
465+ `insertion`, `deletion`, `comment-start`, and `comment-end`
664− `comment-end` classes, respectively. The author and time of
466+ classes, respectively. The author and time of change is
665− change is included. `all` is useful for scripting: only
467+ included. `all` is useful for scripting: only accepting changes
666− accepting changes from a certain reviewer, say, or before a
468+ from a certain reviewer, say, or before a certain date. This
667− certain date. If a paragraph is inserted or deleted,
668− `track-changes=all` produces a span with the class
669− `paragraph-insertion`/`paragraph-deletion` before the
670− affected paragraph break. This option only affects the docx
469+ option only affects the docx reader.
671− reader.
672
470
673`--extract-media=`*DIR*
471`--extract-media=`*DIR*
674
472
675−: Extract images and other media contained in or linked from
473+: Extract images and other media contained in a docx or epub container
676− the source document to the path *DIR*, creating it if
677− necessary, and adjust the images references in the document
474+ to the path *DIR*, creating it if necessary, and adjust the images
678− so they point to the extracted files. Media are downloaded,
475+ references in the document so they point to the extracted files.
679− read from the file system, or extracted from a binary
476+ This option only affects the docx and epub readers.
680− container (e.g. docx), as needed. The original file paths
681− are used if they are relative paths not containing `..`.
682− Otherwise filenames are constructed from the SHA1 hash of
683− the contents.
684−
685−`--abbreviations=`*FILE*
686−
687−: Specifies a custom abbreviations file, with abbreviations
688− one to a line. If this option is not specified, pandoc will
689− read the data file `abbreviations` from the user data
690− directory or fall back on a system default. To see the
691− system default, use
692− `pandoc --print-default-data-file=abbreviations`. The only
693− use pandoc makes of this list is in the Markdown reader.
694− Strings found in this list will be followed by a nonbreaking
695− space, and the period will not produce sentence-ending space
696− in formats like LaTeX. The strings may not contain spaces.
697
477
698[`pandocfilters`]: https://github.com/jgm/pandocfilters
478[`pandocfilters`]: https://github.com/jgm/pandocfilters
699[PHP]: https://github.com/vinai/pandocfilters-php
479[PHP]: https://github.com/vinai/pandocfilters-php
700[perl]: https://metacpan.org/pod/Pandoc::Filter
480[perl]: https://metacpan.org/pod/Pandoc::Filter
701−[JavaScript/node.js]: https://github.com/mvhenderson/pandoc-filter-node
481+[javascript/node.js]: https://github.com/mvhenderson/pandoc-filter-node
702−[Lua filters documentation]: https://pandoc.org/lua-filters.html
703
482
704−## General writer options {.options}
483+General writer options
484+----------------------
705
485
706`-s`, `--standalone`
486`-s`, `--standalone`
707
487
708: Produce output with an appropriate header and footer (e.g. a
488: Produce output with an appropriate header and footer (e.g. a
709 standalone HTML, LaTeX, TEI, or RTF file, not a fragment). This option
489 standalone HTML, LaTeX, TEI, or RTF file, not a fragment). This option
710 is set automatically for `pdf`, `epub`, `epub3`, `fb2`, `docx`, and `odt`
490 is set automatically for `pdf`, `epub`, `epub3`, `fb2`, `docx`, and `odt`
711− output. For `native` output, this option causes metadata to
491+ output.
712− be included; otherwise, metadata is suppressed.
713
492
714−`--template=`*FILE*|*URL*
493+`--template=`*FILE*
715
494
716−: Use the specified file as a custom template for the generated document.
495+: Use *FILE* as a custom template for the generated document. Implies
717− Implies `--standalone`. See [Templates], below, for a description
496+ `--standalone`. See [Templates], below, for a description
718 of template syntax. If no extension is specified, an extension
497 of template syntax. If no extension is specified, an extension
719 corresponding to the writer will be added, so that `--template=special`
498 corresponding to the writer will be added, so that `--template=special`
720 looks for `special.html` for HTML output. If the template is not
499 looks for `special.html` for HTML output. If the template is not
@@ -726,59 +505,42 @@ header when requesting a document from a URL:
726`-V` *KEY*[`=`*VAL*], `--variable=`*KEY*[`:`*VAL*]
505`-V` *KEY*[`=`*VAL*], `--variable=`*KEY*[`:`*VAL*]
727
506
728: Set the template variable *KEY* to the value *VAL* when rendering the
507: Set the template variable *KEY* to the value *VAL* when rendering the
729− document in standalone mode. If no *VAL* is specified, the
508+ document in standalone mode. This is generally only useful when the
509+ `--template` option is used to specify a custom template, since
510+ pandoc automatically sets the variables used in the default
511+ templates. If no *VAL* is specified, the key will be given the
730− key will be given the value `true`.
512+ value `true`.
731
513
732`-D` *FORMAT*, `--print-default-template=`*FORMAT*
514`-D` *FORMAT*, `--print-default-template=`*FORMAT*
733
515
734: Print the system default template for an output *FORMAT*. (See `-t`
516: Print the system default template for an output *FORMAT*. (See `-t`
735 for a list of possible *FORMAT*s.) Templates in the user data
517 for a list of possible *FORMAT*s.) Templates in the user data
736− directory are ignored. This option may be used with
518+ directory are ignored.
737− `-o`/`--output` to redirect output to a file, but
738− `-o`/`--output` must come before `--print-default-template`
739− on the command line.
740−
741− Note that some of the default templates use partials, for
742− example `styles.html`. To print the partials, use
743− `--print-default-data-file`: for example,
744− `--print-default-data-file=templates/styles.html`.
745
519
746`--print-default-data-file=`*FILE*
520`--print-default-data-file=`*FILE*
747
521
748: Print a system default data file. Files in the user data directory
522: Print a system default data file. Files in the user data directory
749− are ignored. This option may be used with `-o`/`--output` to
523+ are ignored.
750− redirect output to a file, but `-o`/`--output` must come before
751− `--print-default-data-file` on the command line.
752−
753−`--eol=crlf`|`lf`|`native`
754−
755−: Manually specify line endings: `crlf` (Windows), `lf`
756− (macOS/Linux/UNIX), or `native` (line endings appropriate
757− to the OS on which pandoc is being run). The default is
758− `native`.
759
524
760`--dpi`=*NUMBER*
525`--dpi`=*NUMBER*
526+: Specify the dpi (dots per inch) value for conversion from pixels
527+ to inch/centimeters and vice versa. The default is 96dpi.
528+ Technically, the correct term would be ppi (pixels per inch).
761
529
762−: Specify the default dpi (dots per inch) value for conversion
763− from pixels to inch/centimeters and vice versa. (Technically,
764− the correct term would be ppi: pixels per inch.) The default
765− is 96dpi. When images contain information about dpi
766− internally, the encoded value is used instead of the default
767− specified by this option.
768−
769−`--wrap=auto`|`none`|`preserve`
530+`--wrap=[auto|none|preserve]`
770
531
771: Determine how text is wrapped in the output (the source
532: Determine how text is wrapped in the output (the source
772 code, not the rendered version). With `auto` (the default),
533 code, not the rendered version). With `auto` (the default),
773 pandoc will attempt to wrap lines to the column width specified by
534 pandoc will attempt to wrap lines to the column width specified by
774− `--columns` (default 72). With `none`, pandoc will not wrap
535+ `--columns` (default 80). With `none`, pandoc will not wrap
775 lines at all. With `preserve`, pandoc will attempt to
536 lines at all. With `preserve`, pandoc will attempt to
776 preserve the wrapping from the source document (that is,
537 preserve the wrapping from the source document (that is,
777 where there are nonsemantic newlines in the source, there
538 where there are nonsemantic newlines in the source, there
778 will be nonsemantic newlines in the output as well).
539 will be nonsemantic newlines in the output as well).
779− Automatic wrapping does not currently work in HTML output.
540+
780− In `ipynb` output, this option affects wrapping of the
541+`--no-wrap`
781− contents of markdown cells.
542+
543+: Deprecated synonym for `--wrap=none`.
782
544
783`--columns=`*NUMBER*
545`--columns=`*NUMBER*
784
546
@@ -789,81 +551,37 @@ header when requesting a document from a URL:
789`--toc`, `--table-of-contents`
551`--toc`, `--table-of-contents`
790
552
791: Include an automatically generated table of contents (or, in
553: Include an automatically generated table of contents (or, in
792− the case of `latex`, `context`, `docx`, `odt`,
554+ the case of `latex`, `context`, `docx`, and `rst`, an instruction to create
793− `opendocument`, `rst`, or `ms`, an instruction to create
794− one) in the output document. This option has no effect
555+ one) in the output document. This option has no effect on `man`,
795− unless `-s/--standalone` is used, and it has no effect
556+ `docbook`, `docbook5`, `slidy`, `slideous`, `s5`, or `odt` output.
796− on `man`, `docbook4`, `docbook5`, or `jats` output.
797−
798− Note that if you are producing a PDF via `ms`, the table
799− of contents will appear at the beginning of the
800− document, before the title. If you would prefer it to
801− be at the end of the document, use the option
802− `--pdf-engine-opt=--no-toc-relocation`.
803
557
804`--toc-depth=`*NUMBER*
558`--toc-depth=`*NUMBER*
805
559
806: Specify the number of section levels to include in the table
560: Specify the number of section levels to include in the table
807− of contents. The default is 3 (which means that level-1, 2, and 3
561+ of contents. The default is 3 (which means that level 1, 2, and 3
808− headings will be listed in the contents).
562+ headers will be listed in the contents).
809−
810−`--strip-comments`
811−
812−: Strip out HTML comments in the Markdown or Textile source,
813− rather than passing them on to Markdown, Textile or HTML
814− output as raw HTML. This does not apply to HTML comments
815− inside raw HTML blocks when the `markdown_in_html_blocks`
816− extension is not set.
817
563
818`--no-highlight`
564`--no-highlight`
819
565
820: Disables syntax highlighting for code blocks and inlines, even when
566: Disables syntax highlighting for code blocks and inlines, even when
821 a language attribute is given.
567 a language attribute is given.
822
568
823−`--highlight-style=`*STYLE*|*FILE*
569+`--highlight-style=`*STYLE*
824
570
825: Specifies the coloring style to be used in highlighted source code.
571: Specifies the coloring style to be used in highlighted source code.
826 Options are `pygments` (the default), `kate`, `monochrome`,
572 Options are `pygments` (the default), `kate`, `monochrome`,
827− `breezeDark`, `espresso`, `zenburn`, `haddock`, and `tango`.
573+ `espresso`, `zenburn`, `haddock`, and `tango`. For more information
828− For more information on syntax highlighting in pandoc, see
574+ on syntax highlighting in pandoc, see [Syntax highlighting], below.
829− [Syntax highlighting], below. See also
830− `--list-highlight-styles`.
831−
832− Instead of a *STYLE* name, a JSON file with extension
833− `.theme` may be supplied. This will be parsed as a KDE
834− syntax highlighting theme and (if valid) used as the
835− highlighting style.
836
575
837− To generate the JSON version of an existing style,
838− use `--print-highlight-style`.
839−
840−`--print-highlight-style=`*STYLE*|*FILE*
841−
842−: Prints a JSON version of a highlighting style, which can
843− be modified, saved with a `.theme` extension, and used
844− with `--highlight-style`. This option may be used with
845− `-o`/`--output` to redirect output to a file, but
846− `-o`/`--output` must come before `--print-highlight-style`
847− on the command line.
848−
849−`--syntax-definition=`*FILE*
850−
851−: Instructs pandoc to load a KDE XML syntax definition file,
852− which will be used for syntax highlighting of appropriately
853− marked code blocks. This can be used to add support for
854− new languages or to use altered syntax definitions for
855− existing languages. This option may be repeated to add
856− multiple syntax definitions.
857−
858−`-H` *FILE*, `--include-in-header=`*FILE*|*URL*
576+`-H` *FILE*, `--include-in-header=`*FILE*
859
577
860: Include contents of *FILE*, verbatim, at the end of the header.
578: Include contents of *FILE*, verbatim, at the end of the header.
861 This can be used, for example, to include special
579 This can be used, for example, to include special
862− CSS or JavaScript in HTML documents. This option can be used
580+ CSS or javascript in HTML documents. This option can be used
863 repeatedly to include multiple files in the header. They will be
581 repeatedly to include multiple files in the header. They will be
864 included in the order specified. Implies `--standalone`.
582 included in the order specified. Implies `--standalone`.
865
583
866−`-B` *FILE*, `--include-before-body=`*FILE*|*URL*
584+`-B` *FILE*, `--include-before-body=`*FILE*
867
585
868: Include contents of *FILE*, verbatim, at the beginning of the
586: Include contents of *FILE*, verbatim, at the beginning of the
869 document body (e.g. after the `<body>` tag in HTML, or the
587 document body (e.g. after the `<body>` tag in HTML, or the
@@ -872,7 +590,7 @@ header when requesting a document from a URL:
872 used repeatedly to include multiple files. They will be included in
590 used repeatedly to include multiple files. They will be included in
873 the order specified. Implies `--standalone`.
591 the order specified. Implies `--standalone`.
874
592
875−`-A` *FILE*, `--include-after-body=`*FILE*|*URL*
593+`-A` *FILE*, `--include-after-body=`*FILE*
876
594
877: Include contents of *FILE*, verbatim, at the end of the document
595: Include contents of *FILE*, verbatim, at the end of the document
878 body (before the `</body>` tag in HTML, or the
596 body (before the `</body>` tag in HTML, or the
@@ -880,121 +598,59 @@ header when requesting a document from a URL:
880 repeatedly to include multiple files. They will be included in the
598 repeatedly to include multiple files. They will be included in the
881 order specified. Implies `--standalone`.
599 order specified. Implies `--standalone`.
882
600
883−`--resource-path=`*SEARCHPATH*
884−
885−: List of paths to search for images and other resources.
886− The paths should be separated by `:` on Linux, UNIX, and
887− macOS systems, and by `;` on Windows. If `--resource-path`
888− is not specified, the default resource path is the working
889− directory. Note that, if `--resource-path` is specified,
890− the working directory must be explicitly listed or it
891− will not be searched. For example:
892− `--resource-path=.:test` will search the working directory
893− and the `test` subdirectory, in that order.
894− This option can be used repeatedly. Search path components
895− that come later on the command line will be searched before
896− those that come earlier, so
897− `--resource-path foo:bar --resource-path baz:bim` is
898− equivalent to `--resource-path baz:bim:foo:bar`.
899−
900−`--request-header=`*NAME*`:`*VAL*
901−
902−: Set the request header *NAME* to the value *VAL* when making
903− HTTP requests (for example, when a URL is given on the
904− command line, or when resources used in a document must be
905− downloaded). If you're behind a proxy, you also need to set
906− the environment variable `http_proxy` to `http://...`.
907−
908−`--no-check-certificate`
909−
910−: Disable the certificate verification to allow access to
911− unsecure HTTP resources (for example when the certificate
912− is no longer valid or self signed).
913−
914−## Options affecting specific writers {.options}
601+Options affecting specific writers
602+----------------------------------
915
603
916`--self-contained`
604`--self-contained`
917
605
918: Produce a standalone HTML file with no external dependencies, using
606: Produce a standalone HTML file with no external dependencies, using
919 `data:` URIs to incorporate the contents of linked scripts, stylesheets,
607 `data:` URIs to incorporate the contents of linked scripts, stylesheets,
920− images, and videos. Implies `--standalone`. The resulting file should be
608+ images, and videos. The resulting file should be "self-contained,"
921− "self-contained," in the sense that it needs no external files and no net
609+ in the sense that it needs no external files and no net access to be
922− access to be displayed properly by a browser. This option works only with
610+ displayed properly by a browser. This option works only with HTML output
923− HTML output formats, including `html4`, `html5`, `html+lhs`, `html5+lhs`,
611+ formats, including `html`, `html5`, `html+lhs`, `html5+lhs`, `s5`,
924− `s5`, `slidy`, `slideous`, `dzslides`, and `revealjs`. Scripts, images,
612+ `slidy`, `slideous`, `dzslides`, and `revealjs`. Scripts, images, and
925− and stylesheets at absolute URLs will be downloaded; those at relative
613+ stylesheets at absolute URLs will be downloaded; those at relative URLs
926− URLs will be sought relative to the working directory (if the first source
614+ will be sought relative to the working directory (if the first source
927 file is local) or relative to the base URL (if the first source
615 file is local) or relative to the base URL (if the first source
928− file is remote). Elements with the attribute
929− `data-external="1"` will be left alone; the documents they
930− link to will not be incorporated in the document.
931− Limitation: resources that are loaded dynamically through
616+ file is remote). Limitation: resources that are loaded dynamically
932− JavaScript cannot be incorporated; as a result,
617+ through JavaScript cannot be incorporated; as a result, `--self-contained`
933− `--self-contained` does not work with `--mathjax`, and some
618+ does not work with `--mathjax`, and some advanced features (e.g.
934− advanced features (e.g. zoom or speaker notes) may not work
619+ zoom or speaker notes) may not work in an offline "self-contained"
935− in an offline "self-contained" `reveal.js` slide show.
620+ `reveal.js` slide show.
936
621
937`--html-q-tags`
622`--html-q-tags`
938
623
939−: Use `<q>` tags for quotes in HTML. (This option only has an
624+: Use `<q>` tags for quotes in HTML.
940− effect if the `smart` extension is enabled for the input
941− format used.)
942
625
943`--ascii`
626`--ascii`
944
627
945−: Use only ASCII characters in output. Currently supported for XML
628+: Use only ascii characters in output. Currently supported only
946− and HTML formats (which use entities instead of UTF-8 when this
629+ for HTML output (which uses numerical entities instead of
947− option is selected), CommonMark, gfm, and Markdown (which use
630+ UTF-8 when this option is selected).
948− entities), roff ms (which use hexadecimal escapes), and to a
949− limited degree LaTeX (which uses standard commands for accented
950− characters when possible). roff man output uses ASCII by default.
951
631
952`--reference-links`
632`--reference-links`
953
633
954: Use reference-style links, rather than inline links, in writing Markdown
634: Use reference-style links, rather than inline links, in writing Markdown
955− or reStructuredText. By default inline links are used. The
635+ or reStructuredText. By default inline links are used.
956− placement of link references is affected by the
957− `--reference-location` option.
958−
959−`--reference-location=block`|`section`|`document`
960−
961−: Specify whether footnotes (and references, if `reference-links` is
962− set) are placed at the end of the current (top-level) block, the
963− current section, or the document. The default is
964− `document`. Currently only affects the markdown writer.
965−
966−`--markdown-headings=setext`|`atx`
967−
968−: Specify whether to use ATX-style (`#`-prefixed) or
969− Setext-style (underlined) headings for level 1 and 2
970− headings in Markdown output. (The default is `atx`.)
971− ATX-style headings are always used for levels 3+.
972− This option also affects Markdown cells in `ipynb` output.
973
636
974`--atx-headers`
637`--atx-headers`
975
638
976−: *Deprecated synonym for `--markdown-headings=atx`.*
639+: Use ATX-style headers in Markdown and asciidoc output. The default is
640+ to use setext-style headers for levels 1-2, and then ATX headers.
977
641
978−`--top-level-division=default`|`section`|`chapter`|`part`
642+`--chapters`
979
643
980−: Treat top-level headings as the given division type in
644+: Treat top-level headers as chapters in LaTeX, ConTeXt, and DocBook
981− LaTeX, ConTeXt, DocBook, and TEI output. The hierarchy
645+ output. When the LaTeX document class is set to `report`, `book`,
982− order is part, chapter, then section; all headings are
983− shifted such that the top-level heading becomes the
984− specified type. The default behavior is to determine the
985− best division type via heuristics: unless other conditions
986− apply, `section` is chosen. When the `documentclass`
987− variable is set to `report`, `book`, or `memoir` (unless the
988− `article` option is specified), `chapter` is implied as the
646+ or `memoir` (unless the `article` option is specified), this
989− setting for this option. If `beamer` is the output format,
647+ option is implied. If `beamer` is the output format, top-level
990− specifying either `chapter` or `part` will cause top-level
648+ headers will become `\part{..}`.
991− headings to become `\part{..}`, while second-level headings
992− remain as their default type.
993
649
994`-N`, `--number-sections`
650`-N`, `--number-sections`
995
651
996−: Number section headings in LaTeX, ConTeXt, HTML, Docx, ms, or EPUB
652+: Number section headings in LaTeX, ConTeXt, HTML, or EPUB output.
997− output. By default, sections are not numbered. Sections with class
653+ By default, sections are not numbered. Sections with class
998 `unnumbered` will never be numbered, even if `--number-sections`
654 `unnumbered` will never be numbered, even if `--number-sections`
999 is specified.
655 is specified.
1000
656
@@ -1002,19 +658,32 @@ header when requesting a document from a URL:
1002
658
1003: Offset for section headings in HTML output (ignored in other
659: Offset for section headings in HTML output (ignored in other
1004 output formats). The first number is added to the section number for
660 output formats). The first number is added to the section number for
1005− top-level headings, the second for second-level headings, and so on.
661+ top-level headers, the second for second-level headers, and so on.
1006− So, for example, if you want the first top-level heading in your
662+ So, for example, if you want the first top-level header in your
1007 document to be numbered "6", specify `--number-offset=5`.
663 document to be numbered "6", specify `--number-offset=5`.
1008− If your document starts with a level-2 heading which you want to
664+ If your document starts with a level-2 header which you want to
1009 be numbered "1.5", specify `--number-offset=1,4`.
665 be numbered "1.5", specify `--number-offset=1,4`.
1010 Offsets are 0 by default. Implies `--number-sections`.
666 Offsets are 0 by default. Implies `--number-sections`.
1011
667
668+`--no-tex-ligatures`
669+
670+: Do not use the TeX ligatures for quotation marks, apostrophes,
671+ and dashes (`` `...' ``, ` ``..'' `, `--`, `---`) when
672+ writing or reading LaTeX or ConTeXt. In reading LaTeX,
673+ parse the characters `` ` ``, `'`, and `-` literally, rather
674+ than parsing ligatures for quotation marks and dashes. In
675+ writing LaTeX or ConTeXt, print unicode quotation mark and
676+ dash characters literally, rather than converting them to
677+ the standard ASCII TeX ligatures. Note: normally `--smart`
678+ is selected automatically for LaTeX and ConTeXt output, but
679+ it must be specified explicitly if `--no-tex-ligatures` is
680+ selected. If you use literal curly quotes, dashes, and
681+ ellipses in your source, then you may want to use
682+ `--no-tex-ligatures` without `--smart`.
683+
1012`--listings`
684`--listings`
1013
685
1014−: Use the [`listings`] package for LaTeX code blocks. The package
686+: Use the [`listings`] package for LaTeX code blocks
1015− does not support multi-byte encoding for source code. To handle UTF-8
1016− you would need to use a custom template. This issue is fully
1017− documented here: [Encoding issue with the listings package].
1018
687
1019`-i`, `--incremental`
688`-i`, `--incremental`
1020
689
@@ -1023,165 +692,85 @@ header when requesting a document from a URL:
1023
692
1024`--slide-level=`*NUMBER*
693`--slide-level=`*NUMBER*
1025
694
1026−: Specifies that headings with the specified level create
695+: Specifies that headers with the specified level create
1027− slides (for `beamer`, `s5`, `slidy`, `slideous`, `dzslides`). Headings
696+ slides (for `beamer`, `s5`, `slidy`, `slideous`, `dzslides`). Headers
1028 above this level in the hierarchy are used to divide the
697 above this level in the hierarchy are used to divide the
1029− slide show into sections; headings below this level create
698+ slide show into sections; headers below this level create
1030− subheads within a slide. Note that content that is
1031− not contained under slide-level headings will not appear in
1032− the slide show. The default is to set the slide level based
699+ subheads within a slide. The default is to set the slide level
1033− on the contents of the document; see [Structuring the slide
700+ based on the contents of the document; see
1034− show].
701+ [Structuring the slide show].
1035
702
1036`--section-divs`
703`--section-divs`
1037
704
1038−: Wrap sections in `<section>` tags (or `<div>` tags for `html4`),
705+: Wrap sections in `<div>` tags (or `<section>` tags in HTML5),
1039− and attach identifiers to the enclosing `<section>` (or `<div>`)
706+ and attach identifiers to the enclosing `<div>` (or `<section>`)
1040− rather than the heading itself. See
707+ rather than the header itself. See
1041− [Heading identifiers], below.
708+ [Header identifiers], below.
1042
709
1043`--email-obfuscation=none`|`javascript`|`references`
710`--email-obfuscation=none`|`javascript`|`references`
1044
711
1045: Specify a method for obfuscating `mailto:` links in HTML documents.
712: Specify a method for obfuscating `mailto:` links in HTML documents.
1046 `none` leaves `mailto:` links as they are. `javascript` obfuscates
713 `none` leaves `mailto:` links as they are. `javascript` obfuscates
1047− them using JavaScript. `references` obfuscates them by printing their
714+ them using javascript. `references` obfuscates them by printing their
1048 letters as decimal or hexadecimal character references. The default
715 letters as decimal or hexadecimal character references. The default
1049 is `none`.
716 is `none`.
1050
717
1051`--id-prefix=`*STRING*
718`--id-prefix=`*STRING*
1052
719
1053−: Specify a prefix to be added to all identifiers and internal links
720+: Specify a prefix to be added to all automatically generated identifiers
1054− in HTML and DocBook output, and to footnote numbers in Markdown
721+ in HTML and DocBook output, and to footnote numbers in Markdown output.
1055− and Haddock output. This is useful for preventing duplicate
722+ This is useful for preventing duplicate identifiers when generating
1056− identifiers when generating fragments to be included in other pages.
723+ fragments to be included in other pages.
1057
724
1058`-T` *STRING*, `--title-prefix=`*STRING*
725`-T` *STRING*, `--title-prefix=`*STRING*
1059
726
1060: Specify *STRING* as a prefix at the beginning of the title
727: Specify *STRING* as a prefix at the beginning of the title
1061 that appears in the HTML header (but not in the title as it
728 that appears in the HTML header (but not in the title as it
1062− appears at the beginning of the HTML body). Implies `--standalone`.
729+ appears at the beginning of the HTML body). Implies
730+ `--standalone`.
1063
731
1064`-c` *URL*, `--css=`*URL*
732`-c` *URL*, `--css=`*URL*
1065
733
1066: Link to a CSS style sheet. This option can be used repeatedly to
734: Link to a CSS style sheet. This option can be used repeatedly to
1067 include multiple files. They will be included in the order specified.
735 include multiple files. They will be included in the order specified.
1068
736
1069− A stylesheet is required for generating EPUB. If none is
737+`--reference-odt=`*FILE*
1070− provided using this option (or the `css` or `stylesheet`
738+
739+: Use the specified file as a style reference in producing an ODT.
740+ For best results, the reference ODT should be a modified version
741+ of an ODT produced using pandoc. The contents of the reference ODT
742+ are ignored, but its stylesheets are used in the new ODT. If no
743+ reference ODT is specified on the command line, pandoc will look
744+ for a file `reference.odt` in the user data directory (see
745+ `--data-dir`). If this is not found either, sensible defaults will be
746+ used.
747+
748+`--reference-docx=`*FILE*
749+
750+: Use the specified file as a style reference in producing a docx file.
751+ For best results, the reference docx should be a modified version
752+ of a docx file produced using pandoc. The contents of the reference docx
753+ are ignored, but its stylesheets and document properties (including
754+ margins, page size, header, and footer) are used in the new docx. If no
755+ reference docx is specified on the command line, pandoc will look
756+ for a file `reference.docx` in the user data directory (see
757+ `--data-dir`). If this is not found either, sensible defaults will be
758+ used. The following styles are used by pandoc: [paragraph]
759+ Normal, Body Text, First Paragraph, Compact, Title, Subtitle, Author, Date,
760+ Abstract, Bibliography, Heading 1, Heading 2, Heading 3, Heading 4,
761+ Heading 5, Heading 6, Block Text, Footnote Text, Definition Term,
762+ Definition, Caption, Table Caption, Image Caption, Figure,
763+ Figure With Caption, TOC Heading;
764+ [character] Default Paragraph Font, Body Text Char, Verbatim Char,
765+ Footnote Reference, Hyperlink; [table] Normal Table.
766+
767+`--epub-stylesheet=`*FILE*
768+
769+: Use the specified CSS file to style the EPUB. If no stylesheet
1071− metadata fields), pandoc will look for a file `epub.css` in the
770+ is specified, pandoc will look for a file `epub.css` in the
1072 user data directory (see `--data-dir`). If it is not
771 user data directory (see `--data-dir`). If it is not
1073 found there, sensible defaults will be used.
772 found there, sensible defaults will be used.
1074
773
1075−`--reference-doc=`*FILE*
1076−
1077−: Use the specified file as a style reference in producing a
1078− docx or ODT file.
1079−
1080− Docx
1081−
1082− : For best results, the reference docx should be a modified
1083− version of a docx file produced using pandoc. The contents
1084− of the reference docx are ignored, but its stylesheets and
1085− document properties (including margins, page size, header,
1086− and footer) are used in the new docx. If no reference docx
1087− is specified on the command line, pandoc will look for a
1088− file `reference.docx` in the user data directory (see
1089− `--data-dir`). If this is not found either, sensible
1090− defaults will be used.
1091−
1092− To produce a custom `reference.docx`, first get a copy of
1093− the default `reference.docx`: `pandoc
1094− -o custom-reference.docx --print-default-data-file reference.docx`.
1095− Then open `custom-reference.docx` in Word, modify the
1096− styles as you wish, and save the file. For best
1097− results, do not make changes to this file other than
1098− modifying the styles used by pandoc:
1099−
1100− Paragraph styles:
1101−
1102− - Normal
1103− - Body Text
1104− - First Paragraph
1105− - Compact
1106− - Title
1107− - Subtitle
1108− - Author
1109− - Date
1110− - Abstract
1111− - Bibliography
1112− - Heading 1
1113− - Heading 2
1114− - Heading 3
1115− - Heading 4
1116− - Heading 5
1117− - Heading 6
1118− - Heading 7
1119− - Heading 8
1120− - Heading 9
1121− - Block Text
1122− - Footnote Text
1123− - Definition Term
1124− - Definition
1125− - Caption
1126− - Table Caption
1127− - Image Caption
1128− - Figure
1129− - Captioned Figure
1130− - TOC Heading
1131−
1132− Character styles:
1133−
1134− - Default Paragraph Font
1135− - Body Text Char
1136− - Verbatim Char
1137− - Footnote Reference
1138− - Hyperlink
1139− - Section Number
1140−
1141− Table style:
1142−
1143− - Table
1144−
1145− ODT
1146−
1147− : For best results, the reference ODT should be a modified
1148− version of an ODT produced using pandoc. The contents of
1149− the reference ODT are ignored, but its stylesheets are used
1150− in the new ODT. If no reference ODT is specified on the
1151− command line, pandoc will look for a file `reference.odt` in
1152− the user data directory (see `--data-dir`). If this is not
1153− found either, sensible defaults will be used.
1154−
1155− To produce a custom `reference.odt`, first get a copy of
1156− the default `reference.odt`: `pandoc
1157− -o custom-reference.odt --print-default-data-file reference.odt`.
1158− Then open `custom-reference.odt` in LibreOffice, modify
1159− the styles as you wish, and save the file.
1160−
1161− PowerPoint
1162−
1163− : Templates included with Microsoft PowerPoint 2013 (either with
1164− `.pptx` or `.potx` extension) are known to work, as are most
1165− templates derived from these.
1166−
1167− The specific requirement is that the template should begin with
1168− the following first four layouts:
1169−
1170− 1. Title Slide
1171− 2. Title and Content
1172− 3. Section Header
1173− 4. Two Content
1174−
1175− All templates included with a recent version of MS PowerPoint
1176− will fit these criteria. (You can click on `Layout` under the
1177− `Home` menu to check.)
1178−
1179− You can also modify the default `reference.pptx`: first run
1180− `pandoc -o custom-reference.pptx --print-default-data-file
1181− reference.pptx`, and then modify `custom-reference.pptx`
1182− in MS PowerPoint (pandoc will use the first four layout
1183− slides, as mentioned above).
1184−
1185`--epub-cover-image=`*FILE*
774`--epub-cover-image=`*FILE*
1186
775
1187: Use the specified image as the EPUB cover. It is recommended
776: Use the specified image as the EPUB cover. It is recommended
@@ -1218,7 +807,7 @@ header when requesting a document from a URL:
1218 line, be sure to escape them or put the whole filename in single quotes,
807 line, be sure to escape them or put the whole filename in single quotes,
1219 to prevent them from being interpreted by the shell. To use the
808 to prevent them from being interpreted by the shell. To use the
1220 embedded fonts, you will need to add declarations like the following
809 embedded fonts, you will need to add declarations like the following
1221− to your CSS (see `--css`):
810+ to your CSS (see `--epub-stylesheet`):
1222
811
1223 @font-face {
812 @font-face {
1224 font-family: DejaVuSans;
813 font-family: DejaVuSans;
@@ -1248,186 +837,146 @@ header when requesting a document from a URL:
1248
837
1249`--epub-chapter-level=`*NUMBER*
838`--epub-chapter-level=`*NUMBER*
1250
839
1251−: Specify the heading level at which to split the EPUB into separate
840+: Specify the header level at which to split the EPUB into separate
1252− "chapter" files. The default is to split into chapters at level-1
841+ "chapter" files. The default is to split into chapters at level 1
1253− headings. This option only affects the internal composition of the
842+ headers. This option only affects the internal composition of the
1254 EPUB, not the way chapters and sections are displayed to users. Some
843 EPUB, not the way chapters and sections are displayed to users. Some
1255 readers may be slow if the chapter files are too large, so for large
844 readers may be slow if the chapter files are too large, so for large
1256− documents with few level-1 headings, one might want to use a chapter
845+ documents with few level 1 headers, one might want to use a chapter
1257 level of 2 or 3.
846 level of 2 or 3.
1258
847
1259−`--epub-subdirectory=`*DIRNAME*
848+`--latex-engine=pdflatex`|`lualatex`|`xelatex`
1260−
849+
1261−: Specify the subdirectory in the OCF container that is to hold
1262− the EPUB-specific contents. The default is `EPUB`. To put
1263− the EPUB contents in the top level, use an empty string.
1264−
1265−`--ipynb-output=all|none|best`
1266−
1267−: Determines how ipynb output cells are treated. `all` means
1268− that all of the data formats included in the original are
1269− preserved. `none` means that the contents of data cells
1270− are omitted. `best` causes pandoc to try to pick the
1271− richest data block in each output cell that is compatible
1272− with the output format. The default is `best`.
1273−
1274−`--pdf-engine=`*PROGRAM*
1275−
1276−: Use the specified engine when producing PDF output.
850+: Use the specified LaTeX engine when producing PDF output.
1277− Valid values are `pdflatex`, `lualatex`, `xelatex`, `latexmk`,
1278− `tectonic`, `wkhtmltopdf`, `weasyprint`, `prince`, `context`,
1279− and `pdfroff`. If the engine is not in your PATH, the full
851+ The default is `pdflatex`. If the engine is not in your PATH,
1280− path of the engine may be specified here. If this option
852+ the full path of the engine may be specified here.
1281− is not specified, pandoc uses the following defaults
853+
1282− depending on the output format specified using `-t/--to`:
1283−
1284− - `-t latex` or none: `pdflatex` (other options: `xelatex`, `lualatex`,
1285− `tectonic`, `latexmk`)
1286− - `-t context`: `context`
1287− - `-t html`: `wkhtmltopdf` (other options: `prince`, `weasyprint`;
1288− see [print-css.rocks](https://print-css.rocks) for a good
1289− introduction to PDF generation from HTML/CSS.)
1290− - `-t ms`: `pdfroff`
1291−
1292−`--pdf-engine-opt=`*STRING*
854+`--latex-engine-opt=`*STRING*
1293−
855+
1294−: Use the given string as a command-line argument to the `pdf-engine`.
856+: Use the given string as a command-line argument to the `latex-engine`.
1295− For example, to use a persistent directory `foo` for `latexmk`'s
857+ If used multiple times, the arguments are provided with spaces between
1296− auxiliary files, use `--pdf-engine-opt=-outdir=foo`.
1297− Note that no check for duplicate options is done.
858+ them. Note that no check for duplicate options is done.
1298−
859+
1299−[Dublin Core elements]: https://www.dublincore.org/specifications/dublin-core/dces/
860+[Dublin Core elements]: http://dublincore.org/documents/dces/
1300−[ISO 8601 format]: https://www.w3.org/TR/NOTE-datetime
861+[ISO 8601 format]: http://www.w3.org/TR/NOTE-datetime
1301−[Encoding issue with the listings package]:
862+
1302− https://en.wikibooks.org/wiki/LaTeX/Source_Code_Listings#Encoding_issue
1303−
1304−## Citation rendering {.options}
863+Citation rendering
1305−
864+------------------
1306−`-C`, `--citeproc`
1307−
1308−: Process the citations in the file, replacing them with
1309− rendered citations and adding a bibliography.
1310− Citation processing will not take place unless bibliographic
1311− data is supplied, either through an external file specified
1312− using the `--bibliography` option or the `bibliography`
1313− field in metadata, or via a `references` section in metadata
1314− containing a list of citations in CSL YAML format with
1315− Markdown formatting. The style is controlled by a [CSL]
1316− stylesheet specified using the `--csl` option or the `csl`
1317− field in metadata. (If no stylesheet is specified,
1318− the `chicago-author-date` style will be used by default.)
1319− The citation processing transformation may be applied before
1320− or after filters or Lua filters (see `--filter`,
1321− `--lua-filter`): these transformations are applied in the
1322− order they appear on the command line. For more
1323− information, see the section on [Citations].
1324
865
1325`--bibliography=`*FILE*
866`--bibliography=`*FILE*
1326
867
1327: Set the `bibliography` field in the document's metadata to *FILE*,
868: Set the `bibliography` field in the document's metadata to *FILE*,
1328− overriding any value set in the metadata. If you supply
869+ overriding any value set in the metadata, and process citations
870+ using `pandoc-citeproc`. (This is equivalent to
871+ `--metadata bibliography=FILE --filter pandoc-citeproc`.)
872+ If `--natbib` or `--biblatex` is also supplied, `pandoc-citeproc` is not
873+ used, making this equivalent to `--metadata bibliography=FILE`.
1329− this argument multiple times, each *FILE* will be added to
874+ If you supply this argument multiple times, each *FILE* will be added
1330− bibliography. If *FILE* is a URL, it will be fetched
875+ to bibliography.
1331− via HTTP. If *FILE* is not found relative to the
1332− working directory, it will be sought in the resource path
1333− (see `--resource-path`).
1334
876
1335`--csl=`*FILE*
877`--csl=`*FILE*
1336
878
1337: Set the `csl` field in the document's metadata to *FILE*,
879: Set the `csl` field in the document's metadata to *FILE*,
1338 overriding any value set in the metadata. (This is equivalent to
880 overriding any value set in the metadata. (This is equivalent to
1339− `--metadata csl=FILE`.) If *FILE* is a URL, it will be
881+ `--metadata csl=FILE`.)
1340− fetched via HTTP. If *FILE* is not found relative to the
882+ This option is only relevant with `pandoc-citeproc`.
1341− working directory, it will be sought in the resource path
1342− (see `--resource-path`) and finally in the `csl`
1343− subdirectory of the pandoc user data directory.
1344
883
1345`--citation-abbreviations=`*FILE*
884`--citation-abbreviations=`*FILE*
1346
885
1347: Set the `citation-abbreviations` field in the document's metadata to
886: Set the `citation-abbreviations` field in the document's metadata to
1348 *FILE*, overriding any value set in the metadata. (This is equivalent to
887 *FILE*, overriding any value set in the metadata. (This is equivalent to
1349 `--metadata citation-abbreviations=FILE`.)
888 `--metadata citation-abbreviations=FILE`.)
1350− If *FILE* is a URL, it will be fetched via HTTP. If *FILE* is not
889+ This option is only relevant with `pandoc-citeproc`.
1351− found relative to the working directory, it will be sought
1352− in the resource path (see `--resource-path`) and finally in
1353− the `csl` subdirectory of the pandoc user data directory.
1354
890
1355`--natbib`
891`--natbib`
1356
892
1357−: Use [`natbib`] for citations in LaTeX output. This option
893+: Use [`natbib`] for citations in LaTeX output. This option is not for use
1358− is not for use with the `--citeproc` option or with PDF
894+ with the `pandoc-citeproc` filter or with PDF output. It is intended for
1359− output. It is intended for use in producing a LaTeX file
1360− that can be processed with [`bibtex`].
895+ use in producing a LaTeX file that can be processed with [`bibtex`].
1361
896
1362`--biblatex`
897`--biblatex`
1363
898
1364−: Use [`biblatex`] for citations in LaTeX output. This option
899+: Use [`biblatex`] for citations in LaTeX output. This option is not for use
1365− is not for use with the `--citeproc` option or with PDF
900+ with the `pandoc-citeproc` filter or with PDF output. It is intended for
1366− output. It is intended for use in producing a LaTeX file
1367− that can be processed with [`bibtex`] or [`biber`].
901+ use in producing a LaTeX file that can be processed with [`bibtex`] or [`biber`].
902+
903+Math rendering in HTML
904+----------------------
905+
906+`-m` [*URL*], `--latexmathml`[`=`*URL*]
1368
907
1369−## Math rendering in HTML {.options}
908+: Use the [LaTeXMathML] script to display embedded TeX math in HTML output.
909+ To insert a link to a local copy of the `LaTeXMathML.js` script,
910+ provide a *URL*. If no *URL* is provided, the contents of the
911+ script will be inserted directly into the HTML header, preserving
912+ portability at the price of efficiency. If you plan to use math on
913+ several pages, it is much better to link to a copy of the script,
914+ so it can be cached.
1370
915
1371−The default is to render TeX math as far as possible using
916+`--mathml`[`=`*URL*]
1372−Unicode characters. Formulas are put inside a `span` with
917+
1373−`class="math"`, so that they may be styled differently from the
918+: Convert TeX math to [MathML] (in `docbook`, `docbook5`, `html` and `html5`).
1374−surrounding text if needed. However, this gives acceptable
919+ In standalone `html` output, a small javascript (or a link to such a
1375−results only for basic math, usually you will want to use
920+ script if a *URL* is supplied) will be inserted that allows the MathML to
1376−`--mathjax` or another of the following options.
921+ be viewed on some browsers.
922+
923+`--jsmath`[`=`*URL*]
924+
925+: Use [jsMath] to display embedded TeX math in HTML output.
926+ The *URL* should point to the jsMath load script (e.g.
927+ `jsMath/easy/load.js`); if provided, it will be linked to in
928+ the header of standalone HTML documents. If a *URL* is not provided,
929+ no link to the jsMath load script will be inserted; it is then
930+ up to the author to provide such a link in the HTML template.
1377
931
1378`--mathjax`[`=`*URL*]
932`--mathjax`[`=`*URL*]
1379
933
1380: Use [MathJax] to display embedded TeX math in HTML output.
934: Use [MathJax] to display embedded TeX math in HTML output.
1381− TeX math will be put between `\(...\)` (for inline math)
1382− or `\[...\]` (for display math) and wrapped in `<span>` tags
1383− with class `math`. Then the MathJax JavaScript will render it.
1384 The *URL* should point to the `MathJax.js` load script.
935 The *URL* should point to the `MathJax.js` load script.
1385− If a *URL* is not provided, a link to the Cloudflare CDN will
936+ If a *URL* is not provided, a link to the MathJax CDN will
1386 be inserted.
937 be inserted.
1387
938
1388−`--mathml`
939+`--gladtex`
940+
941+: Enclose TeX math in `<eq>` tags in HTML output. These can then
942+ be processed by [gladTeX] to produce links to images of the typeset
943+ formulas.
944+
945+`--mimetex`[`=`*URL*]
1389
946
1390−: Convert TeX math to [MathML] (in `epub3`, `docbook4`,
947+: Render TeX math using the [mimeTeX] CGI script. If *URL* is not
1391− `docbook5`, `jats`, `html4` and `html5`). This is the
948+ specified, it is assumed that the script is at `/cgi-bin/mimetex.cgi`.
1392− default in `odt` output. Note that currently only Firefox
1393− and Safari (and select e-book readers) natively support
1394− MathML.
1395
949
1396`--webtex`[`=`*URL*]
950`--webtex`[`=`*URL*]
1397
951
1398−: Convert TeX formulas to `<img>` tags that link to an external script
952+: Render TeX formulas using an external script that converts TeX
1399− that converts formulas to images. The formula will be URL-encoded
953+ formulas to images. The formula will be concatenated with the URL
1400− and concatenated with the URL provided. For SVG images you can for
954+ provided. If *URL* is not specified, the Google Chart API will be used.
1401− example use `--webtex https://latex.codecogs.com/svg.latex?`.
1402− If no URL is specified, the CodeCogs URL generating PNGs
1403− will be used (`https://latex.codecogs.com/png.latex?`).
1404 Note: the `--webtex` option will affect Markdown output
955 Note: the `--webtex` option will affect Markdown output
1405− as well as HTML, which is useful if you're targeting a
956+ as well as HTML.
1406− version of Markdown without native math support.
1407
957
1408`--katex`[`=`*URL*]
958`--katex`[`=`*URL*]
1409
959
1410: Use [KaTeX] to display embedded TeX math in HTML output.
960: Use [KaTeX] to display embedded TeX math in HTML output.
1411− The *URL* is the base URL for the KaTeX library. That directory
961+ The *URL* should point to the `katex.js` load script. If a *URL* is
1412− should contain a `katex.min.js` and a `katex.min.css` file.
1413− If a *URL* is not provided, a link to the KaTeX CDN will be inserted.
962+ not provided, a link to the KaTeX CDN will be inserted.
1414−
1415−`--gladtex`
1416
963
1417−: Enclose TeX math in `<eq>` tags in HTML output. The resulting HTML
964+`--katex-stylesheet=`*URL*
1418− can then be processed by [GladTeX] to produce SVG images of the typeset
1419− formulas and an HTML file with these images embedded.
1420
965
1421− pandoc -s --gladtex input.md -o myfile.htex
966+: The *URL* should point to the `katex.css` stylesheet. If this option is
1422− gladtex -d image_dir myfile.htex
967+ not specified, a link to the KaTeX CDN will be inserted. Note that this
1423− # produces myfile.html and images in image_dir
968+ option does not imply `--katex`.
1424
969
1425−[MathML]: https://www.w3.org/Math/
970+[MathML]: http://www.w3.org/Math/
971+[LaTeXMathML]: http://math.etsu.edu/LaTeXMathML/
972+[jsMath]: http://www.math.union.edu/~dpvc/jsmath/
1426[MathJax]: https://www.mathjax.org
973[MathJax]: https://www.mathjax.org
974+[gladTeX]: http://ans.hsh.no/home/mgg/gladtex/
975+[mimeTeX]: http://www.forkosh.com/mimetex.html
1427[KaTeX]: https://github.com/Khan/KaTeX
976[KaTeX]: https://github.com/Khan/KaTeX
1428−[GladTeX]: https://humenda.github.io/GladTeX/
1429
977
1430−## Options for wrapper scripts {.options}
978+Options for wrapper scripts
979+---------------------------
1431
980
1432`--dump-args`
981`--dump-args`
1433
982
@@ -1451,277 +1000,8 @@ results only for basic math, usually you will want to use
1451
1000
1452 pandoc -o foo.html -s
1001 pandoc -o foo.html -s
1453
1002
1454−# Exit codes
1455−
1456−If pandoc completes successfully, it will return exit code 0.
1457−Nonzero exit codes have the following meanings:
1458−
1459− Code Error
1460−----- ------------------------------------
1461− 3 PandocFailOnWarningError
1462− 4 PandocAppError
1463− 5 PandocTemplateError
1464− 6 PandocOptionError
1465− 21 PandocUnknownReaderError
1466− 22 PandocUnknownWriterError
1467− 23 PandocUnsupportedExtensionError
1468− 24 PandocCiteprocError
1469− 31 PandocEpubSubdirectoryError
1470− 43 PandocPDFError
1471− 44 PandocXMLError
1472− 47 PandocPDFProgramNotFoundError
1473− 61 PandocHttpError
1474− 62 PandocShouldNeverHappenError
1475− 63 PandocSomeError
1476− 64 PandocParseError
1477− 65 PandocParsecError
1478− 66 PandocMakePDFError
1479− 67 PandocSyntaxMapError
1480− 83 PandocFilterError
1481− 91 PandocMacroLoop
1482− 92 PandocUTF8DecodingError
1483− 93 PandocIpynbDecodingError
1484− 94 PandocUnsupportedCharsetError
1485− 97 PandocCouldNotFindDataFileError
1486− 99 PandocResourceNotFound
1487−----- ------------------------------------
1488−
1489−# Default files
1490−
1491−The `--defaults` option may be used to specify a package
1492−of options. Here is a sample defaults file demonstrating all of
1493−the fields that may be used:
1494−
1495−``` yaml
1496−from: markdown+emoji
1497−# reader: may be used instead of from:
1498−to: html5
1499−# writer: may be used instead of to:
1500−
1501−# leave blank for output to stdout:
1502−output-file:
1503−# leave blank for input from stdin, use [] for no input:
1504−input-files:
1505−- preface.md
1506−- content.md
1507−# or you may use input-file: with a single value
1508−
1509−# Include options from the specified defaults files.
1510−# The files will be searched for first in the working directory
1511−# and then in the defaults subdirectory of the user data directory.
1512−# The files are included in the same order in which they appear in
1513−# the list. Options specified in this defaults file always have
1514−# priority over the included ones.
1515−defaults:
1516−- defsA
1517−- defsB
1518−
1519−template: letter
1520−standalone: true
1521−self-contained: false
1522−
1523−# note that structured variables may be specified:
1524−variables:
1525− documentclass: book
1526− classoption:
1527− - twosides
1528− - draft
1529−
1530−# metadata values specified here are parsed as literal
1531−# string text, not markdown:
1532−metadata:
1533− author:
1534− - Sam Smith
1535− - Julie Liu
1536−metadata-files:
1537−- boilerplate.yaml
1538−# or you may use metadata-file: with a single value
1539−
1540−# Note that these take files, not their contents:
1541−include-before-body: []
1542−include-after-body: []
1543−include-in-header: []
1544−resource-path: ["."]
1545−
1546−# turn on built-in citation processing. Note that if you need
1547−# control over when the citeproc processing is done relative
1548−# to other filters, you should instead use `citeproc` in the
1549−# list of `filters` (see below).
1550−citeproc: true
1551−csl: ieee
1552−bibliography:
1553−- foobar.bib
1554−- barbaz.json
1555−citation-abbreviations: abbrevs.json
1556−
1557−# Filters will be assumed to be Lua filters if they have
1558−# the .lua extension, and json filters otherwise. But
1559−# the filter type can also be specified explicitly, as shown.
1560−# Filters are run in the order specified.
1561−# To include the built-in citeproc filter, use either `citeproc`
1562−# or `{type: citeproc}`.
1563−filters:
1564−- wordcount.lua
1565−- type: json
1566− path: foo.lua
1567−
1568−file-scope: false
1569−
1570−data-dir:
1571−
1572−# ERROR, WARNING, or INFO
1573−verbosity: INFO
1574−log-file: log.json
1575−
1576−# citeproc, natbib, or biblatex. This only affects LaTeX
1577−# output. If you want to use citeproc to format citations,
1578−# you should also set 'citeproc: true' (see above).
1579−cite-method: citeproc
1580−
1581−# part, chapter, section, or default:
1582−top-level-division: chapter
1583−abbreviations:
1584−
1585−pdf-engine: pdflatex
1586−pdf-engine-opts:
1587−- "-shell-escape"
1588−# you may also use pdf-engine-opt: with a single option
1589−# pdf-engine-opt: "-shell-escape"
1590−
1591−# auto, preserve, or none
1592−wrap: auto
1593−columns: 78
1594−dpi: 72
1595−
1596−extract-media: mediadir
1597−
1598−table-of-contents: true
1599−toc-depth: 2
1600−number-sections: false
1601−# a list of offsets at each heading level
1602−number-offset: [0,0,0,0,0,0]
1603−# toc: may also be used instead of table-of-contents:
1604−shift-heading-level-by: 1
1605−section-divs: true
1606−identifier-prefix: foo
1607−title-prefix: ""
1608−strip-empty-paragraphs: true
1609−# lf, crlf, or native
1610−eol: lf
1611−strip-comments: false
1612−indented-code-classes: []
1613−ascii: true
1614−default-image-extension: ".jpg"
1615−
1616−# either a style name of a style definition file:
1617−highlight-style: pygments
1618−syntax-definitions:
1619−- c.xml
1620−# or you may use syntax-definition: with a single value
1621−listings: false
1622−
1623−reference-doc: myref.docx
1624−
1625−# method is plain, webtex, gladtex, mathml, mathjax, katex
1626−# you may specify a url with webtex, mathjax, katex
1627−html-math-method:
1628− method: mathjax
1629− url: "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"
1630−# none, references, or javascript
1631−email-obfuscation: javascript
1632−
1633−tab-stop: 8
1634−preserve-tabs: true
1635−
1636−incremental: false
1637−slide-level: 2
1638−
1639−epub-subdirectory: EPUB
1640−epub-metadata: meta.xml
1641−epub-fonts:
1642−- foobar.otf
1643−epub-chapter-level: 1
1644−epub-cover-image: cover.jpg
1645−
1646−reference-links: true
1647−# block, section, or document
1648−reference-location: block
1649−markdown-headings: setext
1650−
1651−# accept, reject, or all
1652−track-changes: accept
1653−
1654−html-q-tags: false
1655−css:
1656−- site.css
1657−
1658−# none, all, or best
1659−ipynb-output: best
1660−
1661−# A list of two-element lists
1662−request-headers:
1663−- ["User-Agent", "Mozilla/5.0"]
1664−
1665−fail-if-warnings: false
1666−dump-args: false
1667−ignore-args: false
1668−trace: false
1669−```
1670−
1671−Fields that are omitted will just have their regular
1672−default values. So a defaults file can be as simple as
1673−one line:
1674−
1675−``` yaml
1676−verbosity: INFO
1677−```
1678−
1679−In fields that expect a file path (or list of file paths), the
1680−following syntax may be used to interpolate environment variables:
1681−
1682−``` yaml
1683−csl: ${HOME}/mycsldir/special.csl
1684−```
1685−
1686−`${USERDATA}` may also be used; this will always resolve to the
1687−user data directory that is current when the defaults file is
1688−parsed, regardless of the setting of the environment
1689−variable `USERDATA`.
1690−
1691−`${.}` will resolve to the directory containing the default
1692−file itself. This allows you to refer to resources contained
1693−in that directory:
1694−
1695−``` yaml
1696−epub-cover-image: ${.}/cover.jpg
1697−epub-metadata: ${.}/meta.xml
1698−resource-path:
1699−- . # the working directory from which pandoc is run
1700−- ${.}/images # the images subdirectory of the directory
1701− # containing this defaults file
1702−```
1703−
1704−This environment variable interpolation syntax *only* works in
1705−fields that expect file paths.
1706−
1707−Default files can be placed in the `defaults` subdirectory of
1708−the user data directory and used from any directory. For
1709−example, one could create a file specifying defaults for writing
1710−letters, save it as `letter.yaml` in the `defaults` subdirectory
1711−of the user data directory, and then invoke these defaults
1712−from any directory using `pandoc --defaults letter`
1713−or `pandoc -dletter`.
1714−
1715−When multiple defaults are used, their contents will be combined.
1716−
1717−Note that, where command-line arguments may be repeated
1718−(`--metadata-file`, `--css`, `--include-in-header`,
1719−`--include-before-body`, `--include-after-body`, `--variable`,
1720−`--metadata`, `--syntax-definition`), the values specified on
1721−the command line will combine with values specified in the
1722−defaults file, rather than replacing them.
1723−
1724−# Templates
1003+Templates
1004+=========
1725
1005
1726When the `-s/--standalone` option is used, pandoc uses a template to
1006When the `-s/--standalone` option is used, pandoc uses a template to
1727add header and footer material that is needed for a self-standing
1007add header and footer material that is needed for a self-standing
@@ -1738,1430 +1018,427 @@ directory (see `--data-dir`, above). *Exceptions:*
1738- For `odt` output, customize the `default.opendocument`
1018- For `odt` output, customize the `default.opendocument`
1739 template.
1019 template.
1740- For `pdf` output, customize the `default.latex` template
1020- For `pdf` output, customize the `default.latex` template
1741− (or the `default.context` template, if you use `-t context`,
1021+ (or the `default.beamer` template, if you use `-t beamer`,
1742− or the `default.ms` template, if you use `-t ms`, or the
1022+ or the `default.context` template, if you use `-t context`).
1743− `default.html` template, if you use `-t html`).
1744−- `docx` and `pptx` have no template (however, you can use
1023+- `docx` has no template (however, you can use
1745− `--reference-doc` to customize the output).
1024+ `--reference-docx` to customize the output).
1746
1025
1747Templates contain *variables*, which allow for the inclusion of
1026Templates contain *variables*, which allow for the inclusion of
1748−arbitrary information at any point in the file. They may be set at the
1027+arbitrary information at any point in the file. Variables may be set
1749−command line using the `-V/--variable` option. If a variable is not set,
1750−pandoc will look for the key in the document's metadata, which can be set
1751−using either [YAML metadata blocks][Extension: `yaml_metadata_block`]
1028+within the document using [YAML metadata blocks][Extension:
1752−or with the `-M/--metadata` option. In addition, some variables
1029+`yaml_metadata_block`]. They may also be set at the
1753−are given default values by pandoc. See [Variables] below for
1030+command line using the `-V/--variable` option: variables set in this
1754−a list of variables used in pandoc's default templates.
1031+way override metadata fields with the same name.
1755−
1756−If you use custom templates, you may need to revise them as pandoc
1757−changes. We recommend tracking the changes in the default templates,
1758−and modifying your custom templates accordingly. An easy way to do this
1759−is to fork the [pandoc-templates] repository and merge in
1760−changes after each pandoc release.
1761
1032
1762− [pandoc-templates]: https://github.com/jgm/pandoc-templates
1033+Variables set by pandoc
1034+-----------------------
1763
1035
1764−## Template syntax
1036+Some variables are set automatically by pandoc. These vary somewhat
1037+depending on the output format, but include metadata fields as well
1038+as the following:
1765
1039
1766−### Comments
1040+`title`, `author`, `date`
1041+: allow identification of basic aspects of the document. Included
1042+ in PDF metadata through LaTeX and ConTeXt. These can be set
1043+ through a [pandoc title block][Extension: `pandoc_title_block`],
1044+ which allows for multiple authors, or through a YAML metadata block:
1767
1045
1768−Anything between the sequence `$--` and the end of the
1046+ ---
1769−line will be treated as a comment and omitted from the output.
1047+ author:
1048+ - Aristotle
1049+ - Peter Abelard
1050+ ...
1770
1051
1771−### Delimiters
1052+`subtitle`
1053+: document subtitle, included in HTML, EPUB, LaTeX, ConTeXt, and Word docx;
1054+ renders in LaTeX only when using a document class that supports
1055+ `\subtitle`, such as `beamer` or the [KOMA-Script] series (`scrartcl`,
1056+ `scrreprt`, `scrbook`).[^subtitle]
1772
1057
1773−To mark variables and control structures in the template,
1058+`institute`
1774−either `$`...`$` or `${`...`}` may be used as delimiters.
1059+: author affiliations (in LaTeX and Beamer only). Can be a
1775−The styles may also be mixed in the same template, but the
1060+ list, when there are multiple authors.
1776−opening and closing delimiter must match in each case. The
1777−opening delimiter may be followed by one or more spaces
1778−or tabs, which will be ignored. The closing delimiter may
1779−be followed by one or more spaces or tabs, which will be
1780−ignored.
1781
1061
1782−To include a literal `$` in the document, use `$$`.
1062+`abstract`
1063+: document summary, included in LaTeX, ConTeXt, AsciiDoc, and Word docx
1783
1064
1784−### Interpolated variables
1065+`keywords`
1066+: list of keywords to be included in HTML, PDF, and AsciiDoc metadata;
1067+ may be repeated as for `author`, above
1785
1068
1786−A slot for an interpolated variable is a variable name surrounded
1069+`header-includes`
1787−by matched delimiters. Variable names must begin with a letter
1070+: contents specified by `-H/--include-in-header` (may have multiple
1788−and can contain letters, numbers, `_`, `-`, and `.`. The
1071+ values)
1789−keywords `it`, `if`, `else`, `endif`, `for`, `sep`, and `endfor` may
1790−not be used as variable names. Examples:
1791
1072
1792−```
1073+`toc`
1793−$foo$
1074+: non-null value if `--toc/--table-of-contents` was specified
1794−$foo.bar.baz$
1795−$foo_bar.baz-bim$
1796−$ foo $
1797−${foo}
1798−${foo.bar.baz}
1799−${foo_bar.baz-bim}
1800−${ foo }
1801−```
1802
1075
1803−Variable names with periods are used to get at structured
1076+`toc-title`
1804−variable values. So, for example, `employee.salary` will return the
1077+: title of table of contents (works only with EPUB and docx)
1805−value of the `salary` field of the object that is the value of
1806−the `employee` field.
1807
1078
1808−- If the value of the variable is simple value, it will be
1079+`include-before`
1809− rendered verbatim. (Note that no escaping is done;
1080+: contents specified by `-B/--include-before-body` (may have
1810− the assumption is that the calling program will escape
1081+ multiple values)
1811− the strings appropriately for the output format.)
1812−- If the value is a list, the values will be concatenated.
1813−- If the value is a map, the string `true` will be rendered.
1814−- Every other value will be rendered as the empty string.
1815
1082
1816−### Conditionals
1083+`include-after`
1084+: contents specified by `-A/--include-after-body` (may have
1085+ multiple values)
1817
1086
1818−A conditional begins with `if(variable)` (enclosed in
1087+`body`
1819−matched delimiters) and ends with `endif` (enclosed in matched
1088+: body of document
1820−delimiters). It may optionally contain an `else` (enclosed in
1821−matched delimiters). The `if` section is used if
1822−`variable` has a non-empty value, otherwise the `else`
1823−section is used (if present). Examples:
1824
1089
1825−```
1090+`meta-json`
1826−$if(foo)$bar$endif$
1091+: JSON representation of all of the document's metadata
1827
1092
1828−$if(foo)$
1093+[^subtitle]: To make `subtitle` work with other LaTeX
1829− $foo$
1094+ document classes, you can add the following to `header-includes`:
1830−$endif$
1831
1095
1832−$if(foo)$
1096+ \providecommand{\subtitle}[1]{%
1833−part one
1097+ \usepackage{titling}
1834−$else$
1098+ \posttitle{%
1835−part two
1099+ \par\large#1\end{center}}
1836−$endif$
1100+ }
1837
1101
1838−${if(foo)}bar${endif}
1102+Language variables
1103+------------------
1839
1104
1840−${if(foo)}
1105+`lang`
1841− ${foo}
1106+: identifies the main language of the document,
1842−${endif}
1107+ using a code according to [BCP 47] (e.g. `en` or `en-GB`).
1108+ For some output formats, pandoc will convert it to an appropriate
1109+ format stored in the additional variables `babel-lang`,
1110+ `polyglossia-lang` (LaTeX) and `context-lang` (ConTeXt).
1111+
1112+ Native pandoc `span`s and `div`s with the lang attribute
1113+ (value in BCP 47) can be used to switch the language in
1114+ that range.
1115+
1116+`otherlangs`
1117+: a list of other languages used in the document
1118+ in the YAML metadata, according to [BCP 47]. For example:
1119+ `otherlangs: [en-GB, fr]`.
1120+ This is automatically generated from the `lang` attributes
1121+ in all `span`s and `div`s but can be overridden.
1122+ Currently only used by LaTeX through the generated
1123+ `babel-otherlangs` and `polyglossia-otherlangs` variables.
1124+ The LaTeX writer outputs polyglossia commands in the text but
1125+ the `babel-newcommands` variable contains mappings for them
1126+ to the corresponding babel.
1843
1127
1844−${if(foo)}
1128+`dir`
1845−${ foo.bar }
1129+: the base direction of the document, either `rtl` (right-to-left)
1846−${else}
1130+ or `ltr` (left-to-right).
1847−no foo!
1848−${endif}
1849−```
1850
1131
1851−The keyword `elseif` may be used to simplify complex nested
1132+ For bidirectional documents, native pandoc `span`s and `div`s
1852−conditionals:
1133+ with the `dir` attribute (value `rtl` or `ltr`) can be used to
1134+ override the base direction in some output formats.
1135+ This may not always be necessary if the final renderer
1136+ (e.g. the browser, when generating HTML) supports the
1137+ [Unicode Bidirectional Algorithm].
1853
1138
1854−```
1139+ When using LaTeX for bidirectional documents, only the `xelatex` engine
1855−$if(foo)$
1140+ is fully supported (use `--latex-engine=xelatex`).
1856−XXX
1857−$elseif(bar)$
1858−YYY
1859−$else$
1860−ZZZ
1861−$endif$
1862−```
1863
1141
1864−### For loops
1142+[BCP 47]: https://tools.ietf.org/html/bcp47
1143+[Unicode Bidirectional Algorithm]: http://www.w3.org/International/articles/inline-bidi-markup/uba-basics
1865
1144
1866−A for loop begins with `for(variable)` (enclosed in
1145+Variables for slides
1867−matched delimiters) and ends with `endfor` (enclosed in matched
1146+--------------------
1868−delimiters.
1869
1147
1870−- If `variable` is an array, the material inside the loop will
1148+Variables are available for [producing slide shows with pandoc],
1871− be evaluated repeatedly, with `variable` being set to each
1149+including all [reveal.js configuration options].
1872− value of the array in turn, and concatenated.
1873−- If `variable` is a map, the material inside will be set to
1874− the map.
1875−- If the value of the associated variable is not an array or
1876− a map, a single iteration will be performed on its value.
1877
1150
1878−Examples:
1151+`slidy-url`
1152+: base URL for Slidy documents (defaults to
1153+ `http://www.w3.org/Talks/Tools/Slidy2`)
1879
1154
1880−```
1155+`slideous-url`
1881−$for(foo)$$foo$$sep$, $endfor$
1156+: base URL for Slideous documents (defaults to `slideous`)
1882
1157
1883−$for(foo)$
1158+`s5-url`
1884− - $foo.last$, $foo.first$
1159+: base URL for S5 documents (defaults to `s5/default`)
1885−$endfor$
1886
1160
1887−${ for(foo.bar) }
1161+`revealjs-url`
1888− - ${ foo.bar.last }, ${ foo.bar.first }
1162+: base URL for reveal.js documents (defaults to `reveal.js`)
1889−${ endfor }
1890
1163
1891−$for(mymap)$
1164+`theme`, `colortheme`, `fonttheme`, `innertheme`, `outertheme`
1892−$it.name$: $it.office$
1165+: themes for LaTeX [`beamer`] documents
1893−$endfor$
1894−```
1895
1166
1896−You may optionally specify a separator between consecutive
1167+`themeoptions`
1897−values using `sep` (enclosed in matched delimiters). The
1168+: options for LaTeX beamer themes (a list).
1898−material between `sep` and the `endfor` is the separator.
1899
1169
1900−```
1170+`navigation`
1901−${ for(foo) }${ foo }${ sep }, ${ endfor }
1171+: controls navigation symbols in `beamer` documents
1902−```
1172+ (default is `empty` for no navigation symbols; other valid values
1173+ are `frame`, `vertical`, and `horizontal`).
1903
1174
1904−Instead of using `variable` inside the loop, the special
1175+`section-titles`
1905−anaphoric keyword `it` may be used.
1176+: enables on "title pages" for new sections in `beamer`
1177+ documents (default = true).
1906
1178
1907−```
1179+`beamerarticle`
1908−${ for(foo.bar) }
1180+: when true, the `beamerarticle` package is loaded (for
1909− - ${ it.last }, ${ it.first }
1181+ producing an article from beamer slides).
1910−${ endfor }
1911−```
1912
1182
1913−### Partials
1183+[reveal.js configuration options]: https://github.com/hakimel/reveal.js#configuration
1914
1184
1915−Partials (subtemplates stored in different files) may be
1185+Variables for LaTeX
1916−included by using the name of the partial, followed
1186+-------------------
1917−by `()`, for example:
1918
1187
1919−```
1188+LaTeX variables are used when [creating a PDF].
1920−${ styles() }
1921−```
1922
1189
1923−Partials will be sought in the directory containing
1190+`papersize`
1924−the main template. The file name will be assumed to
1191+: paper size, e.g. `letter`, `A4`
1925−have the same extension as the main template if it
1926−lacks an extension. When calling the partial, the
1927−full name including file extension can also be used:
1928
1192
1929−```
1193+`fontsize`
1930−${ styles.html() }
1194+: font size for body text (e.g. `10pt`, `12pt`)
1931−```
1932
1195
1933−(If a partial is not found in the directory of the
1196+`documentclass`
1934−template and the template path is given as a relative
1197+: document class, e.g. [`article`], [`report`], [`book`], [`memoir`]
1935−path, it will also be sought in the `templates`
1936−subdirectory of the user data directory.)
1937
1198
1938−Partials may optionally be applied to variables using
1199+`classoption`
1939−a colon:
1200+: option for document class, e.g. `oneside`; may be repeated
1201+ for multiple options
1940
1202
1941−```
1203+`geometry`
1942−${ date:fancy() }
1204+: option for [`geometry`] package, e.g. `margin=1in`;
1205+ may be repeated for multiple options
1943
1206
1944−${ articles:bibentry() }
1207+`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
1945−```
1208+: sets margins, if `geometry` is not used (otherwise `geometry`
1209+ overrides these)
1946
1210
1947−If `articles` is an array, this will iterate over its
1211+`linestretch`
1948−values, applying the partial `bibentry()` to each one. So the
1212+: adjusts line spacing using the [`setspace`]
1949−second example above is equivalent to
1213+ package, e.g. `1.25`, `1.5`
1950
1214
1951−```
1215+`fontfamily`
1952−${ for(articles) }
1216+: font package for use with `pdflatex`:
1953−${ it:bibentry() }
1217+ [TeX Live] includes many options, documented in the [LaTeX Font Catalogue].
1954−${ endfor }
1218+ The default is [Latin Modern][`lm`].
1955−```
1956−
1957−Note that the anaphoric keyword `it` must be used when
1958−iterating over partials. In the above examples,
1959−the `bibentry` partial should contain `it.title`
1960−(and so on) instead of `articles.title`.
1961−
1962−Final newlines are omitted from included partials.
1963−
1964−Partials may include other partials.
1965−
1966−A separator between values of an array may be specified
1967−in square brackets, immediately after the variable name
1968−or partial:
1969−
1970−```
1971−${months[, ]}$
1972−
1973−${articles:bibentry()[; ]$
1974−```
1975−
1976−The separator in this case is literal and (unlike with `sep`
1977−in an explicit `for` loop) cannot contain interpolated
1978−variables or other template directives.
1979−
1980−### Nesting
1981−
1982−To ensure that content is "nested," that is, subsequent lines
1983−indented, use the `^` directive:
1984−
1985−```
1986−$item.number$ $^$$item.description$ ($item.price$)
1987−```
1988−
1989−In this example, if `item.description` has multiple lines,
1990−they will all be indented to line up with the first line:
1991−
1992−```
1993−00123 A fine bottle of 18-year old
1994− Oban whiskey. ($148)
1995−```
1996−
1997−To nest multiple lines to the same level, align them
1998−with the `^` directive in the template. For example:
1999−
2000−```
2001−$item.number$ $^$$item.description$ ($item.price$)
2002− (Available til $item.sellby$.)
2003−```
2004−
2005−will produce
2006−
2007−```
2008−00123 A fine bottle of 18-year old
2009− Oban whiskey. ($148)
2010− (Available til March 30, 2020.)
2011−```
2012−
2013−If a variable occurs by itself on a line, preceded by whitespace
2014−and not followed by further text or directives on the same line,
2015−and the variable's value contains multiple lines, it will be
2016−nested automatically.
2017−
2018−### Breakable spaces
2019−
2020−Normally, spaces in the template itself (as opposed to values of
2021−the interpolated variables) are not breakable, but they can be
2022−made breakable in part of the template by using the `~` keyword
2023−(ended with another `~`).
2024−
2025−```
2026−$~$This long line may break if the document is rendered
2027−with a short line length.$~$
2028−```
2029−
2030−### Pipes
2031−
2032−A pipe transforms the value of a variable or partial. Pipes are
2033−specified using a slash (`/`) between the variable name (or partial)
2034−and the pipe name. Example:
2035−
2036−```
2037−$for(name)$
2038−$name/uppercase$
2039−$endfor$
2040−
2041−$for(metadata/pairs)$
2042−- $it.key$: $it.value$
2043−$endfor$
2044−
2045−$employee:name()/uppercase$
2046−```
2047−
2048−Pipes may be chained:
2049−
2050−```
2051−$for(employees/pairs)$
2052−$it.key/alpha/uppercase$. $it.name$
2053−$endfor$
2054−```
2055−
2056−Some pipes take parameters:
2057−
2058−```
2059−|----------------------|------------|
2060−$for(employee)$
2061−$it.name.first/uppercase/left 20 "| "$$it.name.salary/right 10 " | " " |"$
2062−$endfor$
2063−|----------------------|------------|
2064−```
2065−
2066−Currently the following pipes are predefined:
2067−
2068−- `pairs`: Converts a map or array to an array of maps,
2069− each with `key` and `value` fields. If the original
2070− value was an array, the `key` will be the array index,
2071− starting with 1.
2072−
2073−- `uppercase`: Converts text to uppercase.
2074−
2075−- `lowercase`: Converts text to lowercase.
2076−
2077−- `length`: Returns the length of the value: number
2078− of characters for a textual value, number of elements
2079− for a map or array.
2080−
2081−- `reverse`: Reverses a textual value or array,
2082− and has no effect on other values.
2083−
2084−- `first`: Returns the first value of an array, if
2085− applied to a non-empty array; otherwise returns
2086− the original value.
2087−
2088−- `last`: Returns the last value of an array, if
2089− applied to a non-empty array; otherwise returns
2090− the original value.
2091−
2092−- `rest`: Returns all but the first value of an array, if
2093− applied to a non-empty array; otherwise returns
2094− the original value.
2095−
2096−- `allbutlast`: Returns all but the last value of an array, if
2097− applied to a non-empty array; otherwise returns
2098− the original value.
2099−
2100−- `chomp`: Removes trailing newlines (and breakable space).
2101−
2102−- `nowrap`: Disables line wrapping on breakable spaces.
2103−
2104−- `alpha`: Converts textual values that can be
2105− read as an integer into lowercase alphabetic
2106− characters `a..z` (mod 26). This can be used to get lettered
2107− enumeration from array indices. To get uppercase
2108− letters, chain with `uppercase`.
2109−
2110−- `roman`: Converts textual values that can be
2111− read as an integer into lowercase roman numerials.
2112− This can be used to get lettered enumeration from array indices.
2113− To get uppercase roman, chain with `uppercase`.
2114−
2115−- `left n "leftborder" "rightborder"`: Renders a textual value
2116− in a block of width `n`, aligned to the left, with an optional
2117− left and right border. Has no effect on other values. This
2118− can be used to align material in tables. Widths are positive
2119− integers indicating the number of characters. Borders
2120− are strings inside double quotes; literal `"` and `\` characters
2121− must be backslash-escaped.
2122−
2123−- `right n "leftborder" "rightborder"`: Renders a textual value
2124− in a block of width `n`, aligned to the right, and has no
2125− effect on other values.
2126−
2127−- `center n "leftborder" "rightborder"`: Renders a textual
2128− value in a block of width `n`, aligned to the center, and has
2129− no effect on other values.
2130−
2131−
2132−## Variables
2133−
2134−### Metadata variables
2135−
2136−`title`, `author`, `date`
2137−: allow identification of basic aspects of the document. Included
2138− in PDF metadata through LaTeX and ConTeXt. These can be set
2139− through a [pandoc title block][Extension: `pandoc_title_block`],
2140− which allows for multiple authors, or through a
2141− [YAML metadata block][Extension: `yaml_metadata_block`]:
2142−
2143− ---
2144− author:
2145− - Aristotle
2146− - Peter Abelard
2147− ...
2148−
2149− Note that if you just want to set PDF or HTML metadata, without
2150− including a title block in the document itself, you can
2151− set the `title-meta`, `author-meta`, and `date-meta`
2152− variables. (By default these are set automatically, based
2153− on `title`, `author`, and `date`.) The page title in HTML
2154− is set by `pagetitle`, which is equal to `title` by default.
2155−
2156−`subtitle`
2157−: document subtitle, included in HTML, EPUB, LaTeX, ConTeXt, and docx
2158− documents
2159−
2160−`abstract`
2161−: document summary, included in LaTeX, ConTeXt, AsciiDoc, and docx
2162− documents
2163−
2164−`keywords`
2165−: list of keywords to be included in HTML, PDF, ODT, pptx, docx
2166− and AsciiDoc metadata; repeat as for `author`, above
2167−
2168−`subject`
2169−: document subject, included in ODT, PDF, docx and pptx metadata
2170−
2171−`description`
2172−: document description, included in ODT, docx and pptx metadata. Some
2173− applications show this as `Comments` metadata.
2174−
2175−`category`
2176−: document category, included in docx and pptx metadata
2177−
2178−Additionally,
2179−any root-level string metadata, not included in ODT, docx
2180−or pptx metadata is added as a *custom property*.
2181−The following [YAML] metadata block for instance:
2182−
2183− ---
2184− title: 'This is the title'
2185− subtitle: "This is the subtitle"
2186− author:
2187− - Author One
2188− - Author Two
2189− description: |
2190− This is a long
2191− description.
2192−
2193− It consists of two paragraphs
2194− ...
2195−
2196−will include `title`, `author` and `description` as standard document
2197−properties and `subtitle` as a custom property when converting to docx,
2198−ODT or pptx.
2199−
2200−### Language variables
2201−
2202−`lang`
2203−: identifies the main language of the document using IETF language
2204− tags (following the [BCP 47] standard), such as `en` or `en-GB`.
2205− The [Language subtag lookup] tool can look up or verify these tags.
2206− This affects most formats, and controls hyphenation in PDF output
2207− when using LaTeX (through [`babel`] and [`polyglossia`]) or ConTeXt.
2208−
2209− Use native pandoc [Divs and Spans] with the `lang` attribute to
2210− switch the language:
2211−
2212− ---
2213− lang: en-GB
2214− ...
2215−
2216− Text in the main document language (British English).
2217−
2218− ::: {lang=fr-CA}
2219− > Cette citation est écrite en français canadien.
2220− :::
2221−
2222− More text in English. ['Zitat auf Deutsch.']{lang=de}
2223−
2224−`dir`
2225−: the base script direction, either `rtl` (right-to-left)
2226− or `ltr` (left-to-right).
2227−
2228− For bidirectional documents, native pandoc `span`s and
2229− `div`s with the `dir` attribute (value `rtl` or `ltr`) can
2230− be used to override the base direction in some output
2231− formats. This may not always be necessary if the final
2232− renderer (e.g. the browser, when generating HTML) supports
2233− the [Unicode Bidirectional Algorithm].
2234−
2235− When using LaTeX for bidirectional documents, only the
2236− `xelatex` engine is fully supported (use
2237− `--pdf-engine=xelatex`).
2238−
2239−[BCP 47]: https://tools.ietf.org/html/bcp47
2240−[Unicode Bidirectional Algorithm]: https://www.w3.org/International/articles/inline-bidi-markup/uba-basics
2241−[Language subtag lookup]: https://r12a.github.io/app-subtags/
2242−
2243−### Variables for HTML
2244−
2245−`document-css`
2246−: Enables inclusion of most of the [CSS] in the `styles.html`
2247− [partial](#partials) (have a look with
2248− `pandoc --print-default-data-file=templates/styles.html`).
2249− Unless you use [`--css`](#option--css), this variable
2250− is set to `true` by default. You can disable it with
2251− e.g. `pandoc -M document-css=false`.
2252−
2253−`mainfont`
2254−: sets the CSS `font-family` property on the `html` element.
2255−
2256−`fontsize`
2257−: sets the base CSS `font-size`, which you'd usually set
2258− to e.g. `20px`, but it also accepts `pt`
2259− (12pt = 16px in most browsers).
2260−
2261−`fontcolor`
2262−: sets the CSS `color` property on the `html` element.
2263−
2264−`linkcolor`
2265−: sets the CSS `color` property on all links.
2266−
2267−`monofont`
2268−: sets the CSS `font-family` property on `code` elements.
2269−
2270−`monobackgroundcolor`
2271−: sets the CSS `background-color` property on `code` elements
2272− and adds extra padding.
2273−
2274−`linestretch`
2275−: sets the CSS `line-height` property on the `html` element,
2276− which is preferred to be unitless.
2277−
2278−`backgroundcolor`
2279−: sets the CSS `background-color` property on the `html` element.
2280−
2281−`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
2282−: sets the corresponding CSS `padding` properties on the `body` element.
2283−
2284−To override or extend some [CSS] for just one document, include for example:
2285−
2286− ---
2287− header-includes: |
2288− <style>
2289− blockquote {
2290− font-style: italic;
2291− }
2292− tr.even {
2293− background-color: #f0f0f0;
2294− }
2295− td, th {
2296− padding: 0.5em 2em 0.5em 0.5em;
2297− }
2298− tbody {
2299− border-bottom: none;
2300− }
2301− </style>
2302− ---
2303−
2304−[CSS]: https://developer.mozilla.org/en-US/docs/Learn/CSS
2305−
2306−### Variables for HTML math
2307−
2308−`classoption`
2309−: when using [KaTeX](#option--katex), you can render display
2310−math equations flush left using [YAML metadata](#layout) or with
2311−`-M classoption=fleqn`.
2312−
2313−### Variables for HTML slides
2314−
2315−These affect HTML output when [producing slide shows with pandoc].
2316−
2317−`institute`
2318−: author affiliations: can be a list when there are multiple authors
2319−
2320−`revealjs-url`
2321−: base URL for reveal.js documents (defaults to
2322− `https://unpkg.com/reveal.js@^4/`)
2323−
2324−`s5-url`
2325−: base URL for S5 documents (defaults to `s5/default`)
2326−
2327−`slidy-url`
2328−: base URL for Slidy documents (defaults to
2329− `https://www.w3.org/Talks/Tools/Slidy2`)
2330−
2331−`slideous-url`
2332−: base URL for Slideous documents (defaults to `slideous`)
2333−
2334−`title-slide-attributes`
2335−: additional attributes for the title slide of reveal.js slide shows.
2336− See [background in reveal.js and beamer] for an example.
2337−
2338−All [reveal.js configuration options] are available as variables.
2339−To turn off boolean flags that default to true in reveal.js, use `0`.
2340−
2341−[reveal.js configuration options]: https://revealjs.com/config/
2342−
2343−### Variables for Beamer slides
2344−
2345−These variables change the appearance of PDF slides using [`beamer`].
2346−
2347−`aspectratio`
2348−: slide aspect ratio (`43` for 4:3 [default], `169` for 16:9,
2349− `1610` for 16:10, `149` for 14:9, `141` for 1.41:1, `54` for 5:4,
2350− `32` for 3:2)
2351−
2352−`beamerarticle`
2353−: produce an article from Beamer slides
2354−
2355−`beameroption`
2356−: add extra beamer option with `\setbeameroption{}`
2357−
2358−`institute`
2359−: author affiliations: can be a list when there are multiple authors
2360−
2361−`logo`
2362−: logo image for slides
2363−
2364−`navigation`
2365−: controls navigation symbols (default is `empty` for no navigation
2366− symbols; other valid values are `frame`, `vertical`, and `horizontal`)
2367−
2368−`section-titles`
2369−: enables "title pages" for new sections (default is true)
2370−
2371−`theme`, `colortheme`, `fonttheme`, `innertheme`, `outertheme`
2372−: beamer themes
2373−
2374−`themeoptions`
2375−: options for LaTeX beamer themes (a list).
2376−
2377−`titlegraphic`
2378−: image for title slide
2379−
2380−### Variables for PowerPoint
2381−
2382−These variables control the visual aspects of a slide show that
2383−are not easily controlled via templates.
2384−
2385−`monofont`
2386−: font to use for code.
2387−
2388−### Variables for LaTeX
2389−
2390−Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
2391−
2392−#### Layout
2393−
2394−`block-headings`
2395−: make `\paragraph` and `\subparagraph` (fourth- and
2396− fifth-level headings, or fifth- and sixth-level with book
2397− classes) free-standing rather than run-in; requires further
2398− formatting to distinguish from `\subsubsection` (third- or
2399− fourth-level headings). Instead of using this option,
2400− [KOMA-Script] can adjust headings more extensively:
2401−
2402− ---
2403− documentclass: scrartcl
2404− header-includes: |
2405− \RedeclareSectionCommand[
2406− beforeskip=-10pt plus -2pt minus -1pt,
2407− afterskip=1sp plus -1sp minus 1sp,
2408− font=\normalfont\itshape]{paragraph}
2409− \RedeclareSectionCommand[
2410− beforeskip=-10pt plus -2pt minus -1pt,
2411− afterskip=1sp plus -1sp minus 1sp,
2412− font=\normalfont\scshape,
2413− indent=0pt]{subparagraph}
2414− ...
2415−
2416−`classoption`
2417−: option for document class, e.g. `oneside`; repeat for multiple options:
2418−
2419− ---
2420− classoption:
2421− - twocolumn
2422− - landscape
2423− ...
2424−
2425−`documentclass`
2426−: document class: usually one of the standard classes,
2427− [`article`], [`book`], and [`report`]; the [KOMA-Script]
2428− equivalents, `scrartcl`, `scrbook`, and `scrreprt`, which
2429− default to smaller margins; or [`memoir`]
2430−
2431−`geometry`
2432−: option for [`geometry`] package, e.g. `margin=1in`;
2433− repeat for multiple options:
2434−
2435− ---
2436− geometry:
2437− - top=30mm
2438− - left=20mm
2439− - heightrounded
2440− ...
2441−
2442−`hyperrefoptions`
2443−: option for [`hyperref`] package, e.g. `linktoc=all`;
2444− repeat for multiple options:
2445−
2446− ---
2447− hyperrefoptions:
2448− - linktoc=all
2449− - pdfwindowui
2450− - pdfpagemode=FullScreen
2451− ...
2452−
2453−`indent`
2454−: if true, pandoc will use document class settings for
2455− indentation (the default LaTeX template otherwise removes
2456− indentation and adds space between paragraphs)
2457−
2458−`linestretch`
2459−: adjusts line spacing using the [`setspace`]
2460− package, e.g. `1.25`, `1.5`
2461−
2462−`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
2463−: sets margins if `geometry` is not used (otherwise `geometry`
2464− overrides these)
2465−
2466−`pagestyle`
2467−: control `\pagestyle{}`: the default article class
2468− supports `plain` (default), `empty` (no running heads or page numbers),
2469− and `headings` (section titles in running heads)
2470−
2471−`papersize`
2472−: paper size, e.g. `letter`, `a4`
2473−
2474−`secnumdepth`
2475−: numbering depth for sections (with `--number-sections` option
2476− or `numbersections` variable)
2477−
2478−#### Fonts
2479−
2480−`fontenc`
2481−: allows font encoding to be specified through `fontenc` package (with
2482− `pdflatex`); default is `T1` (see [LaTeX font encodings guide])
2483−
2484−`fontfamily`
2485−: font package for use with `pdflatex`:
2486− [TeX Live] includes many options, documented in the [LaTeX Font Catalogue].
2487− The default is [Latin Modern][`lm`].
2488−
2489−`fontfamilyoptions`
2490−: options for package used as `fontfamily`; repeat for multiple options.
2491− For example, to use the Libertine font with proportional lowercase
2492− (old-style) figures through the [`libertinus`] package:
2493−
2494− ---
2495− fontfamily: libertinus
2496− fontfamilyoptions:
2497− - osf
2498− - p
2499− ...
2500−
2501−`fontsize`
2502−: font size for body text. The standard classes allow 10pt, 11pt, and
2503− 12pt. To use another size, set `documentclass` to one of
2504− the [KOMA-Script] classes, such as `scrartcl` or `scrbook`.
2505−
2506−`mainfont`, `sansfont`, `monofont`, `mathfont`, `CJKmainfont`
2507−: font families for use with `xelatex` or
2508− `lualatex`: take the name of any system font, using the
2509− [`fontspec`] package. `CJKmainfont` uses the [`xecjk`] package.
2510−
2511−`mainfontoptions`, `sansfontoptions`, `monofontoptions`, `mathfontoptions`, `CJKoptions`
2512−: options to use with `mainfont`, `sansfont`, `monofont`, `mathfont`,
2513− `CJKmainfont` in `xelatex` and `lualatex`. Allow for any
2514− choices available through [`fontspec`]; repeat for multiple
2515− options. For example, to use the [TeX Gyre] version of
2516− Palatino with lowercase figures:
2517−
2518− ---
2519− mainfont: TeX Gyre Pagella
2520− mainfontoptions:
2521− - Numbers=Lowercase
2522− - Numbers=Proportional
2523− ...
2524−
2525−`microtypeoptions`
2526−: options to pass to the microtype package
2527−
2528−#### Links
2529−
2530−`colorlinks`
2531−: add color to link text; automatically enabled if any of
2532− `linkcolor`, `filecolor`, `citecolor`, `urlcolor`, or `toccolor` are set
2533−
2534−`linkcolor`, `filecolor`, `citecolor`, `urlcolor`, `toccolor`
2535−: color for internal links, external links, citation links, linked
2536− URLs, and links in table of contents, respectively: uses options
2537− allowed by [`xcolor`], including the `dvipsnames`, `svgnames`, and
2538− `x11names` lists
2539−
2540−`links-as-notes`
2541−: causes links to be printed as footnotes
2542−
2543−#### Front matter
2544−
2545−`lof`, `lot`
2546−: include list of figures, list of tables
2547−
2548−`thanks`
2549−: contents of acknowledgments footnote after document title
2550−
2551−`toc`
2552−: include table of contents (can also be set using
2553− `--toc/--table-of-contents`)
2554−
2555−`toc-depth`
2556−: level of section to include in table of contents
2557−
2558−#### BibLaTeX Bibliographies
2559−
2560−These variables function when using BibLaTeX for [citation rendering].
2561−
2562−`biblatexoptions`
2563−: list of options for biblatex
2564−
2565−`biblio-style`
2566−: bibliography style, when used with `--natbib` and `--biblatex`.
2567−
2568−`biblio-title`
2569−: bibliography title, when used with `--natbib` and `--biblatex`.
2570−
2571−`bibliography`
2572−: bibliography to use for resolving references
2573−
2574−`natbiboptions`
2575−: list of options for natbib
2576−
2577−[KOMA-Script]: https://ctan.org/pkg/koma-script
2578−[LaTeX Font Catalogue]: https://tug.org/FontCatalogue/
2579−[LaTeX font encodings guide]: https://ctan.org/pkg/encguide
2580−[TeX Gyre]: http://www.gust.org.pl/projects/e-foundry/tex-gyre
2581−[`article`]: https://ctan.org/pkg/article
2582−[`book`]: https://ctan.org/pkg/book
2583−[`libertinus`]: https://ctan.org/pkg/libertinus
2584−[`memoir`]: https://ctan.org/pkg/memoir
2585−[`report`]: https://ctan.org/pkg/report
2586−
2587−### Variables for ConTeXt
2588−
2589−Pandoc uses these variables when [creating a PDF] with ConTeXt.
2590−
2591−`fontsize`
2592−: font size for body text (e.g. `10pt`, `12pt`)
2593−
2594−`headertext`, `footertext`
2595−: text to be placed in running header or footer (see [ConTeXt Headers and
2596− Footers]); repeat up to four times for different placement
2597−
2598−`indenting`
2599−: controls indentation of paragraphs, e.g. `yes,small,next` (see
2600− [ConTeXt Indentation]); repeat for multiple options
2601−
2602−`interlinespace`
2603−: adjusts line spacing, e.g. `4ex` (using [`setupinterlinespace`]);
2604− repeat for multiple options
2605−
2606−`layout`
2607−: options for page margins and text arrangement (see [ConTeXt Layout]);
2608− repeat for multiple options
2609−
2610−`linkcolor`, `contrastcolor`
2611−: color for links outside and inside a page, e.g. `red`, `blue` (see
2612− [ConTeXt Color])
2613−
2614−`linkstyle`
2615−: typeface style for links, e.g. `normal`, `bold`, `slanted`, `boldslanted`,
2616− `type`, `cap`, `small`
2617−
2618−`lof`, `lot`
2619−: include list of figures, list of tables
2620−
2621−`mainfont`, `sansfont`, `monofont`, `mathfont`
2622−: font families: take the name of any system font (see
2623− [ConTeXt Font Switching])
2624−
2625−`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
2626−: sets margins, if `layout` is not used (otherwise `layout`
2627− overrides these)
2628−
2629−`pagenumbering`
2630−: page number style and location (using [`setuppagenumbering`]);
2631− repeat for multiple options
2632−
2633−`papersize`
2634−: paper size, e.g. `letter`, `A4`, `landscape` (see [ConTeXt Paper Setup]);
2635− repeat for multiple options
2636−
2637−`pdfa`
2638−: adds to the preamble the setup necessary to generate PDF/A
2639− of the type specified, e.g. `1a:2005`, `2a`. If no type is
2640− specified (i.e. the value is set to True, by e.g.
2641− `--metadata=pdfa` or `pdfa: true` in a YAML metadata block),
2642− `1b:2005` will be used as default, for reasons of backwards
2643− compatibility. Using `--variable=pdfa` without specified value
2644− is not supported. To successfully generate PDF/A the required
2645− ICC color profiles have to be available and the content and all
2646− included files (such as images) have to be standard conforming.
2647− The ICC profiles and output intent may be specified using the
2648− variables `pdfaiccprofile` and `pdfaintent`. See also [ConTeXt
2649− PDFA] for more details.
2650−
2651−`pdfaiccprofile`
2652−: when used in conjunction with `pdfa`, specifies the ICC profile to use
2653− in the PDF, e.g. `default.cmyk`. If left unspecified, `sRGB.icc` is
2654− used as default. May be repeated to include multiple profiles. Note that
2655− the profiles have to be available on the system. They can be obtained
2656− from [ConTeXt ICC Profiles].
2657−
2658−`pdfaintent`
2659−: when used in conjunction with `pdfa`, specifies the output intent for
2660− the colors, e.g. `ISO coated v2 300\letterpercent\space (ECI)`
2661− If left unspecified, `sRGB IEC61966-2.1` is used as default.
2662−
2663−`toc`
2664−: include table of contents (can also be set using
2665− `--toc/--table-of-contents`)
2666−
2667−`whitespace`
2668−: spacing between paragraphs, e.g. `none`, `small` (using
2669− [`setupwhitespace`])
2670−
2671−`includesource`
2672−: include all source documents as file attachments in the PDF file
2673−
2674−[ConTeXt Paper Setup]: https://wiki.contextgarden.net/PaperSetup
2675−[ConTeXt Layout]: https://wiki.contextgarden.net/Layout
2676−[ConTeXt Font Switching]: https://wiki.contextgarden.net/Font_Switching
2677−[ConTeXt Color]: https://wiki.contextgarden.net/Color
2678−[ConTeXt Headers and Footers]: https://wiki.contextgarden.net/Headers_and_Footers
2679−[ConTeXt Indentation]: https://wiki.contextgarden.net/Indentation
2680−[ConTeXt ICC Profiles]: https://wiki.contextgarden.net/PDFX#ICC_profiles
2681−[ConTeXt PDFA]: https://wiki.contextgarden.net/PDF/A
2682−[`setupwhitespace`]: https://wiki.contextgarden.net/Command/setupwhitespace
2683−[`setupinterlinespace`]: https://wiki.contextgarden.net/Command/setupinterlinespace
2684−[`setuppagenumbering`]: https://wiki.contextgarden.net/Command/setuppagenumbering
2685−
2686−### Variables for `wkhtmltopdf`
2687−
2688−Pandoc uses these variables when [creating a PDF] with [`wkhtmltopdf`].
2689−The `--css` option also affects the output.
2690−
2691−`footer-html`, `header-html`
2692−: add information to the header and footer
2693−
2694−`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
2695−: set the page margins
2696−
2697−`papersize`
2698−: sets the PDF paper size
2699−
2700−### Variables for man pages
2701−
2702−`adjusting`
2703−: adjusts text to left (`l`), right (`r`), center (`c`),
2704− or both (`b`) margins
2705−
2706−`footer`
2707−: footer in man pages
2708−
2709−`header`
2710−: header in man pages
2711−
2712−`hyphenate`
2713−: if `true` (the default), hyphenation will be used
2714−
2715−`section`
2716−: section number in man pages
2717−
2718−### Variables for ms
2719−
2720−`fontfamily`
2721−: font family (e.g. `T` or `P`)
2722−
2723−`indent`
2724−: paragraph indent (e.g. `2m`)
2725−
2726−`lineheight`
2727−: line height (e.g. `12p`)
2728−
2729−`pointsize`
2730−: point size (e.g. `10p`)
2731−
2732−### Variables set automatically
2733−
2734−Pandoc sets these variables automatically in response to [options] or
2735−document contents; users can also modify them. These vary depending
2736−on the output format, and include the following:
2737−
2738−`body`
2739−: body of document
2740−
2741−`date-meta`
2742−: the `date` variable converted to ISO 8601 YYYY-MM-DD,
2743− included in all HTML based formats (dzslides, epub,
2744− html, html4, html5, revealjs, s5, slideous, slidy).
2745− The recognized formats for `date` are: `mm/dd/yyyy`,
2746− `mm/dd/yy`, `yyyy-mm-dd` (ISO 8601), `dd MM yyyy`
2747− (e.g. either `02 Apr 2018` or `02 April 2018`),
2748− `MM dd, yyyy` (e.g. `Apr. 02, 2018` or `April 02, 2018),
2749− `yyyy[mm[dd]]]` (e.g. `20180402, `201804` or `2018`).
2750−
2751−`header-includes`
2752−: contents specified by `-H/--include-in-header` (may have multiple
2753− values)
2754−
2755−`include-before`
2756−: contents specified by `-B/--include-before-body` (may have
2757− multiple values)
2758−
2759−`include-after`
2760−: contents specified by `-A/--include-after-body` (may have
2761− multiple values)
2762−
2763−`meta-json`
2764−: JSON representation of all of the document's metadata. Field
2765− values are transformed to the selected output format.
2766−
2767−`numbersections`
2768−: non-null value if `-N/--number-sections` was specified
2769−
2770−`sourcefile`, `outputfile`
2771−: source and destination filenames, as given on the command line.
2772− `sourcefile` can also be a list if input comes from multiple files,
2773− or empty if input is from stdin. You can use the following snippet in
2774− your template to distinguish them:
2775−
2776− $if(sourcefile)$
2777− $for(sourcefile)$
2778− $sourcefile$
2779− $endfor$
2780− $else$
2781− (stdin)
2782− $endif$
2783−
2784− Similarly, `outputfile` can be `-` if output goes to the terminal.
2785−
2786− If you need absolute paths, use e.g. `$curdir$/$sourcefile$`.
2787−
2788−`curdir`
2789−: working directory from which pandoc is run.
2790−
2791−`toc`
2792−: non-null value if `--toc/--table-of-contents` was specified
2793−
2794−`toc-title`
2795−: title of table of contents (works only with EPUB,
2796− HTML, opendocument, odt, docx, pptx, beamer, LaTeX)
2797−
2798−[pandoc-templates]: https://github.com/jgm/pandoc-templates
2799−
2800−# Extensions
2801−
2802−The behavior of some of the readers and writers can be adjusted by
2803−enabling or disabling various extensions.
2804−
2805−An extension can be enabled by adding `+EXTENSION`
2806−to the format name and disabled by adding `-EXTENSION`. For example,
2807−`--from markdown_strict+footnotes` is strict Markdown with footnotes
2808−enabled, while `--from markdown-footnotes-pipe_tables` is pandoc's
2809−Markdown without footnotes or pipe tables.
2810−
2811−The markdown reader and writer make by far the most use of extensions.
2812−Extensions only used by them are therefore covered in the
2813−section [Pandoc's Markdown] below (See [Markdown variants] for
2814−`commonmark` and `gfm`.) In the following, extensions that also work
2815−for other formats are covered.
2816−
2817−Note that markdown extensions added to the `ipynb` format
2818−affect Markdown cells in Jupyter notebooks (as do command-line
2819−options like `--atx-headers`).
2820−
2821−## Typography
2822−
2823−#### Extension: `smart` ####
2824−
2825−Interpret straight quotes as curly quotes, `---` as em-dashes,
2826−`--` as en-dashes, and `...` as ellipses. Nonbreaking spaces are
2827−inserted after certain abbreviations, such as "Mr."
2828−
2829−This extension can be enabled/disabled for the following formats:
2830−
2831−input formats
2832−: `markdown`, `commonmark`, `latex`, `mediawiki`, `org`, `rst`, `twiki`
2833−
2834−output formats
2835−: `markdown`, `latex`, `context`, `rst`
2836−
2837−enabled by default in
2838−: `markdown`, `latex`, `context` (both input and output)
2839−
2840−Note: If you are *writing* Markdown, then the `smart` extension
2841−has the reverse effect: what would have been curly quotes comes
2842−out straight.
2843−
2844−In LaTeX, `smart` means to use the standard TeX ligatures
2845−for quotation marks (` `` ` and ` '' ` for double quotes,
2846−`` ` `` and `` ' `` for single quotes) and dashes (`--` for
2847−en-dash and `---` for em-dash). If `smart` is disabled,
2848−then in reading LaTeX pandoc will parse these characters
2849−literally. In writing LaTeX, enabling `smart` tells pandoc
2850−to use the ligatures when possible; if `smart` is disabled
2851−pandoc will use unicode quotation mark and dash characters.
2852−
2853−## Headings and sections
2854−
2855−#### Extension: `auto_identifiers` ####
2856−
2857−A heading without an explicitly specified identifier will be
2858−automatically assigned a unique identifier based on the heading text.
2859−
2860−This extension can be enabled/disabled for the following formats:
2861−
2862−input formats
2863−: `markdown`, `latex`, `rst`, `mediawiki`, `textile`
2864−
2865−output formats
2866−: `markdown`, `muse`
2867−
2868−enabled by default in
2869−: `markdown`, `muse`
2870−
2871−The default algorithm used to derive the identifier from the
2872−heading text is:
2873−
2874− - Remove all formatting, links, etc.
2875− - Remove all footnotes.
2876− - Remove all non-alphanumeric characters,
2877− except underscores, hyphens, and periods.
2878− - Replace all spaces and newlines with hyphens.
2879− - Convert all alphabetic characters to lowercase.
2880− - Remove everything up to the first letter (identifiers may
2881− not begin with a number or punctuation mark).
2882− - If nothing is left after this, use the identifier `section`.
2883−
2884−Thus, for example,
2885−
2886− Heading Identifier
2887− ------------------------------- ----------------------------
2888− `Heading identifiers in HTML` `heading-identifiers-in-html`
2889− `Maître d'hôtel` `maître-dhôtel`
2890− `*Dogs*?--in *my* house?` `dogs--in-my-house`
2891− `[HTML], [S5], or [RTF]?` `html-s5-or-rtf`
2892− `3. Applications` `applications`
2893− `33` `section`
2894−
2895−These rules should, in most cases, allow one to determine the identifier
2896−from the heading text. The exception is when several headings have the
2897−same text; in this case, the first will get an identifier as described
2898−above; the second will get the same identifier with `-1` appended; the
2899−third with `-2`; and so on.
2900−
2901−(However, a different algorithm is used if
2902−`gfm_auto_identifiers` is enabled; see below.)
2903−
2904−These identifiers are used to provide link targets in the table of
2905−contents generated by the `--toc|--table-of-contents` option. They
2906−also make it easy to provide links from one section of a document to
2907−another. A link to this section, for example, might look like this:
2908−
2909− See the section on
2910− [heading identifiers](#heading-identifiers-in-html-latex-and-context).
2911−
2912−Note, however, that this method of providing links to sections works
2913−only in HTML, LaTeX, and ConTeXt formats.
2914−
2915−If the `--section-divs` option is specified, then each section will
2916−be wrapped in a `section` (or a `div`, if `html4` was specified),
2917−and the identifier will be attached to the enclosing `<section>`
2918−(or `<div>`) tag rather than the heading itself. This allows entire
2919−sections to be manipulated using JavaScript or treated differently in
2920−CSS.
2921−
2922−#### Extension: `ascii_identifiers` ####
2923−
2924−Causes the identifiers produced by `auto_identifiers` to be pure ASCII.
2925−Accents are stripped off of accented Latin letters, and non-Latin
2926−letters are omitted.
2927−
2928−#### Extension: `gfm_auto_identifiers` ####
2929−
2930−Changes the algorithm used by `auto_identifiers` to conform to
2931−GitHub's method. Spaces are converted to dashes (`-`),
2932−uppercase characters to lowercase characters, and punctuation
2933−characters other than `-` and `_` are removed.
2934−Emojis are replaced by their names.
2935−
2936−## Math Input
2937−
2938−The extensions [`tex_math_dollars`](#extension-tex_math_dollars),
2939−[`tex_math_single_backslash`](#extension-tex_math_single_backslash), and
2940−[`tex_math_double_backslash`](#extension-tex_math_double_backslash)
2941−are described in the section about Pandoc's Markdown.
2942−
2943−However, they can also be used with HTML input. This is handy for
2944−reading web pages formatted using MathJax, for example.
2945−
2946−## Raw HTML/TeX
2947−
2948−The following extensions are described in more detail in
2949−their respective sections of [Pandoc's Markdown]:
2950−
2951−- [`raw_html`](#extension-raw_html) allows HTML elements which
2952− are not representable in pandoc's AST to be parsed as raw HTML.
2953− By default, this is disabled for HTML input.
2954−
2955−- [`raw_tex`](#extension-raw_tex) allows raw LaTeX, TeX, and ConTeXt
2956− to be included in a document. This extension can be enabled/disabled
2957− for the following formats (in addition to `markdown`):
2958−
2959− input formats
2960− : `latex`, `textile`, `html` (environments, `\ref`, and
2961− `\eqref` only), `ipynb`
2962−
2963− output formats
2964− : `textile`, `commonmark`
2965−
2966− Note: as applied to `ipynb`, `raw_html` and `raw_tex` affect not
2967− only raw TeX in markdown cells, but data with mime type
2968− `text/html` in output cells. Since the `ipynb` reader attempts
2969− to preserve the richest possible outputs when several options
2970− are given, you will get best results if you disable `raw_html`
2971− and `raw_tex` when converting to formats like `docx` which don't
2972− allow raw `html` or `tex`.
2973−
2974−- [`native_divs`](#extension-native_divs) causes HTML `div`
2975− elements to be parsed as native pandoc Div blocks.
2976− If you want them to be parsed as raw HTML, use
2977− `-f html-native_divs+raw_html`.
2978
1219
2979−- [`native_spans`](#extension-native_spans) causes HTML `span`
1220+`fontfamilyoptions`
2980− elements to be parsed as native pandoc Span inlines.
1221+: options for package used as `fontfamily`: e.g. `osf,sc` with
2981− If you want them to be parsed as raw HTML, use
1222+ `fontfamily` set to [`mathpazo`] provides Palatino with old-style
2982− `-f html-native_spans+raw_html`. If you want to drop all
1223+ figures and true small caps; may be repeated for multiple options
2983− `div`s and `span`s when converting HTML to Markdown, you
2984− can use `pandoc -f html-native_divs-native_spans -t markdown`.
2985
1224
2986−## Literate Haskell support
1225+`mainfont`, `sansfont`, `monofont`, `mathfont`, `CJKmainfont`
1226+: font families for use with `xelatex` or
1227+ `lualatex`: take the name of any system font, using the
1228+ [`fontspec`] package. Note that if `CJKmainfont` is used,
1229+ the [`xecjk`] package must be available.
2987
1230
2988−#### Extension: `literate_haskell` ####
1231+`mainfontoptions`, `sansfontoptions`, `monofontoptions`, `mathfontoptions`, `CJKoptions`
1232+: options to use with `mainfont`, `sansfont`, `monofont`, `mathfont`,
1233+ `CJKmainfont` in `xelatex` and `lualatex`. Allow for any choices
1234+ available through [`fontspec`], such as the OpenType features
1235+ `Numbers=OldStyle,Numbers=Proportional`. May be repeated for multiple options.
2989
1236
2990−Treat the document as literate Haskell source.
1237+`fontenc`
1238+: allows font encoding to be specified through `fontenc` package (with `pdflatex`);
1239+ default is `T1` (see guide to [LaTeX font encodings])
2991
1240
2992−This extension can be enabled/disabled for the following formats:
1241+`colorlinks`
1242+: add color to link text; automatically enabled if any of `linkcolor`, `citecolor`,
1243+ `urlcolor`, or `toccolor` are set
2993
1244
2994−input formats
1245+`linkcolor`, `citecolor`, `urlcolor`, `toccolor`
2995−: `markdown`, `rst`, `latex`
1246+: color for internal links, citation links, external links, and links in table of contents:
1247+ uses any of the [predefined LaTeX colors]
2996
1248
2997−output formats
1249+`links-as-notes`
2998−: `markdown`, `rst`, `latex`, `html`
1250+: causes links to be printed as footnotes
2999
1251
3000−If you append `+lhs` (or `+literate_haskell`) to one of the formats
1252+`indent`
3001−above, pandoc will treat the document as literate Haskell source.
1253+: uses document class settings for indentation (the default LaTeX template
3002−This means that
1254+ otherwise removes indentation and adds space between paragraphs)
3003
1255
3004− - In Markdown input, "bird track" sections will be parsed as Haskell
1256+`subparagraph`
3005− code rather than block quotations. Text between `\begin{code}`
1257+: disables default behavior of LaTeX template that redefines (sub)paragraphs
3006− and `\end{code}` will also be treated as Haskell code. For
1258+ as sections, changing the appearance of nested headings in some classes
3007− ATX-style headings the character '=' will be used instead of '#'.
3008
1259
3009− - In Markdown output, code blocks with classes `haskell` and `literate`
1260+`thanks`
3010− will be rendered using bird tracks, and block quotations will be
1261+: specifies contents of acknowledgments footnote after document title.
3011− indented one space, so they will not be treated as Haskell code.
3012− In addition, headings will be rendered setext-style (with underlines)
3013− rather than ATX-style (with '#' characters). (This is because ghc
3014− treats '#' characters in column 1 as introducing line numbers.)
3015
1262
3016− - In restructured text input, "bird track" sections will be parsed
1263+`toc`
3017− as Haskell code.
1264+: include table of contents (can also be set using `--toc/--table-of-contents`)
3018
1265
3019− - In restructured text output, code blocks with class `haskell` will
1266+`toc-depth`
3020− be rendered using bird tracks.
1267+: level of section to include in table of contents
3021
1268
3022− - In LaTeX input, text in `code` environments will be parsed as
1269+`secnumdepth`
3023− Haskell code.
1270+: numbering depth for sections, if sections are numbered
3024
1271
3025− - In LaTeX output, code blocks with class `haskell` will be rendered
1272+`lof`, `lot`
3026− inside `code` environments.
1273+: include list of figures, list of tables
3027
1274
3028− - In HTML output, code blocks with class `haskell` will be rendered
1275+`bibliography`
3029− with class `literatehaskell` and bird tracks.
1276+: bibliography to use for resolving references
3030
1277
3031−Examples:
1278+`biblio-style`
1279+: bibliography style, when used with `--natbib` and
1280+ `--biblatex`.
3032
1281
3033− pandoc -f markdown+lhs -t html
1282+`biblatexoptions`
1283+: list of options for biblatex.
3034
1284
3035−reads literate Haskell source formatted with Markdown conventions and writes
1285+[`article`]: https://ctan.org/pkg/article
3036−ordinary HTML (without bird tracks).
1286+[`report`]: https://ctan.org/pkg/report
1287+[`book`]: https://ctan.org/pkg/book
1288+[KOMA-Script]: https://ctan.org/pkg/koma-script
1289+[`memoir`]: https://ctan.org/pkg/memoir
1290+[predefined LaTeX colors]: https://en.wikibooks.org/wiki/LaTeX/Colors#Predefined_colors
1291+[LaTeX Font Catalogue]: http://www.tug.dk/FontCatalogue/
1292+[`mathpazo`]: https://ctan.org/pkg/mathpazo
1293+[LaTeX font encodings]: https://ctan.org/pkg/encguide
3037
1294
3038− pandoc -f markdown+lhs -t html+lhs
1295+Variables for ConTeXt
1296+---------------------
3039
1297
3040−writes HTML with the Haskell code in bird tracks, so it can be copied
1298+`papersize`
3041−and pasted as literate Haskell source.
1299+: paper size, e.g. `letter`, `A4`, `landscape` (see [ConTeXt Paper Setup]);
1300+ may be repeated for multiple options
3042
1301
3043−Note that GHC expects the bird tracks in the first column, so indented
1302+`layout`
3044−literate code blocks (e.g. inside an itemized environment) will not be
1303+: options for page margins and text arrangement (see [ConTeXt Layout]);
3045−picked up by the Haskell compiler.
1304+ may be repeated for multiple options
3046
1305
3047−## Other extensions
1306+`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
1307+: sets margins, if `layout` is not used (otherwise `layout`
1308+ overrides these)
3048
1309
3049−#### Extension: `empty_paragraphs` ####
1310+`fontsize`
1311+: font size for body text (e.g. `10pt`, `12pt`)
3050
1312
3051−Allows empty paragraphs. By default empty paragraphs are
1313+`mainfont`, `sansfont`, `monofont`, `mathfont`
3052−omitted.
1314+: font families: take the name of any system font (see [ConTeXt Font Switching])
3053
1315
3054−This extension can be enabled/disabled for the following formats:
1316+`linkcolor`, `contrastcolor`
1317+: color for links outside and inside a page, e.g. `red`, `blue` (see [ConTeXt Color])
3055
1318
3056−input formats
1319+`linkstyle`
3057−: `docx`, `html`
1320+: typeface style for links, e.g. `normal`, `bold`, `slanted`, `boldslanted`, `type`, `cap`, `small`
3058
1321
3059−output formats
1322+`indenting`
3060−: `docx`, `odt`, `opendocument`, `html`
1323+: controls indentation of paragraphs, e.g. `yes,small,next` (see [ConTeXt Indentation]);
1324+ may be repeated for multiple options
3061
1325
3062−#### Extension: `native_numbering` ####
1326+`whitespace`
1327+: spacing between paragraphs, e.g. `none`, `small` (using [`setupwhitespace`])
3063
1328
3064−Enables native numbering of figures and tables. Enumeration
1329+`interlinespace`
3065−starts at 1.
1330+: adjusts line spacing, e.g. `4ex` (using [`setupinterlinespace`]);
1331+ may be repeated for multiple options
3066
1332
3067−This extension can be enabled/disabled for the following formats:
1333+`headertext`, `footertext`
1334+: text to be placed in running header or footer (see [ConTeXt Headers and Footers]);
1335+ may be repeated up to four times for different placement
3068
1336
3069−output formats
1337+`pagenumbering`
3070−: `odt`, `opendocument`
1338+: page number style and location (using [`setuppagenumbering`]);
1339+ may be repeated for multiple options
3071
1340
3072−#### Extension: `xrefs_name` ####
1341+`toc`
1342+: include table of contents (can also be set using `--toc/--table-of-contents`)
3073
1343
3074−Links to headings, figures and tables inside the document are
1344+`lof`, `lot`
3075−substituted with cross-references that will use the name or caption
1345+: include list of figures, list of tables
3076−of the referenced item. The original link text is replaced once
3077−the generated document is refreshed. This extension can be combined
3078−with `xrefs_number` in which case numbers will appear before the
3079−name.
3080
1346
3081−Text in cross-references is only made consistent with the referenced
1347+[ConTeXt Paper Setup]: http://wiki.contextgarden.net/PaperSetup
3082−item once the document has been refreshed.
1348+[ConTeXt Layout]: http://wiki.contextgarden.net/Layout
1349+[ConTeXt Font Switching]: http://wiki.contextgarden.net/Font_Switching
1350+[ConTeXt Color]: http://wiki.contextgarden.net/Color
1351+[ConTeXt Headers and Footers]: http://wiki.contextgarden.net/Headers_and_Footers
1352+[ConTeXt Indentation]: http://wiki.contextgarden.net/Indentation
1353+[`setupwhitespace`]: http://wiki.contextgarden.net/Command/setupwhitespace
1354+[`setupinterlinespace`]: http://wiki.contextgarden.net/Command/setupinterlinespace
1355+[`setuppagenumbering`]: http://wiki.contextgarden.net/Command/setuppagenumbering
3083
1356
3084−This extension can be enabled/disabled for the following formats:
1357+Variables for man pages
1358+-----------------------
3085
1359
3086−output formats
1360+`section`
3087−: `odt`, `opendocument`
1361+: section number in man pages
3088
1362
3089−#### Extension: `xrefs_number` ####
1363+`header`
1364+: header in man pages
3090
1365
3091−Links to headings, figures and tables inside the document are
1366+`footer`
3092−substituted with cross-references that will use the number
1367+: footer in man pages
3093−of the referenced item. The original link text is discarded.
3094−This extension can be combined with `xrefs_name` in which case
3095−the name or caption numbers will appear after the number.
3096
1368
3097−For the `xrefs_number` to be useful heading numbers must be enabled
1369+`adjusting`
3098−in the generated document, also table and figure captions must be enabled
1370+: adjusts text to left (`l`), right (`r`), center (`c`),
3099−using for example the `native_numbering` extension.
1371+ or both (`b`) margins
3100
1372
3101−Numbers in cross-references are only visible in the final document once
1373+`hyphenate`
3102−it has been refreshed.
1374+: if `true` (the default), hyphenation will be used
3103
1375
3104−This extension can be enabled/disabled for the following formats:
1376+Using variables in templates
1377+----------------------------
3105
1378
3106−output formats
1379+Variable names are sequences of alphanumerics, `-`, and `_`,
3107−: `odt`, `opendocument`
1380+starting with a letter. A variable name surrounded by `$` signs
1381+will be replaced by its value. For example, the string `$title$` in
3108
1382
3109−#### Extension: `styles` #### {#ext-styles}
1383+ <title>$title$</title>
3110
1384
3111−When converting from docx, read all docx styles as divs (for
1385+will be replaced by the document title.
3112−paragraph styles) and spans (for character styles) regardless
3113−of whether pandoc understands the meaning of these styles.
3114−This can be used with [docx custom styles](#custom-styles).
3115−Disabled by default.
3116
1386
3117−input formats
1387+To write a literal `$` in a template, use `$$`.
3118−: `docx`
3119
1388
3120−#### Extension: `amuse` ####
1389+Templates may contain conditionals. The syntax is as follows:
3121
1390
3122−In the `muse` input format, this enables Text::Amuse
1391+ $if(variable)$
3123−extensions to Emacs Muse markup.
1392+ X
1393+ $else$
1394+ Y
1395+ $endif$
3124
1396
3125−#### Extension: `raw_markdown` ####
1397+This will include `X` in the template if `variable` has a non-null
1398+value; otherwise it will include `Y`. `X` and `Y` are placeholders for
1399+any valid template text, and may include interpolated variables or other
1400+conditionals. The `$else$` section may be omitted.
3126
1401
3127−In the `ipynb` input format, this causes Markdown cells
1402+When variables can have multiple values (for example, `author` in
3128−to be included as raw Markdown blocks (allowing lossless
1403+a multi-author document), you can use the `$for$` keyword:
3129−round-tripping) rather than being parsed. Use this only
3130−when you are targeting `ipynb` or a markdown-based
3131−output format.
3132
1404
3133−#### Extension: `citations` {#org-citations}
1405+ $for(author)$
1406+ <meta name="author" content="$author$" />
1407+ $endfor$
3134
1408
3135−Some aspects of [Pandoc's Markdown citation syntax](#citations)
1409+You can optionally specify a separator to be used between
3136−are also accepted in `org` input.
1410+consecutive items:
3137
1411
3138−#### Extension: `element_citations` ####
1412+ $for(author)$$author$$sep$, $endfor$
3139
1413
3140−In the `jats` output formats, this causes reference items to
1414+A dot can be used to select a field of a variable that takes
3141−be replaced with `<element-citation>` elements. These
1415+an object as its value. So, for example:
3142−elements are not influenced by CSL styles, but all information
3143−on the item is included in tags.
3144
1416
3145−#### Extension: `ntb` ####
1417+ $author.name$ ($author.affiliation$)
3146
1418
3147−In the `context` output format this enables the use of [Natural Tables
1419+If you use custom templates, you may need to revise them as pandoc
3148−(TABLE)](https://wiki.contextgarden.net/TABLE) instead of the default
1420+changes. We recommend tracking the changes in the default templates,
3149−[Extreme Tables (xtables)](https://wiki.contextgarden.net/xtables).
1421+and modifying your custom templates accordingly. An easy way to do this
3150−Natural tables allow more fine-grained global customization but come
1422+is to fork the [pandoc-templates] repository and merge in changes after each
3151−at a performance penalty compared to extreme tables.
1423+pandoc release.
3152
1424
1425+[pandoc-templates]: https://github.com/jgm/pandoc-templates
3153
1426
3154−# Pandoc's Markdown
1427+Pandoc's Markdown
1428+=================
3155
1429
3156Pandoc understands an extended and slightly revised version of
1430Pandoc understands an extended and slightly revised version of
3157John Gruber's [Markdown] syntax. This document explains the syntax,
1431John Gruber's [Markdown] syntax. This document explains the syntax,
3158noting differences from standard Markdown. Except where noted, these
1432noting differences from standard Markdown. Except where noted, these
3159differences can be suppressed by using the `markdown_strict` format instead
1433differences can be suppressed by using the `markdown_strict` format instead
3160−of `markdown`. Extensions can be enabled or disabled to specify the
1434+of `markdown`. An extensions can be enabled by adding `+EXTENSION`
3161−behavior more granularly. They are described in the following. See also
1435+to the format name and disabled by adding `-EXTENSION`. For example,
3162−[Extensions] above, for extensions that work also on other formats.
1436+`markdown_strict+footnotes` is strict Markdown with footnotes
1437+enabled, while `markdown-footnotes-pipe_tables` is pandoc's
1438+Markdown without footnotes or pipe tables.
3163
1439
3164−## Philosophy
1440+Philosophy
1441+----------
3165
1442
3166Markdown is designed to be easy to write, and, even more importantly,
1443Markdown is designed to be easy to write, and, even more importantly,
3167easy to read:
1444easy to read:
@@ -3169,7 +1446,7 @@ easy to read:
3169> A Markdown-formatted document should be publishable as-is, as plain
1446> A Markdown-formatted document should be publishable as-is, as plain
3170> text, without looking like it's been marked up with tags or formatting
1447> text, without looking like it's been marked up with tags or formatting
3171> instructions.
1448> instructions.
3172−> -- [John Gruber](https://daringfireball.net/projects/markdown/syntax#philosophy)
1449+> -- [John Gruber](http://daringfireball.net/projects/markdown/syntax#philosophy)
3173
1450
3174This principle has guided pandoc's decisions in finding syntax for
1451This principle has guided pandoc's decisions in finding syntax for
3175tables, footnotes, and other extensions.
1452tables, footnotes, and other extensions.
@@ -3182,7 +1459,8 @@ it discourages it, and provides other, non-HTMLish ways of representing
3182important document elements like definition lists, tables, mathematics, and
1459important document elements like definition lists, tables, mathematics, and
3183footnotes.
1460footnotes.
3184
1461
3185−## Paragraphs
1462+Paragraphs
1463+----------
3186
1464
3187A paragraph is one or more lines of text followed by one or more blank lines.
1465A paragraph is one or more lines of text followed by one or more blank lines.
3188Newlines are treated as spaces, so you can reflow your paragraphs as you like.
1466Newlines are treated as spaces, so you can reflow your paragraphs as you like.
@@ -3195,42 +1473,43 @@ Note: in multiline and grid table cells, this is the only way
3195to create a hard line break, since trailing spaces in the cells
1473to create a hard line break, since trailing spaces in the cells
3196are ignored.
1474are ignored.
3197
1475
3198−## Headings
1476+Headers
1477+-------
3199
1478
3200−There are two kinds of headings: Setext and ATX.
1479+There are two kinds of headers: Setext and ATX.
3201
1480
3202−### Setext-style headings ###
1481+### Setext-style headers ###
3203
1482
3204−A setext-style heading is a line of text "underlined" with a row of `=` signs
1483+A setext-style header is a line of text "underlined" with a row of `=` signs
3205−(for a level-one heading) or `-` signs (for a level-two heading):
1484+(for a level one header) or `-` signs (for a level two header):
3206
1485
3207− A level-one heading
1486+ A level-one header
3208− ===================
1487+ ==================
3209
1488
3210− A level-two heading
1489+ A level-two header
3211− -------------------
1490+ ------------------
3212
1491
3213−The heading text can contain inline formatting, such as emphasis (see
1492+The header text can contain inline formatting, such as emphasis (see
3214[Inline formatting], below).
1493[Inline formatting], below).
3215
1494
3216
1495
3217−### ATX-style headings ###
1496+### ATX-style headers ###
3218
1497
3219−An ATX-style heading consists of one to six `#` signs and a line of
1498+An ATX-style header consists of one to six `#` signs and a line of
3220text, optionally followed by any number of `#` signs. The number of
1499text, optionally followed by any number of `#` signs. The number of
3221−`#` signs at the beginning of the line is the heading level:
1500+`#` signs at the beginning of the line is the header level:
3222
1501
3223− ## A level-two heading
1502+ ## A level-two header
3224
1503
3225− ### A level-three heading ###
1504+ ### A level-three header ###
3226
1505
3227−As with setext-style headings, the heading text can contain formatting:
1506+As with setext-style headers, the header text can contain formatting:
3228
1507
3229− # A level-one heading with a [link](/url) and *emphasis*
1508+ # A level-one header with a [link](/url) and *emphasis*
3230
1509
3231#### Extension: `blank_before_header` ####
1510#### Extension: `blank_before_header` ####
3232
1511
3233−Standard Markdown syntax does not require a blank line before a heading.
1512+Standard Markdown syntax does not require a blank line before a header.
3234Pandoc does require this (except, of course, at the beginning of the
1513Pandoc does require this (except, of course, at the beginning of the
3235document). The reason for the requirement is that it is all too easy for a
1514document). The reason for the requirement is that it is all too easy for a
3236`#` to end up at the beginning of a line by accident (perhaps through line
1515`#` to end up at the beginning of a line by accident (perhaps through line
@@ -3239,33 +1518,24 @@ wrapping). Consider, for example:
3239 I like several of their flavors of ice cream:
1518 I like several of their flavors of ice cream:
3240 #22, for example, and #5.
1519 #22, for example, and #5.
3241
1520
3242−#### Extension: `space_in_atx_header` ####
3243−
3244−Many Markdown implementations do not require a space between the
3245−opening `#`s of an ATX heading and the heading text, so that
3246−`#5 bolt` and `#hashtag` count as headings. With this extension,
3247−pandoc does require the space.
3248
1521
3249−### Heading identifiers ###
1522+### Header identifiers ###
3250−
3251−See also the [`auto_identifiers`
3252−extension](#extension-auto_identifiers) above.
3253
1523
3254#### Extension: `header_attributes` ####
1524#### Extension: `header_attributes` ####
3255
1525
3256−Headings can be assigned attributes using this syntax at the end
1526+Headers can be assigned attributes using this syntax at the end
3257−of the line containing the heading text:
1527+of the line containing the header text:
3258
1528
3259 {#identifier .class .class key=value key=value}
1529 {#identifier .class .class key=value key=value}
3260
1530
3261−Thus, for example, the following headings will all be assigned the identifier
1531+Thus, for example, the following headers will all be assigned the identifier
3262`foo`:
1532`foo`:
3263
1533
3264− # My heading {#foo}
1534+ # My header {#foo}
3265
1535
3266− ## My heading ## {#foo}
1536+ ## My header ## {#foo}
3267
1537
3268− My other heading {#foo}
1538+ My other header {#foo}
3269 ---------------
1539 ---------------
3270
1540
3271(This syntax is compatible with [PHP Markdown Extra].)
1541(This syntax is compatible with [PHP Markdown Extra].)
@@ -3274,56 +1544,100 @@ Note that although this syntax allows assignment of classes and key/value
3274attributes, writers generally don't use all of this information. Identifiers,
1544attributes, writers generally don't use all of this information. Identifiers,
3275classes, and key/value attributes are used in HTML and HTML-based formats such
1545classes, and key/value attributes are used in HTML and HTML-based formats such
3276as EPUB and slidy. Identifiers are used for labels and link anchors in the
1546as EPUB and slidy. Identifiers are used for labels and link anchors in the
3277−LaTeX, ConTeXt, Textile, Jira markup, and AsciiDoc writers.
1547+LaTeX, ConTeXt, Textile, and AsciiDoc writers.
3278
1548
3279−Headings with the class `unnumbered` will not be numbered, even if
1549+Headers with the class `unnumbered` will not be numbered, even if
3280`--number-sections` is specified. A single hyphen (`-`) in an attribute
1550`--number-sections` is specified. A single hyphen (`-`) in an attribute
3281context is equivalent to `.unnumbered`, and preferable in non-English
1551context is equivalent to `.unnumbered`, and preferable in non-English
3282documents. So,
1552documents. So,
3283
1553
3284− # My heading {-}
1554+ # My header {-}
3285
1555
3286is just the same as
1556is just the same as
3287
1557
3288− # My heading {.unnumbered}
1558+ # My header {.unnumbered}
1559+
1560+#### Extension: `auto_identifiers` ####
1561+
1562+A header without an explicitly specified identifier will be
1563+automatically assigned a unique identifier based on the header text.
1564+To derive the identifier from the header text,
1565+
1566+ - Remove all formatting, links, etc.
1567+ - Remove all footnotes.
1568+ - Remove all punctuation, except underscores, hyphens, and periods.
1569+ - Replace all spaces and newlines with hyphens.
1570+ - Convert all alphabetic characters to lowercase.
1571+ - Remove everything up to the first letter (identifiers may
1572+ not begin with a number or punctuation mark).
1573+ - If nothing is left after this, use the identifier `section`.
1574+
1575+Thus, for example,
1576+
1577+ Header Identifier
1578+ ------------------------------- ----------------------------
1579+ `Header identifiers in HTML` `header-identifiers-in-html`
1580+ `*Dogs*?--in *my* house?` `dogs--in-my-house`
1581+ `[HTML], [S5], or [RTF]?` `html-s5-or-rtf`
1582+ `3. Applications` `applications`
1583+ `33` `section`
1584+
1585+These rules should, in most cases, allow one to determine the identifier
1586+from the header text. The exception is when several headers have the
1587+same text; in this case, the first will get an identifier as described
1588+above; the second will get the same identifier with `-1` appended; the
1589+third with `-2`; and so on.
1590+
1591+These identifiers are used to provide link targets in the table of
1592+contents generated by the `--toc|--table-of-contents` option. They
1593+also make it easy to provide links from one section of a document to
1594+another. A link to this section, for example, might look like this:
1595+
1596+ See the section on
1597+ [header identifiers](#header-identifiers-in-html-latex-and-context).
1598+
1599+Note, however, that this method of providing links to sections works
1600+only in HTML, LaTeX, and ConTeXt formats.
3289
1601
3290−If the `unlisted` class is present in addition to `unnumbered`,
1602+If the `--section-divs` option is specified, then each section will
3291−the heading will not be included in a table of contents.
1603+be wrapped in a `div` (or a `section`, if `--html5` was specified),
3292−(Currently this feature is only implemented for certain
1604+and the identifier will be attached to the enclosing `<div>`
3293−formats: those based on LaTeX and HTML, PowerPoint, and RTF.)
1605+(or `<section>`) tag rather than the header itself. This allows entire
1606+sections to be manipulated using javascript or treated differently in
1607+CSS.
3294
1608
3295#### Extension: `implicit_header_references` ####
1609#### Extension: `implicit_header_references` ####
3296
1610
3297−Pandoc behaves as if reference links have been defined for each heading.
1611+Pandoc behaves as if reference links have been defined for each header.
3298−So, to link to a heading
1612+So, to link to a header
3299
1613
3300− # Heading identifiers in HTML
1614+ # Header identifiers in HTML
3301
1615
3302you can simply write
1616you can simply write
3303
1617
3304− [Heading identifiers in HTML]
1618+ [Header identifiers in HTML]
3305
1619
3306or
1620or
3307
1621
3308− [Heading identifiers in HTML][]
1622+ [Header identifiers in HTML][]
3309
1623
3310or
1624or
3311
1625
3312− [the section on heading identifiers][heading identifiers in
1626+ [the section on header identifiers][header identifiers in
3313 HTML]
1627 HTML]
3314
1628
3315instead of giving the identifier explicitly:
1629instead of giving the identifier explicitly:
3316
1630
3317− [Heading identifiers in HTML](#heading-identifiers-in-html)
1631+ [Header identifiers in HTML](#header-identifiers-in-html)
3318
1632
3319−If there are multiple headings with identical text, the corresponding
1633+If there are multiple headers with identical text, the corresponding
3320reference will link to the first one only, and you will need to use explicit
1634reference will link to the first one only, and you will need to use explicit
3321links to link to the others, as described above.
1635links to link to the others, as described above.
3322
1636
3323Like regular reference links, these references are case-insensitive.
1637Like regular reference links, these references are case-insensitive.
3324
1638
3325Explicit link reference definitions always take priority over
1639Explicit link reference definitions always take priority over
3326−implicit heading references. So, in the following example, the
1640+implicit header references. So, in the following example, the
3327link will point to `bar`, not to `#foo`:
1641link will point to `bar`, not to `#foo`:
3328
1642
3329 # Foo
1643 # Foo
@@ -3332,11 +1646,12 @@ link will point to `bar`, not to `#foo`:
3332
1646
3333 See [foo]
1647 See [foo]
3334
1648
3335−## Block quotations
1649+Block quotations
1650+----------------
3336
1651
3337Markdown uses email conventions for quoting blocks of text.
1652Markdown uses email conventions for quoting blocks of text.
3338A block quotation is one or more paragraphs or other block elements
1653A block quotation is one or more paragraphs or other block elements
3339−(such as lists or headings), with each line preceded by a `>` character
1654+(such as lists or headers), with each line preceded by a `>` character
3340and an optional space. (The `>` need not start at the left margin, but
1655and an optional space. (The `>` need not start at the left margin, but
3341it should not be indented more than three spaces.)
1656it should not be indented more than three spaces.)
3342
1657
@@ -3371,19 +1686,19 @@ block in a block quote, you need five spaces after the `>`:
3371
1686
3372#### Extension: `blank_before_blockquote` ####
1687#### Extension: `blank_before_blockquote` ####
3373
1688
3374−Standard Markdown syntax does not require a blank line before a
1689+Standard Markdown syntax does not require a blank line before a block
3375−block quote. Pandoc does require this (except, of course, at
1690+quote. Pandoc does require this (except, of course, at the beginning of the
3376−the beginning of the document). The reason for the requirement
1691+document). The reason for the requirement is that it is all too easy for a
3377−is that it is all too easy for a `>` to end up at the beginning
3378−of a line by accident (perhaps through line wrapping). So,
1692+`>` to end up at the beginning of a line by accident (perhaps through line
3379−unless the `markdown_strict` format is used, the following does
1693+wrapping). So, unless the `markdown_strict` format is used, the following does
3380not produce a nested block quote in pandoc:
1694not produce a nested block quote in pandoc:
3381
1695
3382 > This is a block quote.
1696 > This is a block quote.
3383 >> Nested.
1697 >> Nested.
3384
1698
3385
1699
3386−## Verbatim (code) blocks
1700+Verbatim (code) blocks
1701+----------------------
3387
1702
3388### Indented code blocks ###
1703### Indented code blocks ###
3389
1704
@@ -3445,16 +1760,13 @@ this syntax:
3445 qsort (filter (>= x) xs)
1760 qsort (filter (>= x) xs)
3446 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1761 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3447
1762
3448−Here `mycode` is an identifier, `haskell` and `numberLines` are
1763+Here `mycode` is an identifier, `haskell` and `numberLines` are classes, and
3449−classes, and `startFrom` is an attribute with value `100`. Some
1764+`startFrom` is an attribute with value `100`. Some output formats can use this
3450−output formats can use this information to do syntax
3451−highlighting. Currently, the only output formats that uses this
1765+information to do syntax highlighting. Currently, the only output formats
3452−information are HTML, LaTeX, Docx, Ms, and PowerPoint. If
1766+that uses this information are HTML and LaTeX. If highlighting is supported
3453−highlighting is supported for your output format and language,
3454−then the code block above will appear highlighted, with numbered
1767+for your output format and language, then the code block above will appear
3455−lines. (To see which languages are supported, type `pandoc
1768+highlighted, with numbered lines. (To see which languages are supported, do
3456−--list-highlight-languages`.) Otherwise, the code block above
1769+`pandoc --version`.) Otherwise, the code block above will appear as follows:
3457−will appear as follows:
3458
1770
3459 <pre id="mycode" class="haskell numberLines" startFrom="100">
1771 <pre id="mycode" class="haskell numberLines" startFrom="100">
3460 <code>
1772 <code>
@@ -3462,12 +1774,6 @@ will appear as follows:
3462 </code>
1774 </code>
3463 </pre>
1775 </pre>
3464
1776
3465−The `numberLines` (or `number-lines`) class will cause the lines
3466−of the code block to be numbered, starting with `1` or the value
3467−of the `startFrom` attribute. The `lineAnchors` (or
3468−`line-anchors`) class will cause the lines to be clickable
3469−anchors in HTML output.
3470−
3471A shortcut form can also be used for specifying the language of
1777A shortcut form can also be used for specifying the language of
3472the code block:
1778the code block:
3473
1779
@@ -3482,7 +1788,7 @@ This is equivalent to:
3482 ```
1788 ```
3483
1789
3484If the `fenced_code_attributes` extension is disabled, but
1790If the `fenced_code_attributes` extension is disabled, but
3485−input contains class attribute(s) for the code block, the first
1791+input contains class attribute(s) for the codeblock, the first
3486class attribute will be printed after the opening fence as a bare
1792class attribute will be printed after the opening fence as a bare
3487word.
1793word.
3488
1794
@@ -3491,7 +1797,8 @@ To set the highlighting style, use `--highlight-style`.
3491For more information on highlighting, see [Syntax highlighting],
1797For more information on highlighting, see [Syntax highlighting],
3492below.
1798below.
3493
1799
3494−## Line blocks
1800+Line blocks
1801+-----------
3495
1802
3496#### Extension: `line_blocks` ####
1803#### Extension: `line_blocks` ####
3497
1804
@@ -3517,12 +1824,10 @@ line must begin with a space.
3517 | 200 Main St.
1824 | 200 Main St.
3518 | Berkeley, CA 94718
1825 | Berkeley, CA 94718
3519
1826
3520−Inline formatting (such as emphasis) is allowed in the content,
3521−but not block-level formatting (such as block quotes or lists).
3522−
3523This syntax is borrowed from [reStructuredText].
1827This syntax is borrowed from [reStructuredText].
3524
1828
3525−## Lists
1829+Lists
1830+-----
3526
1831
3527### Bullet lists ###
1832### Bullet lists ###
3528
1833
@@ -3560,12 +1865,12 @@ But Markdown also allows a "lazy" format:
3560 list item.
1865 list item.
3561 * and my second.
1866 * and my second.
3562
1867
3563−### Block content in list items ###
1868+### The four-space rule ###
3564
1869
3565A list item may contain multiple paragraphs and other block-level
1870A list item may contain multiple paragraphs and other block-level
3566content. However, subsequent paragraphs must be preceded by a blank line
1871content. However, subsequent paragraphs must be preceded by a blank line
3567−and indented to line up with the first non-space content after
1872+and indented four spaces or a tab. The list will look better if the first
3568−the list marker.
1873+paragraph is aligned with the rest:
3569
1874
3570 * First paragraph.
1875 * First paragraph.
3571
1876
@@ -3576,29 +1881,19 @@ the list marker.
3576
1881
3577 { code }
1882 { code }
3578
1883
3579−Exception: if the list marker is followed by an indented code
3580−block, which must begin 5 spaces after the list marker, then
3581−subsequent paragraphs must begin two columns after the last
3582−character of the list marker:
3583−
3584− * code
3585−
3586− continuation paragraph
3587−
3588List items may include other lists. In this case the preceding blank
1884List items may include other lists. In this case the preceding blank
3589−line is optional. The nested list must be indented to line up with
1885+line is optional. The nested list must be indented four spaces or
3590−the first non-space character after the list marker of the
1886+one tab:
3591−containing list item.
3592
1887
3593 * fruits
1888 * fruits
3594− + apples
1889+ + apples
3595− - macintosh
1890+ - macintosh
3596− - red delicious
1891+ - red delicious
3597− + pears
1892+ + pears
3598− + peaches
1893+ + peaches
3599 * vegetables
1894 * vegetables
3600− + broccoli
1895+ + broccoli
3601− + chard
1896+ + chard
3602
1897
3603As noted above, Markdown allows you to write list items "lazily," instead of
1898As noted above, Markdown allows you to write list items "lazily," instead of
3604indenting continuation lines. However, if there are multiple paragraphs or
1899indenting continuation lines. However, if there are multiple paragraphs or
@@ -3613,6 +1908,21 @@ other blocks in a list item, the first line of each must be indented.
3613 Second paragraph of second
1908 Second paragraph of second
3614 list item.
1909 list item.
3615
1910
1911+**Note:** Although the four-space rule for continuation paragraphs
1912+comes from the official [Markdown syntax guide], the reference implementation,
1913+`Markdown.pl`, does not follow it. So pandoc will give different results than
1914+`Markdown.pl` when authors have indented continuation paragraphs fewer than
1915+four spaces.
1916+
1917+The [Markdown syntax guide] is not explicit whether the four-space
1918+rule applies to *all* block-level content in a list item; it only
1919+mentions paragraphs and code blocks. But it implies that the rule
1920+applies to all block-level content (including nested lists), and
1921+pandoc interprets it that way.
1922+
1923+ [Markdown syntax guide]:
1924+ http://daringfireball.net/projects/markdown/syntax#list
1925+
3616### Ordered lists ###
1926### Ordered lists ###
3617
1927
3618Ordered lists work just like bulleted lists, except that the items
1928Ordered lists work just like bulleted lists, except that the items
@@ -3636,7 +1946,7 @@ and this one:
3636
1946
3637Unlike standard Markdown, pandoc allows ordered list items to be marked
1947Unlike standard Markdown, pandoc allows ordered list items to be marked
3638with uppercase and lowercase letters and roman numerals, in addition to
1948with uppercase and lowercase letters and roman numerals, in addition to
3639−Arabic numerals. List markers may be enclosed in parentheses or followed by a
1949+arabic numerals. List markers may be enclosed in parentheses or followed by a
3640single right-parentheses or period. They must be separated from the
1950single right-parentheses or period. They must be separated from the
3641text that follows by at least one space, and, if the list marker is a
1951text that follows by at least one space, and, if the list marker is a
3642capital letter with a period, by at least two spaces.[^2]
1952capital letter with a period, by at least two spaces.[^2]
@@ -3692,12 +2002,6 @@ If default list markers are desired, use `#.`:
3692 #. two
2002 #. two
3693 #. three
2003 #. three
3694
2004
3695−#### Extension: `task_lists` ####
3696−
3697−Pandoc supports task lists, using the syntax of GitHub-Flavored Markdown.
3698−
3699− - [ ] an unchecked task list item
3700− - [x] checked item
3701
2005
3702### Definition lists ###
2006### Definition lists ###
3703
2007
@@ -3723,12 +2027,11 @@ a blank line, and must be followed by one or more definitions.
3723A definition begins with a colon or tilde, which may be indented one
2027A definition begins with a colon or tilde, which may be indented one
3724or two spaces.
2028or two spaces.
3725
2029
3726−A term may have multiple definitions, and each definition may
2030+A term may have multiple definitions, and each definition may consist of one or
3727−consist of one or more block elements (paragraph, code block,
2031+more block elements (paragraph, code block, list, etc.), each indented four
3728−list, etc.), each indented four spaces or one tab stop. The
3729−body of the definition (including the first line, aside from the
2032+spaces or one tab stop. The body of the definition (including the first line,
3730−colon or tilde) should be indented four spaces. However, as with
2033+aside from the colon or tilde) should be indented four spaces. However,
3731−other Markdown lists, you can "lazily" omit indentation except
2034+as with other Markdown lists, you can "lazily" omit indentation except
3732at the beginning of a paragraph or other block element:
2035at the beginning of a paragraph or other block element:
3733
2036
3734 Term 1
2037 Term 1
@@ -3754,10 +2057,9 @@ definition:
3754Note that space between items in a definition list is required.
2057Note that space between items in a definition list is required.
3755(A variant that loosens this requirement, but disallows "lazy"
2058(A variant that loosens this requirement, but disallows "lazy"
3756hard wrapping, can be activated with `compact_definition_lists`: see
2059hard wrapping, can be activated with `compact_definition_lists`: see
3757−[Non-default extensions], below.)
2060+[Non-pandoc extensions], below.)
3758
2061
3759−[^3]: I have been influenced by the suggestions of [David
2062+[^3]: I have been influenced by the suggestions of [David Wheeler](http://www.justatheory.com/computers/markup/modest-markdown-proposal.html).
3760− Wheeler](https://justatheory.com/2009/02/modest-markdown-proposal/).
3761
2063
3762### Numbered example lists ###
2064### Numbered example lists ###
3763
2065
@@ -3786,12 +2088,30 @@ document:
3786The label can be any string of alphanumeric characters, underscores,
2088The label can be any string of alphanumeric characters, underscores,
3787or hyphens.
2089or hyphens.
3788
2090
3789−Note: continuation paragraphs in example lists must always
2091+
3790−be indented four spaces, regardless of the length of the
2092+### Compact and loose lists ###
3791−list marker. That is, example lists always behave as if the
2093+
3792−`four_space_rule` extension is set. This is because example
2094+Pandoc behaves differently from `Markdown.pl` on some "edge
3793−labels tend to be long, and indenting content to the
2095+cases" involving lists. Consider this source:
3794−first non-space character after the label would be awkward.
2096+
2097+ + First
2098+ + Second:
2099+ - Fee
2100+ - Fie
2101+ - Foe
2102+
2103+ + Third
2104+
2105+Pandoc transforms this into a "compact list" (with no `<p>` tags around
2106+"First", "Second", or "Third"), while Markdown puts `<p>` tags around
2107+"Second" and "Third" (but not "First"), because of the blank space
2108+around "Third". Pandoc follows a simple rule: if the text is followed by
2109+a blank line, it is treated as a paragraph. Since "Second" is followed
2110+by a list, and not a blank line, it isn't treated as a paragraph. The
2111+fact that the list is followed by a blank line is irrelevant. (Note:
2112+Pandoc works this way even when the `markdown_strict` format is specified. This
2113+behavior is consistent with the official Markdown syntax description,
2114+even though it is different from that of `Markdown.pl`.)
3795
2115
3796
2116
3797### Ending a list ###
2117### Ending a list ###
@@ -3831,7 +2151,8 @@ of one big list:
3831 2. dos
2151 2. dos
3832 3. tres
2152 3. tres
3833
2153
3834−## Horizontal rules
2154+Horizontal rules
2155+----------------
3835
2156
3836A line containing a row of three or more `*`, `-`, or `_` characters
2157A line containing a row of three or more `*`, `-`, or `_` characters
3837(optionally separated by spaces) produces a horizontal rule:
2158(optionally separated by spaces) produces a horizontal rule:
@@ -3841,7 +2162,8 @@ A line containing a row of three or more `*`, `-`, or `_` characters
3841 ---------------
2162 ---------------
3842
2163
3843
2164
3844−## Tables
2165+Tables
2166+------
3845
2167
3846Four kinds of tables may be used. The first three kinds presuppose the use of
2168Four kinds of tables may be used. The first three kinds presuppose the use of
3847a fixed-width font, such as Courier. The fourth kind can be used with
2169a fixed-width font, such as Courier. The fourth kind can be used with
@@ -3866,7 +2188,7 @@ Simple tables look like this:
3866
2188
3867 Table: Demonstration of simple table syntax.
2189 Table: Demonstration of simple table syntax.
3868
2190
3869−The header and table rows must each fit on one line. Column
2191+The headers and table rows must each fit on one line. Column
3870alignments are determined by the position of the header text relative
2192alignments are determined by the position of the header text relative
3871to the dashed line below it:[^4]
2193to the dashed line below it:[^4]
3872
2194
@@ -3885,7 +2207,7 @@ to the dashed line below it:[^4]
3885The table must end with a blank line, or a line of dashes followed by
2207The table must end with a blank line, or a line of dashes followed by
3886a blank line.
2208a blank line.
3887
2209
3888−The column header row may be omitted, provided a dashed line is used
2210+The column headers may be omitted, provided a dashed line is used
3889to end the table. For example:
2211to end the table. For example:
3890
2212
3891 ------- ------ ---------- -------
2213 ------- ------ ---------- -------
@@ -3894,13 +2216,13 @@ to end the table. For example:
3894 1 1 1 1
2216 1 1 1 1
3895 ------- ------ ---------- -------
2217 ------- ------ ---------- -------
3896
2218
3897−When the header row is omitted, column alignments are determined on the basis
2219+When headers are omitted, column alignments are determined on the basis
3898of the first line of the table body. So, in the tables above, the columns
2220of the first line of the table body. So, in the tables above, the columns
3899would be right, left, center, and right aligned, respectively.
2221would be right, left, center, and right aligned, respectively.
3900
2222
3901#### Extension: `multiline_tables` ####
2223#### Extension: `multiline_tables` ####
3902
2224
3903−Multiline tables allow header and table rows to span multiple lines
2225+Multiline tables allow headers and table rows to span multiple lines
3904of text (but cells that span multiple columns or rows of the table are
2226of text (but cells that span multiple columns or rows of the table are
3905not supported). Here is an example:
2227not supported). Here is an example:
3906
2228
@@ -3922,7 +2244,7 @@ not supported). Here is an example:
3922These work like simple tables, but with the following differences:
2244These work like simple tables, but with the following differences:
3923
2245
3924 - They must begin with a row of dashes, before the header text
2246 - They must begin with a row of dashes, before the header text
3925− (unless the header row is omitted).
2247+ (unless the headers are omitted).
3926 - They must end with a row of dashes, then a blank line.
2248 - They must end with a row of dashes, then a blank line.
3927 - The rows must be separated by blank lines.
2249 - The rows must be separated by blank lines.
3928
2250
@@ -3931,7 +2253,7 @@ the columns, and the writers try to reproduce these relative widths in
3931the output. So, if you find that one of the columns is too narrow in the
2253the output. So, if you find that one of the columns is too narrow in the
3932output, try widening it in the Markdown source.
2254output, try widening it in the Markdown source.
3933
2255
3934−The header may be omitted in multiline tables as well as simple tables:
2256+Headers may be omitted in multiline tables as well as simple tables:
3935
2257
3936 ----------- ------- --------------- -------------------------
2258 ----------- ------- --------------- -------------------------
3937 First row 12.0 Example of a row that
2259 First row 12.0 Example of a row that
@@ -3942,7 +2264,7 @@ The header may be omitted in multiline tables as well as simple tables:
3942 rows.
2264 rows.
3943 ----------- ------- --------------- -------------------------
2265 ----------- ------- --------------- -------------------------
3944
2266
3945− : Here's a multiline table without a header.
2267+ : Here's a multiline table without headers.
3946
2268
3947It is possible for a multiline table to have just one row, but the row
2269It is possible for a multiline table to have just one row, but the row
3948should be followed by a blank line (and then the row of dashes that ends
2270should be followed by a blank line (and then the row of dashes that ends
@@ -3967,38 +2289,10 @@ Grid tables look like this:
3967The row of `=`s separates the header from the table body, and can be
2289The row of `=`s separates the header from the table body, and can be
3968omitted for a headerless table. The cells of grid tables may contain
2290omitted for a headerless table. The cells of grid tables may contain
3969arbitrary block elements (multiple paragraphs, code blocks, lists,
2291arbitrary block elements (multiple paragraphs, code blocks, lists,
3970−etc.). Cells that span multiple columns or rows are not
2292+etc.). Alignments are not supported, nor are cells that span multiple
3971−supported. Grid tables can be created easily using Emacs' table-mode
2293+columns or rows. Grid tables can be created easily using [Emacs table mode].
3972−(`M-x table-insert`).
3973−
3974−Alignments can be specified as with pipe tables, by putting
3975−colons at the boundaries of the separator line after the
3976−header:
3977−
3978− +---------------+---------------+--------------------+
3979− | Right | Left | Centered |
3980− +==============:+:==============+:==================:+
3981− | Bananas | $1.34 | built-in wrapper |
3982− +---------------+---------------+--------------------+
3983−
3984−For headerless tables, the colons go on the top line instead:
3985−
3986− +--------------:+:--------------+:------------------:+
3987− | Right | Left | Centered |
3988− +---------------+---------------+--------------------+
3989−
3990−##### Grid Table Limitations #####
3991−
3992−Pandoc does not support grid tables with row spans or column spans.
3993−This means that neither variable numbers of columns across rows nor
3994−variable numbers of rows across columns are supported by Pandoc.
3995−All grid tables must have the same number of columns in each row,
3996−and the same number of rows in each column. For example, the
3997−Docutils [sample grid tables] will not render as expected with
3998−Pandoc.
3999−
4000−[sample grid tables]: https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#grid-tables
4001
2294
2295+[Emacs table mode]: http://table.sourceforge.net/
4002
2296
4003#### Extension: `pipe_tables` ####
2297#### Extension: `pipe_tables` ####
4004
2298
@@ -4030,15 +2324,10 @@ legal (though ugly) pipe table:
4030
2324
4031The cells of pipe tables cannot contain block elements like paragraphs
2325The cells of pipe tables cannot contain block elements like paragraphs
4032and lists, and cannot span multiple lines. If a pipe table contains a
2326and lists, and cannot span multiple lines. If a pipe table contains a
4033−row whose Markdown content is wider than the column width (see
2327+row whose printable content is wider than the column width (see
4034−`--columns`), then the table will take up the full text width and
4035−the cell contents will wrap, with the relative cell widths determined
2328+`--columns`), then the cell contents will wrap, with the
4036−by the number of dashes in the line separating the table header from
2329+relative cell widths determined by the widths of the separator
4037−the table body. (For example `---|-` would make the first column 3/4
2330+lines.
4038−and the second column 1/4 of the full text width.)
4039−On the other hand, if no lines are wider than column width, then
4040−cell contents will not be wrapped, and the cells will be sized
4041−to their contents.
4042
2331
4043Note: pandoc also recognizes pipe tables of the following
2332Note: pandoc also recognizes pipe tables of the following
4044form, as can be produced by Emacs' orgtbl-mode:
2333form, as can be produced by Emacs' orgtbl-mode:
@@ -4054,7 +2343,8 @@ you'll need to add colons as above.
4054
2343
4055[PHP Markdown Extra tables]: https://michelf.ca/projects/php-markdown/extra/#table
2344[PHP Markdown Extra tables]: https://michelf.ca/projects/php-markdown/extra/#table
4056
2345
4057−## Metadata blocks
2346+Metadata blocks
2347+---------------
4058
2348
4059#### Extension: `pandoc_title_block` ####
2349#### Extension: `pandoc_title_block` ####
4060
2350
@@ -4070,42 +2360,30 @@ output.) The block may contain just a title, a title and an author,
4070or all three elements. If you want to include an author but no
2360or all three elements. If you want to include an author but no
4071title, or a title and a date but no author, you need a blank line:
2361title, or a title and a date but no author, you need a blank line:
4072
2362
4073−```
4074−%
2363+ %
4075−% Author
2364+ % Author
4076−```
4077
2365
4078−```
4079−% My title
2366+ % My title
4080−%
2367+ %
4081−% June 15, 2006
2368+ % June 15, 2006
4082−```
4083
2369
4084The title may occupy multiple lines, but continuation lines must
2370The title may occupy multiple lines, but continuation lines must
4085begin with leading space, thus:
2371begin with leading space, thus:
4086
2372
4087−```
4088−% My title
2373+ % My title
4089− on multiple lines
2374+ on multiple lines
4090−```
4091
2375
4092If a document has multiple authors, the authors may be put on
2376If a document has multiple authors, the authors may be put on
4093separate lines with leading space, or separated by semicolons, or
2377separate lines with leading space, or separated by semicolons, or
4094both. So, all of the following are equivalent:
2378both. So, all of the following are equivalent:
4095
2379
4096−```
4097−% Author One
2380+ % Author One
4098− Author Two
2381+ Author Two
4099−```
4100
2382
4101−```
4102−% Author One; Author Two
2383+ % Author One; Author Two
4103−```
4104
2384
4105−```
4106−% Author One;
2385+ % Author One;
4107− Author Two
2386+ Author Two
4108−```
4109
2387
4110The date must fit on one line.
2388The date must fit on one line.
4111
2389
@@ -4146,7 +2424,7 @@ will also have "Version 4.0" in the header.
4146
2424
4147#### Extension: `yaml_metadata_block` ####
2425#### Extension: `yaml_metadata_block` ####
4148
2426
4149−A [YAML] metadata block is a valid YAML object, delimited by a line of three
2427+A YAML metadata block is a valid YAML object, delimited by a line of three
4150hyphens (`---`) at the top and a line of three hyphens (`---`) or three dots
2428hyphens (`---`) at the top and a line of three hyphens (`---`) or three dots
4151(`...`) at the bottom. A YAML metadata block may occur anywhere in the
2429(`...`) at the bottom. A YAML metadata block may occur anywhere in the
4152document, but if it is not at the beginning, it must be preceded by a blank
2430document, but if it is not at the beginning, it must be preceded by a blank
@@ -4157,53 +2435,43 @@ and pass it to pandoc as an argument, along with your Markdown files:
4157 pandoc chap1.md chap2.md chap3.md metadata.yaml -s -o book.html
2435 pandoc chap1.md chap2.md chap3.md metadata.yaml -s -o book.html
4158
2436
4159Just be sure that the YAML file begins with `---` and ends with `---` or
2437Just be sure that the YAML file begins with `---` and ends with `---` or
4160−`...`.) Alternatively, you can use the `--metadata-file` option. Using
2438+`...`.)
4161−that approach however, you cannot reference content (like footnotes)
4162−from the main markdown input document.
4163
2439
4164Metadata will be taken from the fields of the YAML object and added to any
2440Metadata will be taken from the fields of the YAML object and added to any
4165existing document metadata. Metadata can contain lists and objects (nested
2441existing document metadata. Metadata can contain lists and objects (nested
4166arbitrarily), but all string scalars will be interpreted as Markdown. Fields
2442arbitrarily), but all string scalars will be interpreted as Markdown. Fields
4167with names ending in an underscore will be ignored by pandoc. (They may be
2443with names ending in an underscore will be ignored by pandoc. (They may be
4168−given a role by external processors.) Field names must not be
2444+given a role by external processors.)
4169−interpretable as YAML numbers or boolean values (so, for
4170−example, `yes`, `True`, and `15` cannot be used as field names).
4171
2445
4172−A document may contain multiple metadata blocks. If two
2446+A document may contain multiple metadata blocks. The metadata fields will
2447+be combined through a *left-biased union*: if two metadata blocks attempt
4173−metadata blocks attempt to set the same field, the value from
2448+to set the same field, the value from the first block will be taken.
4174−the second block will be taken.
4175
2449
4176When pandoc is used with `-t markdown` to create a Markdown document,
2450When pandoc is used with `-t markdown` to create a Markdown document,
4177a YAML metadata block will be produced only if the `-s/--standalone`
2451a YAML metadata block will be produced only if the `-s/--standalone`
4178option is used. All of the metadata will appear in a single block
2452option is used. All of the metadata will appear in a single block
4179at the beginning of the document.
2453at the beginning of the document.
4180
2454
4181−Note that [YAML] escaping rules must be followed. Thus, for example,
2455+Note that YAML escaping rules must be followed. Thus, for example,
4182−if a title contains a colon, it must be quoted, and if it contains a
2456+if a title contains a colon, it must be quoted. The pipe character
4183−backslash escape, then it must be ensured that it is not treated as a
4184−[YAML escape sequence]. The pipe character (`|`) can be used to begin
4185−an indented block that will be interpreted literally, without need for
2457+(`|`) can be used to begin an indented block that will be interpreted
2458+literally, without need for escaping. This form is necessary
4186−escaping. This form is necessary when the field contains blank lines
2459+when the field contains blank lines:
4187−or block-level formatting:
4188
2460
4189 ---
2461 ---
4190 title: 'This is the title: it contains a colon'
2462 title: 'This is the title: it contains a colon'
4191 author:
2463 author:
4192− - Author One
2464+ - name: Author One
2465+ affiliation: University of Somewhere
4193− - Author Two
2466+ - name: Author Two
2467+ affiliation: University of Nowhere
4194− keywords: [nothing, nothingness]
2468+ tags: [nothing, nothingness]
4195 abstract: |
2469 abstract: |
4196 This is the abstract.
2470 This is the abstract.
4197
2471
4198 It consists of two paragraphs.
2472 It consists of two paragraphs.
4199 ...
2473 ...
4200
2474
4201−The literal block after the `|` must be indented relative to the
4202−line containing the `|`. If it is not, the YAML will be invalid
4203−and pandoc will not interpret it as metadata. For an overview
4204−of the complex rules governing YAML, see the [Wikipedia entry on
4205−YAML syntax].
4206−
4207Template variables will be set automatically from the metadata. Thus, for
2475Template variables will be set automatically from the metadata. Thus, for
4208example, in writing HTML, the variable `abstract` will be set to the HTML
2476example, in writing HTML, the variable `abstract` will be set to the HTML
4209equivalent of the Markdown in the `abstract` field:
2477equivalent of the Markdown in the `abstract` field:
@@ -4211,23 +2479,9 @@ equivalent of the Markdown in the `abstract` field:
4211 <p>This is the abstract.</p>
2479 <p>This is the abstract.</p>
4212 <p>It consists of two paragraphs.</p>
2480 <p>It consists of two paragraphs.</p>
4213
2481
4214−Variables can contain arbitrary YAML structures, but the template must match
4215−this structure. The `author` variable in the default templates expects a
2482+Note: The `author` variable in the default templates expects a simple list or
4216−simple list or string, but can be changed to support more complicated
4217−structures. The following combination, for example, would add an affiliation
4218−to the author if one is given:
4219−
4220− ---
4221− title: The document title
4222− author:
4223− - name: Author One
4224− affiliation: University of Somewhere
4225− - name: Author Two
4226− affiliation: University of Nowhere
4227− ...
4228−
4229−To use the structured authors in the example above, you would need a custom
2483+string. To use the structured authors in the example, you would need a
4230−template:
2484+custom template. For example:
4231
2485
4232 $for(author)$
2486 $for(author)$
4233 $if(author.name)$
2487 $if(author.name)$
@@ -4237,38 +2491,9 @@ template:
4237 $endif$
2491 $endif$
4238 $endfor$
2492 $endfor$
4239
2493
4240−Raw content to include in the document's header may be specified
4241−using `header-includes`; however, it is important to mark up
4242−this content as raw code for a particular output format, using
4243−the [`raw_attribute` extension](#extension-raw_attribute)), or it
4244−will be interpreted as markdown. For example:
4245−
4246− header-includes:
4247− - |
4248− ```{=latex}
4249− \let\oldsection\section
4250− \renewcommand{\section}[1]{\clearpage\oldsection{#1}}
4251− ```
4252−
4253−Note: the `yaml_metadata_block` extension works with
4254−`commonmark` as well as `markdown` (and it is enabled by default
4255−in `gfm` and `commonmark_x`). However, in these formats the
4256−following restrictions apply:
4257−
4258−- The YAML metadata block must occur at the beginning of the
4259− document (and there can be only one). If multiple files are
4260− given as arguments to pandoc, only the first can be a YAML
4261− metadata block.
4262
2494
4263−- The leaf nodes of the YAML structure are parsed in isolation from
4264− each other and from the rest of the document. So, for
4265− example, you can't use a reference link in these contexts
4266− if the link definition is somewhere else in the document.
4267−
4268−[YAML escape sequence]: https://yaml.org/spec/1.2/spec.html#id2776092
4269−[Wikipedia entry on YAML syntax]: https://en.m.wikipedia.org/wiki/YAML#Syntax
4270−
4271−## Backslash escapes
2495+Backslash escapes
2496+-----------------
4272
2497
4273#### Extension: `all_symbols_escapable` ####
2498#### Extension: `all_symbols_escapable` ####
4274
2499
@@ -4294,12 +2519,9 @@ which allows only the following characters to be backslash-escaped:
4294(However, if the `markdown_strict` format is used, the standard Markdown rule
2519(However, if the `markdown_strict` format is used, the standard Markdown rule
4295will be used.)
2520will be used.)
4296
2521
4297−A backslash-escaped space is parsed as a nonbreaking space. In TeX output,
2522+A backslash-escaped space is parsed as a nonbreaking space. It will
4298−it will appear as `~`. In HTML and XML output, it will appear as a
2523+appear in TeX output as `~` and in HTML and XML as `\&#160;` or
4299−literal unicode nonbreaking space character (note that it will thus
2524+`\&nbsp;`.
4300−actually look "invisible" in the generated HTML source; you can still
4301−use the `--ascii` command-line option to make it appear as an explicit
4302−entity).
4303
2525
4304A backslash-escaped newline (i.e. a backslash occurring at the end of
2526A backslash-escaped newline (i.e. a backslash occurring at the end of
4305a line) is parsed as a hard line break. It will appear in TeX output as
2527a line) is parsed as a hard line break. It will appear in TeX output as
@@ -4309,7 +2531,22 @@ two trailing spaces on a line.
4309
2531
4310Backslash escapes do not work in verbatim contexts.
2532Backslash escapes do not work in verbatim contexts.
4311
2533
2534+Smart punctuation
2535+-----------------
2536+
2537+#### Extension ####
2538+
2539+If the `--smart` option is specified, pandoc will produce typographically
2540+correct output, converting straight quotes to curly quotes, `---` to
2541+em-dashes, `--` to en-dashes, and `...` to ellipses. Nonbreaking spaces
2542+are inserted after certain abbreviations, such as "Mr."
2543+
2544+Note: if your LaTeX template or any included header file call for the
2545+[`csquotes`] package, pandoc will detect this automatically and use
2546+`\enquote{...}` for quoted text.
2547+
4312−## Inline formatting
2548+Inline formatting
2549+-----------------
4313
2550
4314### Emphasis ###
2551### Emphasis ###
4315
2552
@@ -4357,13 +2594,12 @@ text by `~` characters. Thus, for example,
4357
2594
4358 H~2~O is a liquid. 2^10^ is 1024.
2595 H~2~O is a liquid. 2^10^ is 1024.
4359
2596
4360−The text between `^...^` or `~...~` may not contain spaces or
4361−newlines. If the superscripted or subscripted text contains
2597+If the superscripted or subscripted text contains spaces, these spaces
4362−spaces, these spaces must be escaped with backslashes. (This is
2598+must be escaped with backslashes. (This is to prevent accidental
4363−to prevent accidental superscripting and subscripting through
2599+superscripting and subscripting through the ordinary use of `~` and `^`.)
4364−the ordinary use of `~` and `^`, and also bad interactions with
4365−footnotes.) Thus, if you want the letter P with 'a cat' in
2600+Thus, if you want the letter P with 'a cat' in subscripts, use
4366−subscripts, use `P~a\ cat~`, not `P~a cat~`.
2601+`P~a\ cat~`, not `P~a cat~`.
2602+
4367
2603
4368### Verbatim ###
2604### Verbatim ###
4369
2605
@@ -4397,22 +2633,15 @@ Attributes can be attached to verbatim text, just as with
4397
2633
4398### Small caps ###
2634### Small caps ###
4399
2635
4400−To write small caps, use the `smallcaps` class:
2636+To write small caps, you can use an HTML span tag:
4401−
4402− [Small caps]{.smallcaps}
4403−
4404−Or, without the `bracketed_spans` extension:
4405−
4406− <span class="smallcaps">Small caps</span>
4407−
4408−For compatibility with other Markdown flavors, CSS is also supported:
4409
2637
4410 <span style="font-variant:small-caps;">Small caps</span>
2638 <span style="font-variant:small-caps;">Small caps</span>
4411
2639
2640+(The semicolon is optional and there may be space after the
4412−This will work in all output formats that support small caps.
2641+colon.) This will work in all output formats that support small caps.
4413−
4414
2642
4415−## Math
2643+Math
2644+----
4416
2645
4417#### Extension: `tex_math_dollars` ####
2646#### Extension: `tex_math_dollars` ####
4418
2647
@@ -4424,38 +2653,22 @@ left, and must not be followed immediately by a digit. Thus,
4424you need to enclose text in literal `$` characters, backslash-escape
2653you need to enclose text in literal `$` characters, backslash-escape
4425them and they won't be treated as math delimiters.
2654them and they won't be treated as math delimiters.
4426
2655
4427−For display math, use `$$` delimiters. (In this case, the delimiters
4428−may be separated from the formula by whitespace. However, there can be
4429−no blank lines betwen the opening and closing `$$` delimiters.)
4430−
4431TeX math will be printed in all output formats. How it is rendered
2656TeX math will be printed in all output formats. How it is rendered
4432depends on the output format:
2657depends on the output format:
4433
2658
4434−LaTeX
4435− ~ It will appear verbatim surrounded by `\(...\)` (for inline
4436− math) or `\[...\]` (for display math).
4437−
4438−Markdown, Emacs Org mode, ConTeXt, ZimWiki
2659+Markdown, LaTeX, Emacs Org mode, ConTeXt, ZimWiki
4439− ~ It will appear verbatim surrounded by `$...$` (for inline
2660+ ~ It will appear verbatim between `$` characters.
4440− math) or `$$...$$` (for display math).
4441−
4442−XWiki
4443− ~ It will appear verbatim surrounded by `{{formula}}..{{/formula}}`.
4444
2661
4445reStructuredText
2662reStructuredText
4446 ~ It will be rendered using an [interpreted text role `:math:`].
2663 ~ It will be rendered using an [interpreted text role `:math:`].
4447
2664
4448AsciiDoc
2665AsciiDoc
4449− ~ For AsciiDoc output format (`-t asciidoc`) it will appear verbatim
2666+ ~ It will be rendered as `latexmath:[...]`.
4450− surrounded by `latexmath:[$...$]` (for inline math) or
4451− `[latexmath]++++\[...\]+++` (for display math).
4452− For AsciiDoctor output format (`-t asciidoctor`) the LaTex delimiters
4453− (`$..$` and `\[..\]`) are omitted.
4454
2667
4455Texinfo
2668Texinfo
4456 ~ It will be rendered inside a `@math` command.
2669 ~ It will be rendered inside a `@math` command.
4457
2670
4458−roff man, Jira markup
2671+groff man
4459 ~ It will be rendered verbatim without `$`'s.
2672 ~ It will be rendered verbatim without `$`'s.
4460
2673
4461MediaWiki, DokuWiki
2674MediaWiki, DokuWiki
@@ -4464,34 +2677,75 @@ MediaWiki, DokuWiki
4464Textile
2677Textile
4465 ~ It will be rendered inside `<span class="math">` tags.
2678 ~ It will be rendered inside `<span class="math">` tags.
4466
2679
4467−RTF, OpenDocument
2680+RTF, OpenDocument, ODT
4468− ~ It will be rendered, if possible, using Unicode characters,
2681+ ~ It will be rendered, if possible, using unicode characters,
4469 and will otherwise appear verbatim.
2682 and will otherwise appear verbatim.
4470
2683
4471−ODT
4472− ~ It will be rendered, if possible, using MathML.
4473−
4474DocBook
2684DocBook
4475 ~ If the `--mathml` flag is used, it will be rendered using MathML
2685 ~ If the `--mathml` flag is used, it will be rendered using MathML
4476 in an `inlineequation` or `informalequation` tag. Otherwise it
2686 in an `inlineequation` or `informalequation` tag. Otherwise it
4477− will be rendered, if possible, using Unicode characters.
2687+ will be rendered, if possible, using unicode characters.
4478
2688
4479Docx
2689Docx
4480 ~ It will be rendered using OMML math markup.
2690 ~ It will be rendered using OMML math markup.
4481
2691
4482FictionBook2
2692FictionBook2
4483 ~ If the `--webtex` option is used, formulas are rendered as images
2693 ~ If the `--webtex` option is used, formulas are rendered as images
4484− using CodeCogs or other compatible web service, downloaded
2694+ using Google Charts or other compatible web service, downloaded
4485 and embedded in the e-book. Otherwise, they will appear verbatim.
2695 and embedded in the e-book. Otherwise, they will appear verbatim.
4486
2696
4487HTML, Slidy, DZSlides, S5, EPUB
2697HTML, Slidy, DZSlides, S5, EPUB
4488 ~ The way math is rendered in HTML will depend on the
2698 ~ The way math is rendered in HTML will depend on the
4489− command-line options selected. Therefore see [Math rendering in HTML]
2699+ command-line options selected:
4490− above.
2700+
4491−
2701+ 1. The default is to render TeX math as far as possible using unicode
2702+ characters, as with RTF, DocBook, and OpenDocument output. Formulas
2703+ are put inside a `span` with `class="math"`, so that they may be
2704+ styled differently from the surrounding text if needed.
2705+
2706+ 2. If the `--latexmathml` option is used, TeX math will be displayed
2707+ between `$` or `$$` characters and put in `<span>` tags with class `LaTeX`.
2708+ The [LaTeXMathML] script will be used to render it as formulas.
2709+ (This trick does not work in all browsers, but it works in Firefox.
2710+ In browsers that do not support LaTeXMathML, TeX math will appear
2711+ verbatim between `$` characters.)
2712+
2713+ 3. If the `--jsmath` option is used, TeX math will be put inside
2714+ `<span>` tags (for inline math) or `<div>` tags (for display math)
2715+ with class `math`. The [jsMath] script will be used to render
2716+ it.
2717+
2718+ 4. If the `--mimetex` option is used, the [mimeTeX] CGI script will
2719+ be called to generate images for each TeX formula. This should
2720+ work in all browsers. The `--mimetex` option takes an optional URL
2721+ as argument. If no URL is specified, it will be assumed that the
2722+ mimeTeX CGI script is at `/cgi-bin/mimetex.cgi`.
2723+
2724+ 5. If the `--gladtex` option is used, TeX formulas will be enclosed
2725+ in `<eq>` tags in the HTML output. The resulting `htex` file may then
2726+ be processed by [gladTeX], which will produce image files for each
2727+ formula and an HTML file with links to these images. So, the
2728+ procedure is:
2729+
2730+ pandoc -s --gladtex myfile.txt -o myfile.htex
2731+ gladtex -d myfile-images myfile.htex
2732+ # produces myfile.html and images in myfile-images
2733+
2734+ 6. If the `--webtex` option is used, TeX formulas will be converted
2735+ to `<img>` tags that link to an external script that converts
2736+ formulas to images. The formula will be URL-encoded and concatenated
2737+ with the URL provided. If no URL is specified, the Google Chart
2738+ API will be used (`http://chart.apis.google.com/chart?cht=tx&chl=`).
2739+
2740+ 7. If the `--mathjax` option is used, TeX math will be displayed
2741+ between `\(...\)` (for inline math) or `\[...\]` (for display
2742+ math) and put in `<span>` tags with class `math`.
2743+ The [MathJax] script will be used to render it as formulas.
2744+
4492−[interpreted text role `:math:`]: https://docutils.sourceforge.io/docs/ref/rst/roles.html#math
2745+[interpreted text role `:math:`]: http://docutils.sourceforge.net/docs/ref/rst/roles.html#math
4493−
2746+
4494−## Raw HTML
2747+Raw HTML
2748+--------
4495
2749
4496#### Extension: `raw_html` ####
2750#### Extension: `raw_html` ####
4497
2751
@@ -4502,17 +2756,8 @@ Markdown allows it, but it has been made an extension so that it can
4502be disabled if desired.)
2756be disabled if desired.)
4503
2757
4504The raw HTML is passed through unchanged in HTML, S5, Slidy, Slideous,
2758The raw HTML is passed through unchanged in HTML, S5, Slidy, Slideous,
4505−DZSlides, EPUB, Markdown, CommonMark, Emacs Org mode, and Textile
2759+DZSlides, EPUB, Markdown, Emacs Org mode, and Textile output, and suppressed
4506−output, and suppressed in other formats.
2760+in other formats.
4507−
4508−For a more explicit way of including raw HTML in a Markdown
4509−document, see the [`raw_attribute` extension][Extension: `raw_attribute`].
4510−
4511−In the CommonMark format, if `raw_html` is enabled, superscripts,
4512−subscripts, strikeouts and small capitals will be represented as HTML.
4513−Otherwise, plain-text fallbacks will be used. Note that even if
4514−`raw_html` is disabled, tables will be rendered with HTML syntax if
4515−they cannot use pipe syntax.
4516
2761
4517#### Extension: `markdown_in_html_blocks` ####
2762#### Extension: `markdown_in_html_blocks` ####
4518
2763
@@ -4529,7 +2774,7 @@ Thus, for example, pandoc will turn
4529 <table>
2774 <table>
4530 <tr>
2775 <tr>
4531 <td>*one*</td>
2776 <td>*one*</td>
4532− <td>[a link](https://google.com)</td>
2777+ <td>[a link](http://google.com)</td>
4533 </tr>
2778 </tr>
4534 </table>
2779 </table>
4535
2780
@@ -4538,14 +2783,14 @@ into
4538 <table>
2783 <table>
4539 <tr>
2784 <tr>
4540 <td><em>one</em></td>
2785 <td><em>one</em></td>
4541− <td><a href="https://google.com">a link</a></td>
2786+ <td><a href="http://google.com">a link</a></td>
4542 </tr>
2787 </tr>
4543 </table>
2788 </table>
4544
2789
4545whereas `Markdown.pl` will preserve it as is.
2790whereas `Markdown.pl` will preserve it as is.
4546
2791
4547−There is one exception to this rule: text between `<script>`,
2792+There is one exception to this rule: text between `<script>` and
4548−`<style>`, and `<textarea>` tags is not interpreted as Markdown.
2793+`<style>` tags is not interpreted as Markdown.
4549
2794
4550This departure from standard Markdown should make it easier to mix
2795This departure from standard Markdown should make it easier to mix
4551Markdown with HTML block elements. For example, one can surround
2796Markdown with HTML block elements. For example, one can surround
@@ -4566,6 +2811,9 @@ For the most part this should give the same output as `raw_html`,
4566but it makes it easier to write pandoc filters to manipulate groups
2811but it makes it easier to write pandoc filters to manipulate groups
4567of inlines.
2812of inlines.
4568
2813
2814+Raw TeX
2815+-------
2816+
4569#### Extension: `raw_tex` ####
2817#### Extension: `raw_tex` ####
4570
2818
4571In addition to raw HTML, pandoc allows raw LaTeX, TeX, and ConTeXt to be
2819In addition to raw HTML, pandoc allows raw LaTeX, TeX, and ConTeXt to be
@@ -4587,84 +2835,29 @@ Note that in LaTeX environments, like
4587the material between the begin and end tags will be interpreted as raw
2835the material between the begin and end tags will be interpreted as raw
4588LaTeX, not as Markdown.
2836LaTeX, not as Markdown.
4589
2837
4590−For a more explicit and flexible way of including raw TeX in a
4591−Markdown document, see the [`raw_attribute`
4592−extension][Extension: `raw_attribute`].
4593−
4594Inline LaTeX is ignored in output formats other than Markdown, LaTeX,
2838Inline LaTeX is ignored in output formats other than Markdown, LaTeX,
4595Emacs Org mode, and ConTeXt.
2839Emacs Org mode, and ConTeXt.
4596
2840
4597−### Generic raw attribute ###
4598−
4599−#### Extension: `raw_attribute` ####
4600−
4601−Inline spans and fenced code blocks with a special
4602−kind of attribute will be parsed as raw content with the
4603−designated format. For example, the following produces a raw
4604−roff `ms` block:
4605−
4606− ```{=ms}
4607− .MYMACRO
4608− blah blah
4609− ```
4610−And the following produces a raw `html` inline element:
4611−
4612− This is `<a>html</a>`{=html}
4613−
4614−This can be useful to insert raw xml into `docx` documents, e.g.
4615−a pagebreak:
4616−
4617− ```{=openxml}
4618− <w:p>
4619− <w:r>
4620− <w:br w:type="page"/>
4621− </w:r>
4622− </w:p>
4623− ```
4624−
4625−The format name should match the target format name (see
4626−`-t/--to`, above, for a list, or use `pandoc
4627−--list-output-formats`). Use `openxml` for `docx` output,
4628−`opendocument` for `odt` output, `html5` for `epub3` output,
4629−`html4` for `epub2` output, and `latex`, `beamer`,
4630−`ms`, or `html5` for `pdf` output (depending on what you
4631−use for `--pdf-engine`).
4632−
4633−This extension presupposes that the relevant kind of
4634−inline code or fenced code block is enabled. Thus, for
4635−example, to use a raw attribute with a backtick code block,
4636−`backtick_code_blocks` must be enabled.
4637−
4638−The raw attribute cannot be combined with regular attributes.
4639−
4640−## LaTeX macros
2841+LaTeX macros
2842+------------
4641
2843
4642#### Extension: `latex_macros` ####
2844#### Extension: `latex_macros` ####
4643
2845
4644−When this extension is enabled, pandoc will parse LaTeX
2846+For output formats other than LaTeX, pandoc will parse LaTeX `\newcommand` and
4645−macro definitions and apply the resulting macros to all LaTeX
2847+`\renewcommand` definitions and apply the resulting macros to all LaTeX
4646−math and raw LaTeX. So, for example, the following will work in
2848+math. So, for example, the following will work in all output formats,
4647−all output formats, not just LaTeX:
2849+not just LaTeX:
4648
2850
4649 \newcommand{\tuple}[1]{\langle #1 \rangle}
2851 \newcommand{\tuple}[1]{\langle #1 \rangle}
4650
2852
4651 $\tuple{a, b, c}$
2853 $\tuple{a, b, c}$
4652
2854
4653−Note that LaTeX macros will not be applied if they occur
2855+In LaTeX output, the `\newcommand` definition will simply be passed
4654−inside a raw span or block marked with the
2856+unchanged to the output.
4655−[`raw_attribute` extension](#extension-raw_attribute).
4656
2857
4657−When `latex_macros` is disabled, the raw LaTeX and math will
4658−not have macros applied. This is usually a better approach when
4659−you are targeting LaTeX or PDF.
4660
2858
4661−Macro definitions in LaTeX will be passed through as raw LaTeX
4662−only if `latex_macros` is not enabled. Macro definitions in
4663−Markdown source (or other formats allowing `raw_tex`) will
4664−be passed through regardless of whether `latex_macros` is
4665−enabled.
4666−
4667−## Links
2859+Links
2860+-----
4668
2861
4669Markdown allows links to be specified in several ways.
2862Markdown allows links to be specified in several ways.
4670
2863
@@ -4673,7 +2866,7 @@ Markdown allows links to be specified in several ways.
4673If you enclose a URL or email address in pointy brackets, it
2866If you enclose a URL or email address in pointy brackets, it
4674will become a link:
2867will become a link:
4675
2868
4676− <https://google.com>
2869+ <http://google.com>
4677 <sam@green.eggs.ham>
2870 <sam@green.eggs.ham>
4678
2871
4679### Inline links ###
2872### Inline links ###
@@ -4683,7 +2876,7 @@ followed by the URL in parentheses. (Optionally, the URL can
4683be followed by a link title, in quotes.)
2876be followed by a link title, in quotes.)
4684
2877
4685 This is an [inline link](/url), and here's [one with
2878 This is an [inline link](/url), and here's [one with
4686− a title](https://fsf.org "click here for a good time!").
2879+ a title](http://fsf.org "click here for a good time!").
4687
2880
4688There can be no space between the bracketed part and the parenthesized part.
2881There can be no space between the bracketed part and the parenthesized part.
4689The link text can contain formatting (such as emphasis), but the title cannot.
2882The link text can contain formatting (such as emphasis), but the title cannot.
@@ -4700,8 +2893,7 @@ definition, which may occur elsewhere in the document (either
4700before or after the link).
2893before or after the link).
4701
2894
4702The link consists of link text in square brackets, followed by a label in
2895The link consists of link text in square brackets, followed by a label in
4703−square brackets. (There cannot be space between the two unless the
2896+square brackets. (There can be space between the two.) The link definition
4704−`spaced_reference_links` extension is enabled.) The link definition
4705consists of the bracketed label, followed by a colon and a space, followed by
2897consists of the bracketed label, followed by a colon and a space, followed by
4706the URL, and optionally (after a space) a link title either in quotes or in
2898the URL, and optionally (after a space) a link title either in quotes or in
4707parentheses. The label must not be parseable as a citation (assuming
2899parentheses. The label must not be parseable as a citation (assuming
@@ -4712,7 +2904,7 @@ Here are some examples:
4712
2904
4713 [my label 1]: /foo/bar.html "My title, optional"
2905 [my label 1]: /foo/bar.html "My title, optional"
4714 [my label 2]: /foo
2906 [my label 2]: /foo
4715− [my label 3]: https://fsf.org (The free software foundation)
2907+ [my label 3]: http://fsf.org (The free software foundation)
4716 [my label 4]: /bar#special 'A title in single quotes'
2908 [my label 4]: /bar#special 'A title in single quotes'
4717
2909
4718The URL may optionally be surrounded by angle brackets:
2910The URL may optionally be surrounded by angle brackets:
@@ -4721,7 +2913,7 @@ The URL may optionally be surrounded by angle brackets:
4721
2913
4722The title may go on the next line:
2914The title may go on the next line:
4723
2915
4724− [my label 3]: https://fsf.org
2916+ [my label 3]: http://fsf.org
4725 "The free software foundation"
2917 "The free software foundation"
4726
2918
4727Note that link labels are not case sensitive. So, this will work:
2919Note that link labels are not case sensitive. So, this will work:
@@ -4759,7 +2951,7 @@ be omitted entirely:
4759### Internal links ###
2951### Internal links ###
4760
2952
4761To link to another section of the same document, use the automatically
2953To link to another section of the same document, use the automatically
4762−generated identifier (see [Heading identifiers]). For example:
2954+generated identifier (see [Header identifiers]). For example:
4763
2955
4764 See the [Introduction](#introduction).
2956 See the [Introduction](#introduction).
4765
2957
@@ -4772,7 +2964,8 @@ or
4772Internal links are currently supported for HTML formats (including
2964Internal links are currently supported for HTML formats (including
4773HTML slide shows and EPUB), LaTeX, and ConTeXt.
2965HTML slide shows and EPUB), LaTeX, and ConTeXt.
4774
2966
4775−## Images
2967+Images
2968+------
4776
2969
4777A link immediately preceded by a `!` will be treated as an image.
2970A link immediately preceded by a `!` will be treated as an image.
4778The link text will be used as the image's alt text:
2971The link text will be used as the image's alt text:
@@ -4785,26 +2978,23 @@ The link text will be used as the image's alt text:
4785
2978
4786#### Extension: `implicit_figures` ####
2979#### Extension: `implicit_figures` ####
4787
2980
4788−An image with nonempty alt text, occurring by itself in a
2981+An image occurring by itself in a paragraph will be rendered as
4789−paragraph, will be rendered as a figure with a caption. The
2982+a figure with a caption.[^5] (In LaTeX, a figure environment will be
2983+used; in HTML, the image will be placed in a `div` with class
2984+`figure`, together with a caption in a `p` with class `caption`.)
4790−image's alt text will be used as the caption.
2985+The image's alt text will be used as the caption.
4791
2986
4792 ![This is the caption](/url/of/image.png)
2987 ![This is the caption](/url/of/image.png)
4793
2988
4794−How this is rendered depends on the output format. Some output
2989+[^5]: This feature is not yet implemented for RTF, OpenDocument, or
4795−formats (e.g. RTF) do not yet support figures. In those
4796−formats, you'll just get an image in a paragraph by itself, with
2990+ ODT. In those formats, you'll just get an image in a paragraph by
4797−no caption.
2991+ itself, with no caption.
4798
2992
4799If you just want a regular inline image, just make sure it is not
2993If you just want a regular inline image, just make sure it is not
4800the only thing in the paragraph. One way to do this is to insert a
2994the only thing in the paragraph. One way to do this is to insert a
4801nonbreaking space after the image:
2995nonbreaking space after the image:
4802
2996
4803− ![This image won't be a figure](/url/of/image.png)\
2997+ ![This image won't be a figure](/url/of/image.png)\
4804−
4805−Note that in reveal.js slide shows, an image in a paragraph
4806−by itself that has the `stretch` class will fill the screen,
4807−and the caption and figure tags will be omitted.
4808
2998
4809#### Extension: `link_attributes` ####
2999#### Extension: `link_attributes` ####
4810
3000
@@ -4818,11 +3008,10 @@ Attributes can be set on links and images:
4818(This syntax is compatible with [PHP Markdown Extra] when only `#id`
3008(This syntax is compatible with [PHP Markdown Extra] when only `#id`
4819and `.class` are used.)
3009and `.class` are used.)
4820
3010
4821−For HTML and EPUB, all known HTML5 attributes except `width` and
3011+For HTML and EPUB, all attributes except `width` and `height` (but
4822−`height` (but including `srcset` and `sizes`) are passed through
3012+including `srcset` and `sizes`) are passed through as is. The other
4823−as is. Unknown attributes are passed through as custom
4824−attributes, with `data-` prepended. The other writers ignore
4825−attributes that are not specifically supported by their output format.
3013+writers ignore attributes that are not supported by their output
3014+format.
4826
3015
4827The `width` and `height` attributes on images are treated specially. When
3016The `width` and `height` attributes on images are treated specially. When
4828used without a unit, the unit is assumed to be pixels. However, any of
3017used without a unit, the unit is assumed to be pixels. However, any of
@@ -4834,83 +3023,25 @@ For example:
4834![](file.jpg){ width=50% }
3023![](file.jpg){ width=50% }
4835```
3024```
4836
3025
4837−- Dimensions may be converted to a form that is compatible with
3026+- Dimensions are converted to inches for output in page-based formats like
4838− the output format (for example, dimensions given in pixels will
3027+ LaTeX. Dimensions are converted to pixels for output in HTML-like
4839− be converted to inches when converting HTML to LaTeX). Conversion
3028+ formats. Use the `--dpi` option to specify the number of pixels per
4840− between pixels and physical measurements is affected by the
3029+ inch. The default is 96dpi.
4841− `--dpi` option (by default, 96 dpi is assumed, unless the image
4842− itself contains dpi information).
4843- The `%` unit is generally relative to some available space.
3030- The `%` unit is generally relative to some available space.
4844− For example the above example will render to the following.
3031+ For example the above example will render to
4845− - HTML: `<img href="file.jpg" style="width: 50%;" />`
3032+ `<img href="file.jpg" style="width: 50%;" />` (HTML),
4846− - LaTeX: `\includegraphics[width=0.5\textwidth,height=\textheight]{file.jpg}`
3033+ `\includegraphics[width=0.5\textwidth]{file.jpg}` (LaTeX), or
4847− (If you're using a custom template, you need to configure `graphicx`
3034+ `\externalfigure[file.jpg][width=0.5\textwidth]` (ConTeXt).
4848− as in the default template.)
4849− - ConTeXt: `\externalfigure[file.jpg][width=0.5\textwidth]`
4850- Some output formats have a notion of a class
3035- Some output formats have a notion of a class
4851− ([ConTeXt](https://wiki.contextgarden.net/Using_Graphics#Multiple_Image_Settings))
3036+ ([ConTeXt](http://wiki.contextgarden.net/Using_Graphics#Multiple_Image_Settings))
4852 or a unique identifier (LaTeX `\caption`), or both (HTML).
3037 or a unique identifier (LaTeX `\caption`), or both (HTML).
4853- When no `width` or `height` attributes are specified, the fallback
3038- When no `width` or `height` attributes are specified, the fallback
4854 is to look at the image resolution and the dpi metadata embedded in
3039 is to look at the image resolution and the dpi metadata embedded in
4855 the image file.
3040 the image file.
4856
3041
4857−## Divs and Spans
4858−
4859−Using the `native_divs` and `native_spans` extensions
4860−(see [above][Extension: `native_divs`]), HTML syntax can
4861−be used as part of markdown to create native `Div` and `Span`
4862−elements in the pandoc AST (as opposed to raw HTML).
4863−However, there is also nicer syntax available:
4864−
4865−#### Extension: `fenced_divs` ####
4866−
4867−Allow special fenced syntax for native `Div` blocks. A Div
4868−starts with a fence containing at least three consecutive
4869−colons plus some attributes. The attributes may optionally
4870−be followed by another string of consecutive colons.
4871−The attribute syntax is exactly as in fenced code blocks (see
4872−[Extension: `fenced_code_attributes`]). As with fenced
4873−code blocks, one can use either attributes in curly braces
4874−or a single unbraced word, which will be treated as a class
4875−name. The Div ends with another line containing a string of at
4876−least three consecutive colons. The fenced Div should be
4877−separated by blank lines from preceding and following blocks.
4878−
4879−Example:
4880−
4881− ::::: {#special .sidebar}
4882− Here is a paragraph.
4883−
4884− And another.
4885− :::::
4886−
4887−Fenced divs can be nested. Opening fences are distinguished
4888−because they *must* have attributes:
4889−
4890− ::: Warning ::::::
4891− This is a warning.
4892−
4893− ::: Danger
4894− This is a warning within a warning.
4895− :::
4896− ::::::::::::::::::
4897−
4898−Fences without attributes are always closing fences. Unlike
4899−with fenced code blocks, the number of colons in the closing
4900−fence need not match the number in the opening fence. However,
4901−it can be helpful for visual clarity to use fences of different
4902−lengths to distinguish nested divs from their parents.
4903−
4904−
4905−#### Extension: `bracketed_spans` ####
4906
3042
4907−A bracketed sequence of inlines, as one would use to begin
4908−a link, will be treated as a `Span` with attributes if it is
4909−followed immediately by attributes:
4910−
4911− [This is *some text*]{.class key="val"}
4912−
4913−## Footnotes
3043+Footnotes
3044+---------
4914
3045
4915#### Extension: `footnotes` ####
3046#### Extension: `footnotes` ####
4916
3047
@@ -4941,9 +3072,7 @@ will be numbered sequentially.
4941
3072
4942The footnotes themselves need not be placed at the end of the
3073The footnotes themselves need not be placed at the end of the
4943document. They may appear anywhere except inside other block elements
3074document. They may appear anywhere except inside other block elements
4944−(lists, block quotes, tables, etc.). Each footnote should be
3075+(lists, block quotes, tables, etc.).
4945−separated from surrounding content (including other footnotes)
4946−by blank lines.
4947
3076
4948#### Extension: `inline_notes` ####
3077#### Extension: `inline_notes` ####
4949
3078
@@ -4956,401 +3085,46 @@ they cannot contain multiple paragraphs). The syntax is as follows:
4956
3085
4957Inline and regular footnotes may be mixed freely.
3086Inline and regular footnotes may be mixed freely.
4958
3087
4959−## Citation syntax
4960−
4961−#### Extension: `citations` ####
4962−
4963−To cite a bibliographic item with an identifier foo, use the
4964−syntax `@foo`. Normal citations should be included in square
4965−brackets, with semicolons separating distinct items:
4966−
4967− Blah blah [@doe99; @smith2000; @smith2004].
4968−
4969−How this is rendered depends on the citation style. In an
4970−author-date style, it might render as
4971−
4972− Blah blah (Doe 1999, Smith 2000, 2004).
4973−
4974−In a footnote style, it might render as
4975−
4976− Blah blah.[^1]
4977−
4978− [^1]: John Doe, "Frogs," *Journal of Amphibians* 44 (1999);
4979− Susan Smith, "Flies," *Journal of Insects* (2000);
4980− Susan Smith, "Bees," *Journal of Insects* (2004).
4981−
4982−See the [CSL user documentation] for more information about CSL
4983−styles and how they affect rendering.
4984−
4985−Unless a citation key start with a letter, digit, or `_`,
4986−and contains only alphanumerics and internal punctuation
4987−characters (`:.#$%&-+?<>~/`), it must be surrounded
4988−by curly braces, which are not considered part of the key.
4989−In `@Foo_bar.baz.`, the key is `Foo_bar.baz`. The final
4990−period is not *internal* punctuation, so it is not included in
4991−the key. In `@{Foo_bar.baz.}`, the key is `Foo_bar.baz.`, including
4992−the final period. The curly braces are recommended if you use URLs as
4993−keys: `[@{https://example.com/bib?name=foobar&date=2000}, p. 33]`.
4994−
4995−Citation items may optionally include a prefix, a locator, and
4996−a suffix. In
4997−
4998− Blah blah [see @doe99, pp. 33-35 and *passim*; @smith04, chap. 1].
4999−
5000−The first item (`doe99`) has prefix `see `, locator `pp. 33-35`,
5001−and suffix `and *passim*`. The second item (`smith04`) has
5002−locator `chap. 1` and no prefix or suffix.
5003−
5004−Pandoc uses some heuristics to separate the locator from the
5005−rest of the subject. It is sensitive to the locator terms
5006−defined in the [CSL locale files]. Either abbreviated or
5007−unabbreviated forms are accepted. In the `en-US` locale, locator
5008−terms can be written in either singular or plural forms, as
5009−`book`, `bk.`/`bks.`; `chapter`, `chap.`/`chaps.`; `column`,
5010−`col.`/`cols.`; `figure`, `fig.`/`figs.`; `folio`,
5011−`fol.`/`fols.`; `number`, `no.`/`nos.`; `line`, `l.`/`ll.`;
5012−`note`, `n.`/`nn.`; `opus`, `op.`/`opp.`; `page`, `p.`/`pp.`;
5013−`paragraph`, `para.`/`paras.`; `part`, `pt.`/`pts.`; `section`,
5014−`sec.`/`secs.`; `sub verbo`, `s.v.`/`s.vv.`; `verse`,
5015−`v.`/`vv.`; `volume`, `vol.`/`vols.`; `¶`/`¶¶`; `§`/`§§`. If no
5016−locator term is used, "page" is assumed.
5017−
5018−In complex cases, you can force something to be treated as
5019−a locator by enclosing it in curly braces or prevent parsing
5020−the suffix as locator by prepending curly braces:
5021−
5022− [@smith{ii, A, D-Z}, with a suffix]
5023− [@smith, {pp. iv, vi-xi, (xv)-(xvii)} with suffix here]
5024− [@smith{}, 99 years later]
5025−
5026−A minus sign (`-`) before the `@` will suppress mention of
5027−the author in the citation. This can be useful when the
5028−author is already mentioned in the text:
5029−
5030− Smith says blah [-@smith04].
5031−
5032−You can also write an author-in-text citation, by omitting the
5033−square brackets:
5034−
5035− @smith04 says blah.
5036−
5037− @smith04 [p. 33] says blah.
5038−
5039−This will cause the author's name to be rendered, followed by
5040−the bibliographical details. Use this form when you want to
5041−make the citation the subject of a sentence.
5042−
5043−When you are using a note style, it is usually better to let
5044−citeproc create the footnotes from citations rather than writing
5045−an explicit note. If you do write an explicit note that
5046−contains a citation, note that normal citations will be put in
5047−parentheses, while author-in-text citations will not. For
5048−this reason, it is sometimes preferable to use the
5049−author-in-text style inside notes when using a note style.
5050−
5051−[CSL user documentation]: https://citationstyles.org/authors/
5052−[CSL]: https://docs.citationstyles.org/en/stable/specification.html
5053−[CSL markup specs]: https://docs.citationstyles.org/en/1.0/release-notes.html#rich-text-markup-within-fields
5054−[Chicago Manual of Style]: https://chicagomanualofstyle.org
5055−[Citation Style Language]: https://citationstyles.org
5056−[Zotero Style Repository]: https://www.zotero.org/styles
5057−[finding and editing styles]: https://citationstyles.org/authors/
5058−[CSL locale files]: https://github.com/citation-style-language/locales
5059−
5060−## Non-default extensions
5061−
5062−The following Markdown syntax extensions are not enabled by default
5063−in pandoc, but may be enabled by adding `+EXTENSION` to the format
5064−name, where `EXTENSION` is the name of the extension. Thus, for
5065−example, `markdown+hard_line_breaks` is Markdown with hard line breaks.
5066−
5067−#### Extension: `rebase_relative_paths` ####
5068−
5069−Rewrite relative paths for Markdown links and images, depending
5070−on the path of the file containing the link or image link. For
5071−each link or image, pandoc will compute the directory of the
5072−containing file, relative to the working directory, and prepend
5073−the resulting path to the link or image path.
5074−
5075−The use of this extension is best understood by example.
5076−Suppose you have a a subdirectory for each chapter of a book,
5077−`chap1`, `chap2`, `chap3`. Each contains a file `text.md` and a
5078−number of images used in the chapter. You would like to have
5079−`![image](spider.jpg)` in `chap1/text.md` refer to
5080−`chap1/spider.jpg` and `![image](spider.jpg)` in `chap2/text.md`
5081−refer to `chap2/spider.jpg`. To do this, use
5082−
5083− pandoc chap*/*.md -f markdown+rebase_relative_paths
5084−
5085−Without this extension, you would have to use
5086−`![image](chap1/spider.jpg)` in `chap1/text.md` and
5087−`![image](chap2/spider.jpg)` in `chap2/text.md`. Links with
5088−relative paths will be rewritten in the same way as images.
5089−
5090−Absolute paths and URLs are not changed. Neither are empty
5091−paths or paths consisting entirely of a fragment, e.g., `#foo`.
5092−
5093−Note that relative paths in reference links and images will
5094−be rewritten relative to the file containing the link
5095−reference definition, not the file containing the reference link
5096−or image itself, if these differ.
5097−
5098−#### Extension: `attributes` ####
5099−
5100−Allows attributes to be attached to any inline or block-level
5101−element. The syntax for the attributes is the same as that
5102−used in [`header_attributes`][Extension: `header_attributes`].
5103−
5104−- Attributes that occur immediately after an inline
5105− element affect that element. If they follow a space, then they
5106− belong to the space. (Hence, this option subsumes
5107− `inline_code_attributes` and `link_attributes`.)
5108−- Attributes that occur immediately before a block
5109− element, on a line by themselves, affect that
5110− element.
5111−- Consecutive attribute specifiers may be used,
5112− either for blocks or for inlines. Their attributes
5113− will be combined.
5114−- Attributes that occur at the end of the text of
5115− a Setext or ATX heading (separated by whitespace
5116− from the text) affect the heading element. (Hence, this
5117− option subsumes `header_attributes`.)
5118−- Attributes that occur after the opening fence
5119− in a fenced code block affect the code block element. (Hence,
5120− this option subsumes `fenced_code_attributes`.)
5121−- Attributes that occur at the end of a reference
5122− link definition affect links that refer to that
5123− definition.
5124−
5125−Note that pandoc's AST does not currently allow attributes
5126−to be attached to arbitrary elements. Hence a Span or Div
5127−container will be added if needed.
5128−
5129−#### Extension: `old_dashes` ####
5130−
5131−Selects the pandoc <= 1.8.2.1 behavior for parsing smart dashes:
5132−`-` before a numeral is an en-dash, and `--` is an em-dash.
5133−This option only has an effect if `smart` is enabled. It is
5134−selected automatically for `textile` input.
5135−
5136−#### Extension: `angle_brackets_escapable` ####
5137−
5138−Allow `<` and `>` to be backslash-escaped, as they can be in
5139−GitHub flavored Markdown but not original Markdown. This is
5140−implied by pandoc's default `all_symbols_escapable`.
5141−
5142−#### Extension: `lists_without_preceding_blankline` ####
5143−
5144−Allow a list to occur right after a paragraph, with no intervening
5145−blank space.
5146−
5147−#### Extension: `four_space_rule` ####
5148−
5149−Selects the pandoc <= 2.0 behavior for parsing lists, so that
5150−four spaces indent are needed for list item continuation
5151−paragraphs.
5152−
5153−#### Extension: `spaced_reference_links` ####
5154−
5155−Allow whitespace between the two components of a reference link,
5156−for example,
5157−
5158− [foo] [bar].
5159−
5160−#### Extension: `hard_line_breaks` ####
5161−
5162−Causes all newlines within a paragraph to be interpreted as hard line
5163−breaks instead of spaces.
5164−
5165−#### Extension: `ignore_line_breaks` ####
5166−
5167−Causes newlines within a paragraph to be ignored, rather than being
5168−treated as spaces or as hard line breaks. This option is intended for
5169−use with East Asian languages where spaces are not used between words,
5170−but text is divided into lines for readability.
5171−
5172−#### Extension: `east_asian_line_breaks` ####
5173−
5174−Causes newlines within a paragraph to be ignored, rather than
5175−being treated as spaces or as hard line breaks, when they occur
5176−between two East Asian wide characters. This is a better choice
5177−than `ignore_line_breaks` for texts that include a mix of East
5178−Asian wide characters and other characters.
5179−
5180−#### Extension: `emoji` ####
5181−
5182−Parses textual emojis like `:smile:` as Unicode emoticons.
5183−
5184−#### Extension: `tex_math_single_backslash` ####
5185−
5186−Causes anything between `\(` and `\)` to be interpreted as inline
5187−TeX math, and anything between `\[` and `\]` to be interpreted
5188−as display TeX math. Note: a drawback of this extension is that
5189−it precludes escaping `(` and `[`.
5190−
5191−#### Extension: `tex_math_double_backslash` ####
5192−
5193−Causes anything between `\\(` and `\\)` to be interpreted as inline
5194−TeX math, and anything between `\\[` and `\\]` to be interpreted
5195−as display TeX math.
5196−
5197−#### Extension: `markdown_attribute` ####
5198−
5199−By default, pandoc interprets material inside block-level tags as Markdown.
5200−This extension changes the behavior so that Markdown is only parsed
5201−inside block-level tags if the tags have the attribute `markdown=1`.
5202−
5203−#### Extension: `mmd_title_block` ####
5204−
5205−Enables a [MultiMarkdown] style title block at the top of
5206−the document, for example:
5207−
5208− Title: My title
5209− Author: John Doe
5210− Date: September 1, 2008
5211− Comment: This is a sample mmd title block, with
5212− a field spanning multiple lines.
5213−
5214−See the MultiMarkdown documentation for details. If `pandoc_title_block` or
5215−`yaml_metadata_block` is enabled, it will take precedence over
5216−`mmd_title_block`.
5217−
5218−#### Extension: `abbreviations` ####
5219−
5220−Parses PHP Markdown Extra abbreviation keys, like
5221−
5222− *[HTML]: Hypertext Markup Language
5223−
5224−Note that the pandoc document model does not support
5225−abbreviations, so if this extension is enabled, abbreviation keys are
5226−simply skipped (as opposed to being parsed as paragraphs).
5227−
5228−#### Extension: `autolink_bare_uris` ####
5229−
5230−Makes all absolute URIs into links, even when not surrounded by
5231−pointy braces `<...>`.
5232−
5233−#### Extension: `mmd_link_attributes` ####
5234−
5235−Parses multimarkdown style key-value attributes on link
5236−and image references. This extension should not be confused with the
5237−[`link_attributes`](#extension-link_attributes) extension.
5238−
5239− This is a reference ![image][ref] with multimarkdown attributes.
5240−
5241− [ref]: https://path.to/image "Image title" width=20px height=30px
5242− id=myId class="myClass1 myClass2"
5243−
5244−#### Extension: `mmd_header_identifiers` ####
5245−
5246−Parses multimarkdown style heading identifiers (in square brackets,
5247−after the heading but before any trailing `#`s in an ATX heading).
5248−
5249−#### Extension: `compact_definition_lists` ####
5250−
5251−Activates the definition list syntax of pandoc 1.12.x and earlier.
5252−This syntax differs from the one described above under [Definition lists]
5253−in several respects:
5254−
5255− - No blank line is required between consecutive items of the
5256− definition list.
5257− - To get a "tight" or "compact" list, omit space between consecutive
5258− items; the space between a term and its definition does not affect
5259− anything.
5260− - Lazy wrapping of paragraphs is not allowed: the entire definition must
5261− be indented four spaces.[^6]
5262−
5263−[^6]: To see why laziness is incompatible with relaxing the requirement
5264− of a blank line between items, consider the following example:
5265−
5266− bar
5267− : definition
5268− foo
5269− : definition
5270−
5271− Is this a single list item with two definitions of "bar," the first of
5272− which is lazily wrapped, or two list items? To remove the ambiguity
5273− we must either disallow lazy wrapping or require a blank line between
5274− list items.
5275−
5276−#### Extension: `gutenberg` ####
5277−
5278−Use [Project Gutenberg] conventions for `plain` output:
5279−all-caps for strong emphasis, surround by underscores
5280−for regular emphasis, add extra blank space around headings.
5281−
5282− [Project Gutenberg]: https://www.gutenberg.org
5283−
5284−#### Extension: `sourcepos` ####
5285−
5286−Include source position attributes when parsing `commonmark`.
5287−For elements that accept attributes, a `data-pos` attribute
5288−is added; other elements are placed in a surrounding
5289−Div or Span elemnet with a `data-pos` attribute.
5290−
5291−## Markdown variants
5292−
5293−In addition to pandoc's extended Markdown, the following Markdown
5294−variants are supported:
5295−
5296−- `markdown_phpextra` (PHP Markdown Extra)
5297−- `markdown_github` (deprecated GitHub-Flavored Markdown)
5298−- `markdown_mmd` (MultiMarkdown)
5299−- `markdown_strict` (Markdown.pl)
5300−- `commonmark` (CommonMark)
5301−- `gfm` (Github-Flavored Markdown)
5302−- `commonmark_x` (CommonMark with many pandoc extensions)
5303−
5304−To see which extensions are supported for a given format,
5305−and which are enabled by default, you can use the command
5306−
5307− pandoc --list-extensions=FORMAT
5308−
5309−where `FORMAT` is replaced with the name of the format.
5310
3088
5311−Note that the list of extensions for `commonmark`,
3089+Citations
5312−`gfm`, and `commonmark_x` are defined relative to default
3090+---------
5313−commonmark. So, for example, `backtick_code_blocks`
5314−does not appear as an extension, since it is enabled by
5315−default and cannot be disabled.
5316
3091
5317−# Citations
3092+#### Extension: `citations` ####
5318
3093
5319−When the `--citeproc` option is used, pandoc can automatically generate
3094+Using an external filter, `pandoc-citeproc`, pandoc can automatically generate
5320citations and a bibliography in a number of styles. Basic usage is
3095citations and a bibliography in a number of styles. Basic usage is
5321
3096
5322− pandoc --citeproc myinput.txt
3097+ pandoc --filter pandoc-citeproc myinput.txt
5323−
5324−To use this feature, you will need to have
5325−
5326−- a document containing citations (see [Extension: `citations`]);
5327−- a source of bibliographic data: either an external bibliography
5328− file or a list of `references` in the document's YAML metadata
5329−- optionally, a [CSL] citation style.
5330−
5331−## Specifying bibliographic data
5332
3098
5333−You can specify an external bibliography using the
3099+In order to use this feature, you will need to specify a bibliography file
5334−`bibliography` metadata field in a YAML metadata section or the
3100+using the `bibliography` metadata field in a YAML metadata section, or
5335−`--bibliography` command line argument. If you want to use
3101+`--bibliography` command line argument. You can supply multiple `--bibliography`
5336−multiple bibliography files, you can supply multiple
5337−`--bibliography` arguments or set `bibliography` metadata field
3102+arguments or set `bibliography` metadata field to YAML array, if you want to
5338−to YAML array. A bibliography may have any of these formats:
3103+use multiple bibliography files. The bibliography may have any of these
3104+formats:
5339
3105
5340 Format File extension
3106 Format File extension
5341 ------------ --------------
3107 ------------ --------------
5342 BibLaTeX .bib
3108 BibLaTeX .bib
5343 BibTeX .bibtex
3109 BibTeX .bibtex
3110+ Copac .copac
5344 CSL JSON .json
3111 CSL JSON .json
5345 CSL YAML .yaml
3112 CSL YAML .yaml
3113+ EndNote .enl
3114+ EndNote XML .xml
3115+ ISI .wos
3116+ MEDLINE .medline
3117+ MODS .mods
3118+ RIS .ris
5346
3119
5347Note that `.bib` can be used with both BibTeX and BibLaTeX files;
3120Note that `.bib` can be used with both BibTeX and BibLaTeX files;
5348−use the extension `.bibtex` to force interpretation as BibTeX.
3121+use `.bibtex` to force BibTeX.
5349
3122
3123+Note that `pandoc-citeproc --bib2json` and `pandoc-citeproc --bib2yaml`
3124+can produce `.json` and `.yaml` files from any of the supported formats.
3125+
5350−In BibTeX and BibLaTeX databases, pandoc parses LaTeX markup
3126+In-field markup: In BibTeX and BibLaTeX databases, pandoc-citeproc parses
5351−inside fields such as `title`; in CSL YAML databases, pandoc
5352−Markdown; and in CSL JSON databases, an [HTML-like markup][CSL
3127+a subset of LaTeX markup; in CSL YAML databases, pandoc Markdown; and in CSL JSON databases, an [HTML-like markup][CSL markup specs]:
5353−markup specs]:
5354
3128
5355`<i>...</i>`
3129`<i>...</i>`
5356: italics
3130: italics
@@ -5370,11 +3144,14 @@ markup specs]:
5370`<span class="nocase">...</span>`
3144`<span class="nocase">...</span>`
5371: prevent a phrase from being capitalized as title case
3145: prevent a phrase from being capitalized as title case
5372
3146
3147+`pandoc-citeproc -j` and `-y` interconvert the CSL JSON
3148+and CSL YAML formats as far as possible.
3149+
5373−As an alternative to specifying a bibliography file using
3150+As an alternative to specifying a bibliography file using `--bibliography`
5374−`--bibliography` or the YAML metadata field `bibliography`, you
3151+or the YAML metadata field `bibliography`, you can include
5375−can include the citation data directly in the `references` field
3152+the citation data directly in the `references` field of the
5376−of the document's YAML metadata. The field should contain an
3153+document's YAML metadata. The field should contain an array of
5377−array of YAML-encoded references, for example:
3154+YAML-encoded references, for example:
5378
3155
5379 ---
3156 ---
5380 references:
3157 references:
@@ -5390,279 +3167,294 @@ array of YAML-encoded references, for example:
5390 - - 1953
3167 - - 1953
5391 - 4
3168 - 4
5392 - 25
3169 - 25
5393− title: 'Molecular structure of nucleic acids: a structure for
3170+ title: 'Molecular structure of nucleic acids: a structure for deoxyribose
5394− deoxyribose nucleic acid'
3171+ nucleic acid'
5395 title-short: Molecular structure of nucleic acids
3172 title-short: Molecular structure of nucleic acids
5396 container-title: Nature
3173 container-title: Nature
5397 volume: 171
3174 volume: 171
5398 issue: 4356
3175 issue: 4356
5399 page: 737-738
3176 page: 737-738
5400 DOI: 10.1038/171737a0
3177 DOI: 10.1038/171737a0
5401− URL: https://www.nature.com/articles/171737a0
3178+ URL: http://www.nature.com/nature/journal/v171/n4356/abs/171737a0.html
5402 language: en-GB
3179 language: en-GB
5403 ...
3180 ...
5404
3181
5405−If both an external bibliography and inline (YAML metadata)
3182+(`pandoc-citeproc --bib2yaml` can produce these from a bibliography file in one
5406−references are provided, both will be used. In case of
3183+of the supported formats.)
5407−conflicting `id`s, the inline references will take precedence.
3184+
3185+Citations and references can be formatted using any style supported by the
3186+[Citation Style Language], listed in the [Zotero Style Repository].
3187+These files are specified using the `--csl` option or the `csl` metadata field.
3188+By default, `pandoc-citeproc` will use the [Chicago Manual of Style] author-date
3189+format. The CSL project provides further information on [finding and editing styles].
3190+
3191+To make your citations hyperlinks to the corresponding bibliography
3192+entries, add `link-citations: true` to your YAML metadata.
3193+
3194+Citations go inside square brackets and are separated by semicolons.
3195+Each citation must have a key, composed of '@' + the citation
3196+identifier from the database, and may optionally have a prefix,
3197+a locator, and a suffix. The citation key must begin with a letter, digit,
3198+or `_`, and may contain alphanumerics, `_`, and internal punctuation
3199+characters (`:.#$%&-+?<>~/`). Here are some examples:
3200+
3201+ Blah blah [see @doe99, pp. 33-35; also @smith04, chap. 1].
3202+
3203+ Blah blah [@doe99, pp. 33-35, 38-39 and *passim*].
3204+
3205+ Blah blah [@smith04; @doe99].
3206+
3207+`pandoc-citeproc` detects locator terms in the [CSL locale files].
3208+Either abbreviated or unabbreviated forms are accepted. In the `en-US`
3209+locale, locator terms can be written in either singular or plural forms,
3210+as `book`, `bk.`/`bks.`; `chapter`, `chap.`/`chaps.`; `column`,
3211+`col.`/`cols.`; `figure`, `fig.`/`figs.`; `folio`, `fol.`/`fols.`;
3212+`number`, `no.`/`nos.`; `line`, `l.`/`ll.`; `note`, `n.`/`nn.`; `opus`,
3213+`op.`/`opp.`; `page`, `p.`/`pp.`; `paragraph`, `para.`/`paras.`; `part`,
3214+`pt.`/`pts.`; `section`, `sec.`/`secs.`; `sub verbo`, `s.v.`/`s.vv.`;
3215+`verse`, `v.`/`vv.`; `volume`, `vol.`/`vols.`; `¶`/`¶¶`; `§`/`§§`. If no
3216+locator term is used, "page" is assumed.
3217+
3218+A minus sign (`-`) before the `@` will suppress mention of
3219+the author in the citation. This can be useful when the
3220+author is already mentioned in the text:
3221+
3222+ Smith says blah [-@smith04].
3223+
3224+You can also write an in-text citation, as follows:
5408
3225
5409−Note that `pandoc` can be used to produce such a YAML metadata
3226+ @smith04 says blah.
5410−section from a BibTeX, BibLaTeX, or CSL JSON bibliography:
5411
3227
5412− pandoc chem.bib -s -f biblatex -t markdown
3228+ @smith04 [p. 33] says blah.
5413− pandoc chem.json -s -f csljson -t markdown
5414
3229
5415−Indeed, `pandoc` can convert between any of these
3230+If the style calls for a list of works cited, it will be placed
5416−citation formats:
3231+at the end of the document. Normally, you will want to end your
3232+document with an appropriate header:
5417
3233
5418− pandoc chem.bib -s -f biblatex -t csljson
3234+ last paragraph...
5419− pandoc chem.yaml -s -f markdown -t biblatex
5420
3235
5421−Running pandoc on a bibliography file with the `--citeproc`
3236+ # References
5422−option will create a formatted bibliography in the format
5423−of your choice:
5424
3237
5425− pandoc chem.bib -s --citeproc -o chem.html
3238+The bibliography will be inserted after this header. Note that
5426− pandoc chem.bib -s --citeproc -o chem.pdf
3239+the `unnumbered` class will be added to this header, so that the
3240+section will not be numbered.
5427
3241
5428−### Capitalization in titles
3242+If you want to include items in the bibliography without actually
3243+citing them in the body text, you can define a dummy `nocite` metadata
3244+field and put the citations there:
5429
3245
5430−If you are using a bibtex or biblatex bibliography, then observe
3246+ ---
5431−the following rules:
3247+ nocite: |
3248+ @item1, @item2
3249+ ...
5432
3250
5433− - English titles should be in title case. Non-English titles should
3251+ @item3
5434− be in sentence case, and the `langid` field in biblatex should be
5435− set to the relevant language. (The following values are treated
5436− as English: `american`, `british`, `canadian`, `english`,
5437− `australian`, `newzealand`, `USenglish`, or `UKenglish`.)
5438
3252
5439− - As is standard with bibtex/biblatex, proper names should be
3253+In this example, the document will contain a citation for `item3`
5440− protected with curly braces so that they won't be lowercased
3254+only, but the bibliography will contain entries for `item1`, `item2`, and
5441− in styles that call for sentence case. For example:
3255+`item3`.
5442
3256
5443− title = {My Dinner with {Andre}}
3257+For LaTeX or PDF output, you can also use [`natbib`] or [`biblatex`]
3258+to render bibliography. In order to do so, specify bibliography files as
3259+outlined above, and add `--natbib` or `--biblatex` argument to `pandoc`
3260+invocation. Bear in mind that bibliography files have to be in respective
3261+format (either BibTeX or BibLaTeX).
5444
3262
5445− - In addition, words that should remain lowercase (or camelCase)
3263+For more information, see the [pandoc-citeproc man page].
5446− should be protected:
5447
3264
5448− title = {Spin Wave Dispersion on the {nm} Scale}
3265+[CSL markup specs]: http://docs.citationstyles.org/en/1.0/release-notes.html#rich-text-markup-within-fields
3266+[Chicago Manual of Style]: http://chicagomanualofstyle.org
3267+[Citation Style Language]: http://citationstyles.org
3268+[Zotero Style Repository]: https://www.zotero.org/styles
3269+[finding and editing styles]: http://citationstyles.org/styles/
3270+[CSL locale files]: https://github.com/citation-style-language/locales
3271+[pandoc-citeproc man page]: https://github.com/jgm/pandoc-citeproc/blob/master/man/pandoc-citeproc.1.md
5449
3272
5450− Though this is not necessary in bibtex/biblatex, it is necessary
3273+Non-pandoc extensions
5451− with citeproc, which stores titles internally in sentence case,
3274+---------------------
5452− and converts to title case in styles that require it. Here we
5453− protect "nm" so that it doesn't get converted to "Nm" at this stage.
5454
3275
5455−If you are using a CSL bibliography (either JSON or YAML), then observe
3276+The following Markdown syntax extensions are not enabled by default
5456−the following rules:
3277+in pandoc, but may be enabled by adding `+EXTENSION` to the format
3278+name, where `EXTENSION` is the name of the extension. Thus, for
3279+example, `markdown+hard_line_breaks` is Markdown with hard line breaks.
5457
3280
5458− - All titles should be in sentence case.
3281+#### Extension: `lists_without_preceding_blankline` ####
5459
3282
5460− - Use the `language` field for non-English titles to prevent their
3283+Allow a list to occur right after a paragraph, with no intervening
5461− conversion to title case in styles that call for this. (Conversion
3284+blank space.
5462− happens only if `language` begins with `en` or is left empty.)
5463
3285
5464− - Protect words that should not be converted to title case using
3286+#### Extension: `hard_line_breaks` ####
5465− this syntax:
5466
3287
5467− Spin wave dispersion on the <span class="nocase">nm</span> scale
3288+Causes all newlines within a paragraph to be interpreted as hard line
3289+breaks instead of spaces.
5468
3290
5469−### Conference Papers, Published vs. Unpublished
3291+#### Extension: `ignore_line_breaks` ####
5470
3292
5471−For a formally published conference paper, use the biblatex entry type
3293+Causes newlines within a paragraph to be ignored, rather than being
5472−`inproceedings` (which will be mapped to CSL `paper-conference`).
3294+treated as spaces or as hard line breaks. This option is intended for
3295+use with East Asian languages where spaces are not used between words,
3296+but text is divided into lines for readability.
5473
3297
5474−For an unpublished manuscript, use the biblatex entry type
3298+#### Extension: `east_asian_line_breaks` ####
5475−`unpublished` without an `eventtitle` field (this entry type
5476−will be mapped to CSL `manuscript`).
5477
3299
5478−For a talk, an unpublished conference paper, or a poster
3300+Causes newlines within a paragraph to be ignored, rather than
5479−presentation, use the biblatex entry type `unpublished` with an
3301+being treated as spaces or as hard line breaks, when they occur
5480−`eventtitle` field (this entry type will be mapped to CSL
3302+between two East Asian wide characters. This is a better choice
5481−`speech`). Use the biblatex `type` field to indicate the type,
3303+than `ignore_line_breaks` for texts that include a mix of East
5482−e.g. "Paper", or "Poster". `venue` and `eventdate` may be useful
3304+Asian wide characters and other characters.
5483−too, though `eventdate` will not be rendered by most CSL styles.
5484−Note that `venue` is for the event's venue, unlike `location`
5485−which describes the publisher's location; do not use the latter
5486−for an unpublished conference paper.
5487
3305
3306+##### Extension: `emoji` ####
5488
3307
5489−## Specifying a citation style
3308+Parses textual emojis like `:smile:` as Unicode emoticons.
5490
3309
5491−Citations and references can be formatted using any style supported by the
3310+#### Extension: `tex_math_single_backslash` ####
5492−[Citation Style Language], listed in the [Zotero Style Repository].
5493−These files are specified using the `--csl` option or the `csl`
5494−(or `citation-style`) metadata field. By default, pandoc will
5495−use the [Chicago Manual of Style] author-date format. (You can
5496−override this default by copying a CSL style of your choice
5497−to `default.csl` in your user data directory.)
5498−The CSL project provides further information on [finding and
5499−editing styles].
5500−
5501−The `--citation-abbreviations` option (or the
5502−`citation-abbreviations` metadata field) may be used to specify
5503−a JSON file containing abbreviations of journals that should be
5504−used in formatted bibliographies when `form="short"` is
5505−specified. The format of the file can be illustrated with an
5506−example:
5507
3311
3312+Causes anything between `\(` and `\)` to be interpreted as inline
3313+TeX math, and anything between `\[` and `\]` to be interpreted
3314+as display TeX math. Note: a drawback of this extension is that
3315+it precludes escaping `(` and `[`.
5508
3316
5509− { "default": {
3317+#### Extension: `tex_math_double_backslash` ####
5510− "container-title": {
5511− "Lloyd's Law Reports": "Lloyd's Rep",
5512− "Estates Gazette": "EG",
5513− "Scots Law Times": "SLT"
5514− }
5515− }
5516− }
5517
3318
3319+Causes anything between `\\(` and `\\)` to be interpreted as inline
3320+TeX math, and anything between `\\[` and `\\]` to be interpreted
3321+as display TeX math.
5518
3322
5519−## Citations in note styles
3323+#### Extension: `markdown_attribute` ####
5520
3324
5521−Pandoc's citation processing is designed to allow you to
3325+By default, pandoc interprets material inside block-level tags as Markdown.
5522−move between author-date, numerical, and note styles without
3326+This extension changes the behavior so that Markdown is only parsed
5523−modifying the markdown source. When you're using a note
3327+inside block-level tags if the tags have the attribute `markdown=1`.
5524−style, avoid inserting footnotes manually. Instead, insert
5525−citations just as you would in an author-date style---for
5526−example,
5527
3328
5528− Blah blah [@foo, p. 33].
3329+#### Extension: `mmd_title_block` ####
5529
3330
5530−The footnote will be created automatically. Pandoc will take
3331+Enables a [MultiMarkdown] style title block at the top of
5531−care of removing the space and moving the note before or
3332+the document, for example:
5532−after the period, depending on the setting of
5533−`notes-after-punctuation`, as described below in [Other relevant
5534−metadata fields].
5535
3333
5536−In some cases you may need to put a citation inside a regular
3334+ Title: My title
5537−footnote. Normal citations in footnotes (such as `[@foo, p.
3335+ Author: John Doe
5538−33]`) will be rendered in parentheses. In-text citations (such
3336+ Date: September 1, 2008
5539−as `@foo [p. 33]`) will be rendered without parentheses. (A
3337+ Comment: This is a sample mmd title block, with
5540−comma will be added if appropriate.) Thus:
3338+ a field spanning multiple lines.
5541
3339
5542− [^1]: Some studies [@foo; @bar, p. 33] show that
3340+See the MultiMarkdown documentation for details. If `pandoc_title_block` or
5543− frubulicious zoosnaps are quantical. For a survey
3341+`yaml_metadata_block` is enabled, it will take precedence over
5544− of the literature, see @baz [chap. 1].
3342+`mmd_title_block`.
5545
3343
5546−## Raw content in a style
3344+#### Extension: `abbreviations` ####
5547
3345
5548−To include raw content in a prefix, suffix, delimiter, or term,
3346+Parses PHP Markdown Extra abbreviation keys, like
5549−surround it with these tags indicating the format:
5550
3347
5551− {{jats}}&lt;ref&gt;{{/jats}}
3348+ *[HTML]: Hypertext Markup Language
5552
3349
5553−Without the tags, the string will be interpreted as a string
3350+Note that the pandoc document model does not support
5554−and escaped in the output, rather than being passed through raw.
3351+abbreviations, so if this extension is enabled, abbreviation keys are
3352+simply skipped (as opposed to being parsed as paragraphs).
5555
3353
5556−This feature allows stylesheets to be customized to give
3354+#### Extension: `autolink_bare_uris` ####
5557−different output for different output formats. However,
5558−stylesheets customized in this way will not be usable
5559−by other CSL implementations.
5560
3355
3356+Makes all absolute URIs into links, even when not surrounded by
3357+pointy braces `<...>`.
5561
3358
3359+#### Extension: `ascii_identifiers` ####
5562
3360
5563−## Placement of the bibliography
3361+Causes the identifiers produced by `auto_identifiers` to be pure ASCII.
3362+Accents are stripped off of accented latin letters, and non-latin
3363+letters are omitted.
5564
3364
5565−If the style calls for a list of works cited, it will be placed
3365+#### Extension: `mmd_link_attributes` ####
5566−in a div with id `refs`, if one exists:
5567
3366
5568− ::: {#refs}
3367+Parses multimarkdown style key-value attributes on link
5569− :::
3368+and image references. This extension should not be confused with the
3369+[`link_attributes`](#extension-link_attributes) extension.
5570
3370
5571−Otherwise, it will be placed at the end of the document.
3371+ This is a reference ![image][ref] with multimarkdown attributes.
5572−Generation of the bibliography can be suppressed by setting
5573−`suppress-bibliography: true` in the YAML metadata.
5574
3372
5575−If you wish the bibliography to have a section heading, you can
3373+ [ref]: http://path.to/image "Image title" width=20px height=30px
5576−set `reference-section-title` in the metadata, or put the heading
3374+ id=myId class="myClass1 myClass2"
5577−at the beginning of the div with id `refs` (if you are using it)
5578−or at the end of your document:
5579
3375
5580− last paragraph...
3376+#### Extension: `mmd_header_identifiers` ####
5581
3377
5582− # References
3378+Parses multimarkdown style header identifiers (in square brackets,
3379+after the header but before any trailing `#`s in an ATX header).
5583
3380
5584−The bibliography will be inserted after this heading. Note that
3381+#### Extension: `compact_definition_lists` ####
5585−the `unnumbered` class will be added to this heading, so that the
5586−section will not be numbered.
5587
3382
5588−## Including uncited items in the bibliography
3383+Activates the definition list syntax of pandoc 1.12.x and earlier.
3384+This syntax differs from the one described above under [Definition lists]
3385+in several respects:
5589
3386
5590−If you want to include items in the bibliography without actually
3387+ - No blank line is required between consecutive items of the
5591−citing them in the body text, you can define a dummy `nocite` metadata
3388+ definition list.
5592−field and put the citations there:
3389+ - To get a "tight" or "compact" list, omit space between consecutive
3390+ items; the space between a term and its definition does not affect
3391+ anything.
3392+ - Lazy wrapping of paragraphs is not allowed: the entire definition must
3393+ be indented four spaces.[^6]
5593
3394
5594− ---
3395+[^6]: To see why laziness is incompatible with relaxing the requirement
5595− nocite: |
3396+ of a blank line between items, consider the following example:
5596− @item1, @item2
5597− ...
5598
3397
5599− @item3
3398+ bar
3399+ : definition
3400+ foo
3401+ : definition
5600
3402
5601−In this example, the document will contain a citation for `item3`
3403+ Is this a single list item with two definitions of "bar," the first of
5602−only, but the bibliography will contain entries for `item1`, `item2`, and
3404+ which is lazily wrapped, or two list items? To remove the ambiguity
5603−`item3`.
3405+ we must either disallow lazy wrapping or require a blank line between
3406+ list items.
5604
3407
5605−It is possible to create a bibliography with all the citations,
3408+Markdown variants
5606−whether or not they appear in the document, by using a wildcard:
3409+-----------------
5607
3410
5608− ---
3411+In addition to pandoc's extended Markdown, the following Markdown
5609− nocite: |
3412+variants are supported:
5610− @*
5611− ...
5612
3413
5613−For LaTeX output, you can also use [`natbib`] or [`biblatex`] to
3414+`markdown_phpextra` (PHP Markdown Extra)
5614−render the bibliography. In order to do so, specify bibliography
3415+: `footnotes`, `pipe_tables`, `raw_html`, `markdown_attribute`,
5615−files as outlined above, and add `--natbib` or `--biblatex`
3416+ `fenced_code_blocks`, `definition_lists`, `intraword_underscores`,
5616−argument to `pandoc` invocation. Bear in mind that bibliography
3417+ `header_attributes`, `link_attributes`, `abbreviations`,
5617−files have to be in either BibTeX (for `--natbib`)
3418+ `shortcut_reference_links`.
5618−or BibLaTeX (for `--biblatex`) format.
5619
3419
5620−## Other relevant metadata fields
3420+`markdown_github` (GitHub-Flavored Markdown)
3421+: `pipe_tables`, `raw_html`, `fenced_code_blocks`, `auto_identifiers`,
3422+ `ascii_identifiers`, `backtick_code_blocks`, `autolink_bare_uris`,
3423+ `intraword_underscores`, `strikeout`, `hard_line_breaks`, `emoji`,
3424+ `shortcut_reference_links`.
5621
3425
5622−A few other metadata fields affect bibliography formatting:
3426+`markdown_mmd` (MultiMarkdown)
3427+: `pipe_tables`, `raw_html`, `markdown_attribute`, `mmd_link_attributes`,
3428+ `raw_tex`, `tex_math_double_backslash`, `intraword_underscores`,
3429+ `mmd_title_block`, `footnotes`, `definition_lists`,
3430+ `all_symbols_escapable`, `implicit_header_references`,
3431+ `auto_identifiers`, `mmd_header_identifiers`,
3432+ `shortcut_reference_links`.
5623
3433
5624−`link-citations`
3434+`markdown_strict` (Markdown.pl)
5625−: If true, citations will be
3435+: `raw_html`
5626− hyperlinked to the corresponding bibliography entries
5627− (for author-date and numerical styles only).
5628
3436
5629−`lang`
3437+Extensions with formats other than Markdown
5630−: The `lang` field will affect how the style is localized,
3438+-------------------------------------------
5631− for example in the translation of labels, the use
3439+
5632− of quotation marks, and the way items are sorted.
3440+Some of the extensions discussed above can be used with formats
5633− (For backwards compatibility, `locale` may be used instead
3441+other than Markdown:
5634− of `lang`, but this use is deprecated.)
3442+
5635−
3443+* `auto_identifiers` can be used with `latex`, `rst`, `mediawiki`,
5636− A BCP 47 language tag is expected: for example, `en`,
3444+ and `textile` input (and is used by default).
5637− `de`, `en-US`, `fr-CA`, `ug-Cyrl`. The unicode extension
3445+
5638− syntax (after `-u-`) may be used to specify options for
3446+* `tex_math_dollars`, `tex_math_single_backslash`, and
5639− collation (sorting) more precisely. Here are some examples:
3447+ `tex_math_double_backslash` can be used with `html` input.
5640−
3448+ (This is handy for reading web pages formatted using MathJax,
5641− - `zh-u-co-pinyin` -- Chinese with the Pinyin collation.
3449+ for example.)
5642− - `es-u-co-trad` -- Spanish with the traditional collation
3450+
5643− (with `Ch` sorting after `C`).
3451+Producing slide shows with pandoc
5644− - `fr-u-kb` -- French with "backwards" accent sorting
3452+=================================
5645− (with `coté` sorting after `côte`).
3453+
5646− - `en-US-u-kf-upper` -- English with uppercase letters sorting
5647− before lower (default is lower before upper).
5648−
5649−`notes-after-punctuation`
5650−: If true (the default), pandoc will put footnote citations
5651− after following punctuation. For example, if the source
5652− contains `blah blah [@jones99].`, the result will look like
5653− `blah blah.[^1]`, with the note moved after the period and
5654− the space collapsed. If false, the space will still be
5655− collapsed, but the footnote will not be moved after the
5656− punctuation.
5657−
5658−
5659−# Slide shows
5660−
5661−You can use pandoc to produce an HTML + JavaScript slide presentation
3454+You can use pandoc to produce an HTML + javascript slide presentation
5662that can be viewed via a web browser. There are five ways to do this,
3455that can be viewed via a web browser. There are five ways to do this,
5663using [S5], [DZSlides], [Slidy], [Slideous], or [reveal.js].
3456using [S5], [DZSlides], [Slidy], [Slideous], or [reveal.js].
5664−You can also produce a PDF slide show using LaTeX [`beamer`], or
3457+You can also produce a PDF slide show using LaTeX [`beamer`].
5665−slides shows in Microsoft [PowerPoint] format.
5666
3458
5667Here's the Markdown source for a simple slide show, `habits.txt`:
3459Here's the Markdown source for a simple slide show, `habits.txt`:
5668
3460
@@ -5698,27 +3490,24 @@ Here's the Markdown source for a simple slide show, `habits.txt`:
5698 - Get in bed
3490 - Get in bed
5699 - Count sheep
3491 - Count sheep
5700
3492
5701−To produce an HTML/JavaScript slide show, simply type
3493+To produce an HTML/javascript slide show, simply type
5702
3494
5703 pandoc -t FORMAT -s habits.txt -o habits.html
3495 pandoc -t FORMAT -s habits.txt -o habits.html
5704
3496
5705where `FORMAT` is either `s5`, `slidy`, `slideous`, `dzslides`, or `revealjs`.
3497where `FORMAT` is either `s5`, `slidy`, `slideous`, `dzslides`, or `revealjs`.
5706
3498
5707−For Slidy, Slideous, reveal.js, and S5, the file produced by
3499+For Slidy, Slideous, reveal.js, and S5, the file produced by pandoc with the
5708−pandoc with the `-s/--standalone` option embeds a link to
3500+`-s/--standalone` option embeds a link to javascripts and CSS files, which are
5709−JavaScript and CSS files, which are assumed to be available at
5710−the relative path `s5/default` (for S5), `slideous` (for
3501+assumed to be available at the relative path `s5/default` (for S5), `slideous`
5711−Slideous), `reveal.js` (for reveal.js), or at the Slidy website
3502+(for Slideous), `reveal.js` (for reveal.js), or at the Slidy website at
5712−at `w3.org` (for Slidy). (These paths can be changed by setting
3503+`w3.org` (for Slidy). (These paths can be changed by setting the `slidy-url`,
5713−the `slidy-url`, `slideous-url`, `revealjs-url`, or `s5-url`
5714−variables; see [Variables for HTML slides], above.) For
3504+`slideous-url`, `revealjs-url`, or `s5-url` variables; see [Variables for slides],
5715−DZSlides, the (relatively short) JavaScript and CSS are included
3505+above.) For DZSlides, the (relatively short) javascript and css are included in
5716−in the file by default.
3506+the file by default.
5717−
3507+
5718−With all HTML slide formats, the `--self-contained` option can
3508+With all HTML slide formats, the `--self-contained` option can be used to
5719−be used to produce a single file that contains all of the data
3509+produce a single file that contains all of the data necessary to display the
5720−necessary to display the slide show, including linked scripts,
5721−stylesheets, images, and videos.
3510+slide show, including linked scripts, stylesheets, images, and videos.
5722
3511
5723To produce a PDF slide show using beamer, type
3512To produce a PDF slide show using beamer, type
5724
3513
@@ -5727,17 +3516,14 @@ To produce a PDF slide show using beamer, type
5727Note that a reveal.js slide show can also be converted to a PDF
3516Note that a reveal.js slide show can also be converted to a PDF
5728by printing it to a file from the browser.
3517by printing it to a file from the browser.
5729
3518
5730−To produce a Powerpoint slide show, type
5731−
5732− pandoc habits.txt -o habits.pptx
5733−
5734−## Structuring the slide show
3519+Structuring the slide show
3520+--------------------------
5735
3521
5736−By default, the *slide level* is the highest heading level in
3522+By default, the *slide level* is the highest header level in
5737the hierarchy that is followed immediately by content, and not another
3523the hierarchy that is followed immediately by content, and not another
5738−heading, somewhere in the document. In the example above, level-1 headings
3524+header, somewhere in the document. In the example above, level 1 headers
5739−are always followed by level-2 headings, which are followed by content,
3525+are always followed by level 2 headers, which are followed by content,
5740−so the slide level is 2. This default can be overridden using
3526+so 2 is the slide level. This default can be overridden using
5741the `--slide-level` option.
3527the `--slide-level` option.
5742
3528
5743The document is carved up into slides according to the following
3529The document is carved up into slides according to the following
@@ -5745,21 +3531,14 @@ rules:
5745
3531
5746 * A horizontal rule always starts a new slide.
3532 * A horizontal rule always starts a new slide.
5747
3533
5748− * A heading at the slide level always starts a new slide.
3534+ * A header at the slide level always starts a new slide.
5749
3535
5750− * Headings *below* the slide level in the hierarchy create
3536+ * Headers *below* the slide level in the hierarchy create
5751− headings *within* a slide. (In beamer, a "block" will be
3537+ headers *within* a slide.
5752− created. If the heading has the class `example`, an
5753− `exampleblock` environment will be used; if it has the class
5754− `alert`, an `alertblock` will be used; otherwise a regular
5755− `block` will be used.)
5756
3538
5757− * Headings *above* the slide level in the hierarchy create
3539+ * Headers *above* the slide level in the hierarchy create
5758 "title slides," which just contain the section title
3540 "title slides," which just contain the section title
5759 and help to break the slide show into sections.
3541 and help to break the slide show into sections.
5760− Non-slide content under these headings will be included
5761− on the title slide (for HTML slide shows) or in a
5762− subsequent slide with the same title (for beamer).
5763
3542
5764 * A title page is constructed automatically from the document's title
3543 * A title page is constructed automatically from the document's title
5765 block, if present. (In the case of beamer, this can be disabled
3544 block, if present. (In the case of beamer, this can be disabled
@@ -5767,57 +3546,32 @@ rules:
5767
3546
5768These rules are designed to support many different styles of slide show. If
3547These rules are designed to support many different styles of slide show. If
5769you don't care about structuring your slides into sections and subsections,
3548you don't care about structuring your slides into sections and subsections,
5770−you can just use level-1 headings for all each slide. (In that case, level-1
3549+you can just use level 1 headers for all each slide. (In that case, level 1
5771will be the slide level.) But you can also structure the slide show into
3550will be the slide level.) But you can also structure the slide show into
5772sections, as in the example above.
3551sections, as in the example above.
5773
3552
5774Note: in reveal.js slide shows, if slide level is 2, a two-dimensional
3553Note: in reveal.js slide shows, if slide level is 2, a two-dimensional
5775−layout will be produced, with level-1 headings building horizontally
3554+layout will be produced, with level 1 headers building horizontally
5776−and level-2 headings building vertically. It is not recommended that
3555+and level 2 headers building vertically. It is not recommended that
5777you use deeper nesting of section levels with reveal.js.
3556you use deeper nesting of section levels with reveal.js.
5778
3557
5779−## Incremental lists
3558+Incremental lists
3559+-----------------
5780
3560
5781By default, these writers produce lists that display "all at once."
3561By default, these writers produce lists that display "all at once."
5782If you want your lists to display incrementally (one item at a time),
3562If you want your lists to display incrementally (one item at a time),
5783use the `-i` option. If you want a particular list to depart from the
3563use the `-i` option. If you want a particular list to depart from the
5784−default, put it in a `div` block with class `incremental` or
5785−`nonincremental`. So, for example, using the `fenced div` syntax, the
5786−following would be incremental regardless of the document default:
5787−
5788− ::: incremental
5789−
5790− - Eat spaghetti
5791− - Drink wine
5792−
5793− :::
5794−
5795−or
5796−
5797− ::: nonincremental
5798−
5799− - Eat spaghetti
5800− - Drink wine
5801−
5802− :::
5803−
5804−While using `incremental` and `nonincremental` divs are the
5805−recommended method of setting incremental lists on a per-case basis,
5806−an older method is also supported: putting lists inside a blockquote
5807−will depart from the document default (that is, it will display
5808−incrementally without the `-i` option and all at once with the `-i`
3564+default (that is, to display incrementally without the `-i` option and
5809−option):
3565+all at once with the `-i` option), put it in a block quote:
5810
3566
5811 > - Eat spaghetti
3567 > - Eat spaghetti
5812 > - Drink wine
3568 > - Drink wine
5813
3569
5814−Both methods allow incremental and nonincremental lists to be mixed
3570+In this way incremental and nonincremental lists can be mixed in
5815−in a single document.
3571+a single document.
5816−
5817−Note: Neither the `-i/--incremental` option nor any of the
5818−methods described here currently works for PowerPoint output.
5819
3572
5820−## Inserting pauses
3573+Inserting pauses
3574+----------------
5821
3575
5822You can add "pauses" within a slide by including a paragraph containing
3576You can add "pauses" within a slide by including a paragraph containing
5823three dots, separated by spaces:
3577three dots, separated by spaces:
@@ -5830,9 +3584,8 @@ three dots, separated by spaces:
5830
3584
5831 content after the pause
3585 content after the pause
5832
3586
5833−Note: this feature is not yet implemented for PowerPoint output.
5834−
5835−## Styling the slides
3587+Styling the slides
3588+------------------
5836
3589
5837You can change the style of HTML slides by putting customized CSS files
3590You can change the style of HTML slides by putting customized CSS files
5838in `$DATADIR/s5/default` (for S5), `$DATADIR/slidy` (for Slidy),
3591in `$DATADIR/s5/default` (for S5), `$DATADIR/slidy` (for Slidy),
@@ -5857,9 +3610,9 @@ To style beamer slides, you can specify a `theme`, `colortheme`,
5857
3610
5858 pandoc -t beamer habits.txt -V theme:Warsaw -o habits.pdf
3611 pandoc -t beamer habits.txt -V theme:Warsaw -o habits.pdf
5859
3612
5860−Note that heading attributes will turn into slide attributes
3613+Note that header attributes will turn into slide attributes
5861(on a `<div>` or `<section>`) in HTML slide formats, allowing you
3614(on a `<div>` or `<section>`) in HTML slide formats, allowing you
5862−to style individual slides. In beamer, the only heading attribute
3615+to style individual slides. In beamer, the only header attribute
5863that affects slides is the `allowframebreaks` class, which sets the
3616that affects slides is the `allowframebreaks` class, which sets the
5864`allowframebreaks` option, causing multiple slides to be created
3617`allowframebreaks` option, causing multiple slides to be created
5865if the content overfills the frame. This is recommended especially for
3618if the content overfills the frame. This is recommended especially for
@@ -5867,82 +3620,30 @@ bibliographies:
5867
3620
5868 # References {.allowframebreaks}
3621 # References {.allowframebreaks}
5869
3622
5870−## Speaker notes
3623+Speaker notes
5871−
3624+-------------
5872−Speaker notes are supported in reveal.js and PowerPoint (pptx)
5873−output. You can add notes to your Markdown document thus:
5874
3625
5875− ::: notes
3626+reveal.js has good support for speaker notes. You can add notes to your
3627+Markdown document thus:
5876
3628
3629+ <div class="notes">
5877 This is my note.
3630 This is my note.
5878
3631
5879 - It can contain Markdown
3632 - It can contain Markdown
5880 - like this list
3633 - like this list
5881
3634
5882− :::
3635+ </div>
5883−
5884−To show the notes window in reveal.js, press `s` while viewing the
5885−presentation. Speaker notes in PowerPoint will be available, as usual,
5886−in handouts and presenter view.
5887
3636
3637+To show the notes window, press `s` while viewing the presentation.
5888Notes are not yet supported for other slide formats, but the notes
3638Notes are not yet supported for other slide formats, but the notes
5889will not appear on the slides themselves.
3639will not appear on the slides themselves.
5890
3640
5891−## Columns
5892−
5893−To put material in side by side columns, you can use a native
5894−div container with class `columns`, containing two or more div
5895−containers with class `column` and a `width` attribute:
5896−
5897− :::::::::::::: {.columns}
5898− ::: {.column width="40%"}
5899− contents...
5900− :::
5901− ::: {.column width="60%"}
5902− contents...
5903− :::
5904− ::::::::::::::
5905−
5906−### Additional columns attributes in beamer
5907−
5908−The div containers with classes `columns` and `column` can optionally have
5909−an `align` attribute.
5910−The class `columns` can optionally have a `totalwidth` attribute or an
5911−`onlytextwidth` class.
5912−
5913− :::::::::::::: {.columns align=center totalwidth=8em}
5914− ::: {.column width="40%"}
5915− contents...
5916− :::
5917− ::: {.column width="60%" align=bottom}
5918− contents...
5919− :::
5920− ::::::::::::::
5921−
5922−The `align` attributes on `columns` and `column` can be used with the
5923−values `top`, `top-baseline`, `center` and `bottom` to vertically align
5924−the columns. It defaults to `top` in `columns`.
5925−
5926−The `totalwidth` attribute limits the width of the columns to the given value.
5927−
5928− :::::::::::::: {.columns align=top .onlytextwidth}
5929− ::: {.column width="40%" align=center}
5930− contents...
5931− :::
5932− ::: {.column width="60%"}
5933− contents...
5934− :::
5935− ::::::::::::::
5936−
5937−The class `onlytextwidth` sets the `totalwidth` to `\textwidth`.
5938−
5939−See Section 12.7 of the [Beamer User's Guide] for more details.
5940−
5941−## Frame attributes in beamer
3641+Frame attributes in beamer
3642+--------------------------
5942
3643
5943Sometimes it is necessary to add the LaTeX `[fragile]` option to
3644Sometimes it is necessary to add the LaTeX `[fragile]` option to
5944a frame in beamer (for example, when using the `minted` environment).
3645a frame in beamer (for example, when using the `minted` environment).
5945−This can be forced by adding the `fragile` class to the heading
3646+This can be forced by adding the `fragile` class to the header
5946introducing the slide:
3647introducing the slide:
5947
3648
5948 # Fragile slide {.fragile}
3649 # Fragile slide {.fragile}
@@ -5950,64 +3651,13 @@ introducing the slide:
5950All of the other frame attributes described in Section 8.1 of
3651All of the other frame attributes described in Section 8.1 of
5951the [Beamer User's Guide] may also be used: `allowdisplaybreaks`,
3652the [Beamer User's Guide] may also be used: `allowdisplaybreaks`,
5952`allowframebreaks`, `b`, `c`, `t`, `environment`, `label`, `plain`,
3653`allowframebreaks`, `b`, `c`, `t`, `environment`, `label`, `plain`,
5953−`shrink`, `standout`, `noframenumbering`.
3654+`shrink`.
5954−
5955−## Background in reveal.js and beamer
5956−
5957−Background images can be added to self-contained reveal.js slideshows and
5958−to beamer slideshows.
5959−
5960−For the same image on every slide, use the configuration
5961−option `background-image` either in the YAML metadata block
5962−or as a command-line variable. (There are no other options in
5963−beamer and the rest of this section concerns reveal.js slideshows.)
5964−
5965−For reveal.js, you can instead use the reveal.js-native option
5966−`parallaxBackgroundImage`. You can also set `parallaxBackgroundHorizontal`
5967−and `parallaxBackgroundVertical` the same way and must also set
5968−`parallaxBackgroundSize` to have your values take effect.
5969−
5970−To set an image for a particular reveal.js slide, add
5971−`{data-background-image="/path/to/image"}`
5972−to the first slide-level heading on the slide (which may even be empty).
5973−
5974−In reveal.js's overview mode, the parallaxBackgroundImage will show up
5975−only on the first slide.
5976−
5977−Other reveal.js background settings also work on individual slides, including
5978−`data-background-size`, `data-background-repeat`, `data-background-color`,
5979−`data-transition`, and `data-transition-speed`.
5980−
5981−To add a background image to the automatically generated title slide, use the
5982−`title-slide-attributes` variable in the YAML metadata block. It must contain
5983−a map of attribute names and values.
5984
3655
5985−See the [reveal.js documentation](https://revealjs.com/backgrounds/) for more
3656+Creating EPUBs with pandoc
5986−details.
3657+==========================
5987
3658
5988−For example in reveal.js:
5989−
5990−```
5991−---
5992−title: My Slideshow
5993−parallaxBackgroundImage: /path/to/my/background_image.png
5994−title-slide-attributes:
5995− data-background-image: /path/to/title_image.png
5996− data-background-size: contain
5997−---
5998−
5999−## Slide One
6000−
6001−Slide 1 has background_image.png as its background.
6002−
6003−## {data-background-image="/path/to/special_image.jpg"}
6004−
6005−Slide 2 has a special image for its background, even though the heading has no content.
6006−```
6007−
6008−# EPUBs
6009−
6010−## EPUB Metadata
3659+EPUB Metadata
3660+-------------
6011
3661
6012EPUB metadata may be specified using the `--epub-metadata` option, but
3662EPUB metadata may be specified using the `--epub-metadata` option, but
6013if the source document is Markdown, it is better to use a [YAML metadata
3663if the source document is Markdown, it is better to use a [YAML metadata
@@ -6029,8 +3679,6 @@ block][Extension: `yaml_metadata_block`]. Here is an example:
6029 text: doi:10.234234.234/33
3679 text: doi:10.234234.234/33
6030 publisher: My Press
3680 publisher: My Press
6031 rights: © 2007 John Smith, CC BY-NC
3681 rights: © 2007 John Smith, CC BY-NC
6032− ibooks:
6033− version: 1.3.4
6034 ...
3682 ...
6035
3683
6036The following fields are recognized:
3684The following fields are recognized:
@@ -6085,436 +3733,282 @@ The following fields are recognized:
6085
3733
6086`rights`
3734`rights`
6087 ~ A string value.
3735 ~ A string value.
6088−
6089−`belongs-to-collection`
6090− ~ A string value. identifies the name of a collection to which
6091− the EPUB Publication belongs.
6092−
6093−`group-position`
6094− ~ The `group-position` field indicates the numeric position in which
6095− the EPUB Publication belongs relative to other works belonging to
6096− the same `belongs-to-collection` field.
6097
3736
6098`cover-image`
3737`cover-image`
6099 ~ A string value (path to cover image).
3738 ~ A string value (path to cover image).
6100
3739
6101−`css` (or legacy: `stylesheet`)
3740+`stylesheet`
6102 ~ A string value (path to CSS stylesheet).
3741 ~ A string value (path to CSS stylesheet).
6103
3742
6104`page-progression-direction`
3743`page-progression-direction`
6105 ~ Either `ltr` or `rtl`. Specifies the `page-progression-direction`
3744 ~ Either `ltr` or `rtl`. Specifies the `page-progression-direction`
6106 attribute for the [`spine` element].
3745 attribute for the [`spine` element].
6107
3746
6108−`ibooks`
6109− ~ iBooks-specific metadata, with the following fields:
6110−
6111− - `version`: (string)
6112− - `specified-fonts`: `true`|`false` (default `false`)
6113− - `ipad-orientation-lock`: `portrait-only`|`landscape-only`
6114− - `iphone-orientation-lock`: `portrait-only`|`landscape-only`
6115− - `binding`: `true`|`false` (default `true`)
6116− - `scroll-axis`: `vertical`|`horizontal`|`default`
6117−
6118−[MARC relators]: https://loc.gov/marc/relators/relaterm.html
3747+[MARC relators]: http://loc.gov/marc/relators/relaterm.html
6119[`spine` element]: http://idpf.org/epub/301/spec/epub-publications.html#sec-spine-elem
3748[`spine` element]: http://idpf.org/epub/301/spec/epub-publications.html#sec-spine-elem
6120
3749
6121−## The `epub:type` attribute
6122−
6123−For `epub3` output, you can mark up the heading that corresponds to an EPUB
6124−chapter using the [`epub:type` attribute][epub-type]. For example, to set
6125−the attribute to the value `prologue`, use this markdown:
6126−
6127− # My chapter {epub:type=prologue}
6128−
6129−Which will result in:
6130−
6131− <body epub:type="frontmatter">
6132− <section epub:type="prologue">
6133− <h1>My chapter</h1>
6134−
6135−Pandoc will output `<body epub:type="bodymatter">`, unless
6136−you use one of the following values, in which case either
6137−`frontmatter` or `backmatter` will be output.
6138−
6139−`epub:type` of first section `epub:type` of body
6140−---------------------------- ------------------
6141−prologue frontmatter
6142−abstract frontmatter
6143−acknowledgments frontmatter
6144−copyright-page frontmatter
6145−dedication frontmatter
6146−credits frontmatter
6147−keywords frontmatter
6148−imprint frontmatter
6149−contributors frontmatter
6150−other-credits frontmatter
6151−errata frontmatter
6152−revision-history frontmatter
6153−titlepage frontmatter
6154−halftitlepage frontmatter
6155−seriespage frontmatter
6156−foreword frontmatter
6157−preface frontmatter
6158−appendix backmatter
6159−colophon backmatter
6160−bibliography backmatter
6161−index backmatter
6162−
6163−[epub-type]: http://www.idpf.org/epub/31/spec/epub-contentdocs.html#sec-epub-type-attribute
6164−
6165−## Linked media
3750+Linked media
6166−
3751+------------
3752+
6167−By default, pandoc will download media referenced from any `<img>`, `<audio>`,
3753+By default, pandoc will download linked media (including audio and
6168−`<video>` or `<source>` element present in the generated EPUB,
6169−and include it in the EPUB container, yielding a completely
3754+video) and include it in the EPUB container, yielding a completely
6170self-contained EPUB. If you want to link to external media resources
3755self-contained EPUB. If you want to link to external media resources
6171instead, use raw HTML in your source and add `data-external="1"` to the tag
3756instead, use raw HTML in your source and add `data-external="1"` to the tag
6172with the `src` attribute. For example:
3757with the `src` attribute. For example:
6173
3758
6174 <audio controls="1">
3759 <audio controls="1">
6175− <source src="https://example.com/music/toccata.mp3"
3760+ <source src="http://example.com/music/toccata.mp3"
6176 data-external="1" type="audio/mpeg">
3761 data-external="1" type="audio/mpeg">
6177 </source>
3762 </source>
6178 </audio>
3763 </audio>
6179
3764
6180−# Jupyter notebooks
3765+Literate Haskell support
6181−
3766+========================
6182−When creating a [Jupyter notebook], pandoc will try to infer the
6183−notebook structure. Code blocks with the class `code` will be
6184−taken as code cells, and intervening content will be taken as
6185−Markdown cells. Attachments will automatically be created for
6186−images in Markdown cells. Metadata will be taken from the
6187−`jupyter` metadata field. For example:
6188−
6189−````
6190−---
6191−title: My notebook
6192−jupyter:
6193− nbformat: 4
6194− nbformat_minor: 5
6195− kernelspec:
6196− display_name: Python 2
6197− language: python
6198− name: python2
6199− language_info:
6200− codemirror_mode:
6201− name: ipython
6202− version: 2
6203− file_extension: ".py"
6204− mimetype: "text/x-python"
6205− name: "python"
6206− nbconvert_exporter: "python"
6207− pygments_lexer: "ipython2"
6208− version: "2.7.15"
6209−---
6210−
6211−# Lorem ipsum
6212−
6213−**Lorem ipsum** dolor sit amet, consectetur adipiscing elit. Nunc luctus
6214−bibendum felis dictum sodales.
6215−
6216−``` code
6217−print("hello")
6218−```
6219−
6220−## Pyout
6221
3767
6222−``` code
3768+If you append `+lhs` (or `+literate_haskell`) to an appropriate input or output
6223−from IPython.display import HTML
3769+format (`markdown`, `markdown_strict`, `rst`, or `latex` for input or output;
6224−HTML("""
3770+`beamer`, `html` or `html5` for output only), pandoc will treat the document as
6225−<script>
3771+literate Haskell source. This means that
6226−console.log("hello");
6227−</script>
6228−<b>HTML</b>
6229−""")
6230−```
6231
3772
6232−## Image
3773+ - In Markdown input, "bird track" sections will be parsed as Haskell
3774+ code rather than block quotations. Text between `\begin{code}`
3775+ and `\end{code}` will also be treated as Haskell code. For
3776+ ATX-style headers the character '=' will be used instead of '#'.
6233
3777
6234−This image ![image](myimage.png) will be
3778+ - In Markdown output, code blocks with classes `haskell` and `literate`
6235−included as a cell attachment.
3779+ will be rendered using bird tracks, and block quotations will be
6236−````
3780+ indented one space, so they will not be treated as Haskell code.
3781+ In addition, headers will be rendered setext-style (with underlines)
3782+ rather than ATX-style (with '#' characters). (This is because ghc
3783+ treats '#' characters in column 1 as introducing line numbers.)
6237
3784
6238−If you want to add cell attributes, group cells differently, or
3785+ - In restructured text input, "bird track" sections will be parsed
6239−add output to code cells, then you need to include divs to
3786+ as Haskell code.
6240−indicate the structure. You can use either [fenced
6241−divs][Extension: `fenced_divs`] or [native divs][Extension:
6242−`native_divs`] for this. Here is an example:
6243
3787
6244−````
3788+ - In restructured text output, code blocks with class `haskell` will
6245−:::::: {.cell .markdown}
3789+ be rendered using bird tracks.
6246−# Lorem
6247
3790
6248−**Lorem ipsum** dolor sit amet, consectetur adipiscing elit. Nunc luctus
3791+ - In LaTeX input, text in `code` environments will be parsed as
6249−bibendum felis dictum sodales.
3792+ Haskell code.
6250−::::::
6251
3793
6252−:::::: {.cell .code execution_count=1}
3794+ - In LaTeX output, code blocks with class `haskell` will be rendered
6253−``` {.python}
3795+ inside `code` environments.
6254−print("hello")
6255−```
6256
3796
6257−::: {.output .stream .stdout}
3797+ - In HTML output, code blocks with class `haskell` will be rendered
6258−```
3798+ with class `literatehaskell` and bird tracks.
6259−hello
6260−```
6261−:::
6262−::::::
6263−
6264−:::::: {.cell .code execution_count=2}
6265−``` {.python}
6266−from IPython.display import HTML
6267−HTML("""
6268−<script>
6269−console.log("hello");
6270−</script>
6271−<b>HTML</b>
6272−""")
6273−```
6274
3799
6275−::: {.output .execute_result execution_count=2}
3800+Examples:
6276−```{=html}
6277−<script>
6278−console.log("hello");
6279−</script>
6280−<b>HTML</b>
6281−hello
6282−```
6283−:::
6284−::::::
6285−````
6286−
6287−If you include raw HTML or TeX in an output cell, use the
6288−[raw attribute][Extension: `fenced_attribute`], as shown
6289−in the last cell of the example above. Although pandoc can
6290−process "bare" raw HTML and TeX, the result is often
6291−interspersed raw elements and normal textual elements, and
6292−in an output cell pandoc expects a single, connected raw
6293−block. To avoid using raw HTML or TeX except when
6294−marked explicitly using raw attributes, we recommend
6295−specifying the extensions `-raw_html-raw_tex+raw_attribute` when
6296−translating between Markdown and ipynb notebooks.
6297−
6298−Note that options and extensions that affect reading and
6299−writing of Markdown will also affect Markdown cells in ipynb
6300−notebooks. For example, `--wrap=preserve` will preserve
6301−soft line breaks in Markdown cells; `--atx-headers` will
6302−cause ATX-style headings to be used; and `--preserve-tabs` will
6303−prevent tabs from being turned to spaces.
6304−
6305−# Syntax highlighting
6306
3801
6307−Pandoc will automatically highlight syntax in [fenced code blocks] that
3802+ pandoc -f markdown+lhs -t html
6308−are marked with a language name. The Haskell library [skylighting] is
6309−used for highlighting. Currently highlighting is supported only for
6310−HTML, EPUB, Docx, Ms, and LaTeX/PDF output. To see a list of language names
6311−that pandoc will recognize, type `pandoc --list-highlight-languages`.
6312
3803
6313−The color scheme can be selected using the `--highlight-style` option.
3804+reads literate Haskell source formatted with Markdown conventions and writes
6314−The default color scheme is `pygments`, which imitates the default color
3805+ordinary HTML (without bird tracks).
6315−scheme used by the Python library pygments (though pygments is not actually
6316−used to do the highlighting). To see a list of highlight styles,
6317−type `pandoc --list-highlight-styles`.
6318
3806
6319−If you are not satisfied with the predefined styles, you can
3807+ pandoc -f markdown+lhs -t html+lhs
6320−use `--print-highlight-style` to generate a JSON `.theme` file which
6321−can be modified and used as the argument to `--highlight-style`. To
6322−get a JSON version of the `pygments` style, for example:
6323
3808
6324− pandoc --print-highlight-style pygments > my.theme
3809+writes HTML with the Haskell code in bird tracks, so it can be copied
3810+and pasted as literate Haskell source.
6325
3811
6326−Then edit `my.theme` and use it like this:
3812+Syntax highlighting
3813+===================
6327
3814
6328− pandoc --highlight-style my.theme
3815+Pandoc will automatically highlight syntax in [fenced code blocks] that
3816+are marked with a language name. The Haskell library [highlighting-kate] is used for
3817+highlighting, which works in HTML, Docx, and LaTeX/PDF output.
3818+The color scheme can be selected using the `--highlight-style` option.
3819+The default color scheme is `pygments`, which imitates the default color
3820+scheme used by the Python library pygments, but pygments is not actually
3821+used to do the highlighting.
6329
3822
6330−If you are not satisfied with the built-in highlighting, or you
3823+To see a list of language names that pandoc will recognize, type
6331−want highlight a language that isn't supported, you can use the
3824+`pandoc --version`.
6332−`--syntax-definition` option to load a [KDE-style XML syntax definition
6333−file](https://docs.kde.org/stable5/en/kate/katepart/highlight.html).
6334−Before writing your own, have a look at KDE's [repository of syntax
6335−definitions](https://github.com/KDE/syntax-highlighting/tree/master/data/syntax).
6336
3825
6337To disable highlighting, use the `--no-highlight` option.
3826To disable highlighting, use the `--no-highlight` option.
6338
3827
6339−[skylighting]: https://github.com/jgm/skylighting
3828+[highlighting-kate]: https://github.com/jgm/highlighting-kate
6340−
6341−# Custom Styles
6342−
6343−Custom styles can be used in the docx and ICML formats.
6344−
6345−## Output
6346−
6347−By default, pandoc's docx and ICML output applies a predefined set of styles
6348−for blocks such as paragraphs and block quotes, and uses largely default
6349−formatting (italics, bold) for inlines. This will work for most
6350−purposes, especially alongside a `reference.docx` file. However, if you
6351−need to apply your own styles to blocks, or match a preexisting set of
6352−styles, pandoc allows you to define custom styles for blocks and text
6353−using `div`s and `span`s, respectively.
6354−
6355−If you define a `div` or `span` with the attribute `custom-style`,
6356−pandoc will apply your specified style to the contained elements (with
6357−the exception of elements whose function depends on a style, like
6358−headings, code blocks, block quotes, or links). So, for example, using
6359−the `bracketed_spans` syntax,
6360−
6361− [Get out]{custom-style="Emphatically"}, he said.
6362−
6363−would produce a docx file with "Get out" styled with character
6364−style `Emphatically`. Similarly, using the `fenced_divs` syntax,
6365−
6366− Dickinson starts the poem simply:
6367−
6368− ::: {custom-style="Poetry"}
6369− | A Bird came down the Walk---
6370− | He did not know I saw---
6371− :::
6372−
6373−would style the two contained lines with the `Poetry` paragraph style.
6374−
6375−For docx output, styles will be defined in the output file as inheriting
6376−from normal text, if the styles are not yet in your reference.docx.
6377−If they are already defined, pandoc will not alter the definition.
6378−
6379−This feature allows for greatest customization in conjunction with
6380−[pandoc filters]. If you want all paragraphs after block quotes to be
6381−indented, you can write a filter to apply the styles necessary. If you
6382−want all italics to be transformed to the `Emphasis` character style
6383−(perhaps to change their color), you can write a filter which will
6384−transform all italicized inlines to inlines within an `Emphasis`
6385−custom-style `span`.
6386−
6387−For docx output, you don't need to enable any extensions for
6388−custom styles to work.
6389−
6390−[pandoc filters]: https://pandoc.org/filters.html
6391−
6392−## Input
6393−
6394−The docx reader, by default, only reads those styles that it can
6395−convert into pandoc elements, either by direct conversion or
6396−interpreting the derivation of the input document's styles.
6397−
6398−By enabling the [`styles` extension](#ext-styles) in the docx reader
6399−(`-f docx+styles`), you can produce output that maintains the styles
6400−of the input document, using the `custom-style` class. Paragraph
6401−styles are interpreted as divs, while character styles are interpreted
6402−as spans.
6403−
6404−For example, using the `custom-style-reference.docx` file in the test
6405−directory, we have the following different outputs:
6406−
6407−Without the `+styles` extension:
6408−
6409− $ pandoc test/docx/custom-style-reference.docx -f docx -t markdown
6410− This is some text.
6411−
6412− This is text with an *emphasized* text style. And this is text with a
6413− **strengthened** text style.
6414−
6415− > Here is a styled paragraph that inherits from Block Text.
6416−
6417−And with the extension:
6418−
6419− $ pandoc test/docx/custom-style-reference.docx -f docx+styles -t markdown
6420−
6421− ::: {custom-style="First Paragraph"}
6422− This is some text.
6423− :::
6424−
6425− ::: {custom-style="Body Text"}
6426− This is text with an [emphasized]{custom-style="Emphatic"} text style.
6427− And this is text with a [strengthened]{custom-style="Strengthened"}
6428− text style.
6429− :::
6430−
6431− ::: {custom-style="My Block Style"}
6432− > Here is a styled paragraph that inherits from Block Text.
6433− :::
6434−
6435−With these custom styles, you can use your input document as a
6436−reference-doc while creating docx output (see below), and maintain the
6437−same styles in your input and output files.
6438
3829
6439−# Custom writers
3830+Custom writers
3831+==============
6440
3832
6441−Pandoc can be extended with custom writers written in [Lua]. (Pandoc
3833+Pandoc can be extended with custom writers written in [lua]. (Pandoc
6442−includes a Lua interpreter, so Lua need not be installed separately.)
3834+includes a lua interpreter, so lua need not be installed separately.)
6443
3835
6444−To use a custom writer, simply specify the path to the Lua script
3836+To use a custom writer, simply specify the path to the lua script
6445in place of the output format. For example:
3837in place of the output format. For example:
6446
3838
6447 pandoc -t data/sample.lua
3839 pandoc -t data/sample.lua
6448
3840
6449−Creating a custom writer requires writing a Lua function for each
3841+Creating a custom writer requires writing a lua function for each
6450possible element in a pandoc document. To get a documented example
3842possible element in a pandoc document. To get a documented example
6451which you can modify according to your needs, do
3843which you can modify according to your needs, do
6452
3844
6453 pandoc --print-default-data-file sample.lua
3845 pandoc --print-default-data-file sample.lua
6454
3846
6455−Note that custom writers have no default template. If you want
3847+[lua]: http://www.lua.org
6456−to use `--standalone` with a custom writer, you will need to
3848+
6457−specify a template manually using `--template` or add a new
3849+Authors
6458−default template with the name
3850+=======
6459−`default.NAME_OF_CUSTOM_WRITER.lua` to the `templates`
3851+
6460−subdirectory of your user data directory (see [Templates]).
3852+© 2006-2015 John MacFarlane (jgm@berkeley.edu). Released under the
6461−
3853+[GPL], version 2 or greater. This software carries no warranty of
6462−[Lua]: https://www.lua.org
3854+any kind. (See COPYRIGHT for full copyright and warranty notices.)
6463−
3855+
6464−# Reproducible builds
3856+Contributors include
6465−
3857+Aaron Wolen,
6466−Some of the document formats pandoc targets (such as EPUB,
3858+Albert Krewinkel,
6467−docx, and ODT) include build timestamps in the generated document.
3859+Alex Vong,
6468−That means that the files generated on successive builds will
3860+Alexander Kondratskiy,
6469−differ, even if the source does not. To avoid this, set the
3861+Alexander Sulfrian,
6470−`SOURCE_DATE_EPOCH` environment variable, and the timestamp will
3862+Alexander V Vershilov,
6471−be taken from it instead of the current time.
3863+Alfred Wechselberger,
6472−`SOURCE_DATE_EPOCH` should contain an integer unix timestamp
3864+Andreas Lööw,
6473−(specifying the number of second since midnight UTC January 1, 1970).
3865+Andrew Dunning,
6474−
3866+Antoine Latter,
6475−Some document formats also include a unique identifier. For
3867+Arata Mizuki,
6476−EPUB, this can be set explicitly by setting the `identifier`
3868+Arlo O'Keeffe,
6477−metadata field (see [EPUB Metadata], above).
3869+Artyom Kazak,
6478−
3870+Ben Gamari,
6479−# A note on security
3871+Beni Cherniavsky-Paskin,
6480−
3872+Benoit Schweblin,
6481−If you use pandoc to convert user-contributed content in a web
3873+Bjorn Buckwalter,
6482−application, here are some things to keep in mind:
3874+Bradley Kuhn,
6483−
3875+Brent Yorgey,
6484−1. Although pandoc itself will not create or modify any files other
3876+Bryan O'Sullivan,
6485− than those you explicitly ask it create (with the exception
3877+B. Scott Michel,
6486− of temporary files used in producing PDFs), a filter or custom
3878+Caleb McDaniel,
6487− writer could in principle do anything on your file system. Please
3879+Calvin Beck,
6488− audit filters and custom writers very carefully before using them.
3880+Carlos Sosa,
6489−
3881+Chris Black,
6490−2. If your application uses pandoc as a Haskell library (rather than
3882+Christian Conkle,
6491− shelling out to the executable), it is possible to use it in a mode
3883+Christoffer Ackelman,
6492− that fully isolates pandoc from your file system, by running the
3884+Christoffer Sawicki,
6493− pandoc operations in the `PandocPure` monad. See the document
3885+Clare Macrae,
6494− [Using the pandoc API](https://pandoc.org/using-the-pandoc-api.html)
3886+Clint Adams,
6495− for more details.
3887+Conal Elliott,
6496−
3888+Craig S. Bosma,
6497−3. Pandoc's parsers can exhibit pathological performance on some
3889+csforste,
6498− corner cases. It is wise to put any pandoc operations under
3890+Daniel Bergey,
6499− a timeout, to avoid DOS attacks that exploit these issues.
3891+Daniel T. Staal,
6500− If you are using the pandoc executable, you can add the
3892+David Lazar,
6501− command line options `+RTS -M512M -RTS` (for example) to limit
3893+David Röthlisberger,
6502− the heap size to 512MB.
3894+Denis Laxalde,
6503−
3895+Douglas Calvert,
6504−4. The HTML generated by pandoc is not guaranteed to be safe.
3896+Douglas F. Calvert,
6505− If `raw_html` is enabled for the Markdown input, users can
3897+Emanuel Evans,
6506− inject arbitrary HTML. Even if `raw_html` is disabled,
3898+Emily Eisenberg,
6507− users can include dangerous content in URLs and attributes.
3899+Eric Kow,
6508− To be safe, you should run all the generated HTML through
3900+Eric Seidel,
6509− an HTML sanitizer.
3901+Florian Eitel,
6510−
3902+François Gannaz,
6511−# Authors
3903+Freiric Barral,
6512−
3904+Freirich Raabe,
6513−Copyright 2006--2021 John MacFarlane (jgm@berkeley.edu). Released
3905+Fyodor Sheremetyev,
6514−under the [GPL], version 2 or greater. This software carries no
3906+Gabor Pali,
6515−warranty of any kind. (See COPYRIGHT for full copyright and
3907+Gavin Beatty,
6516−warranty notices.) For a full list of contributors, see the file
3908+Gottfried Haider,
6517−AUTHORS.md in the pandoc source code.
3909+Greg Maslov,
6518−
3910+Grégory Bataille,
6519−[GPL]: https://www.gnu.org/copyleft/gpl.html "GNU General Public License"
3911+Greg Rundlett,
6520−[YAML]: https://yaml.org/spec/1.2/spec.html "YAML v1.2 Spec"
3912+gwern,
3913+Gwern Branwen,
3914+Hans-Peter Deifel,
3915+Henrik Tramberend,
3916+Henry de Valence,
3917+ickc,
3918+Ilya V. Portnov,
3919+infinity0x,
3920+Ivo Clarysse,
3921+Jaime Marquínez Ferrándiz,
3922+James Aspnes,
3923+Jamie F. Olson,
3924+Jan Larres,
3925+Jan Schulz,
3926+Jason Ronallo,
3927+Jeff Arnold,
3928+Jeff Runningen,
3929+Jens Petersen,
3930+Jérémy Bobbio,
3931+Jesse Rosenthal,
3932+J. Lewis Muir,
3933+Joe Hillenbrand,
3934+John MacFarlane,
3935+Jonas Smedegaard,
3936+Jonathan Daugherty,
3937+Josef Svenningsson,
3938+Jose Luis Duran,
3939+Julien Cretel,
3940+Juliusz Gonera,
3941+Justin Bogner,
3942+Kelsey Hightower,
3943+Kolen Cheung,
3944+Konstantin Zudov,
3945+Kristof Bastiaensen,
3946+Lars-Dominik Braun,
3947+Luke Plant,
3948+Mark Szepieniec,
3949+Mark Wright,
3950+Martin Linn,
3951+Masayoshi Takahashi,
3952+Matej Kollar,
3953+Mathias Schenner,
3954+Mathieu Duponchelle,
3955+Matthew Eddey,
3956+Matthew Pickering,
3957+Matthias C. M. Troffaes,
3958+Mauro Bieg,
3959+Max Bolingbroke,
3960+Max Rydahl Andersen,
3961+Merijn Verstraaten,
3962+Michael Beaumont,
3963+Michael Chladek,
3964+Michael Snoyman,
3965+Michael Thompson,
3966+MinRK,
3967+Nathan Gass,
3968+Neil Mayhew,
3969+Nick Bart,
3970+Nicolas Kaiser,
3971+Nikolay Yakimov,
3972+nkalvi,
3973+Ophir Lifshitz,
3974+Pablo Rodríguez,
3975+Paulo Tanimoto,
3976+Paul Rivier,
3977+Peter Wang,
3978+Philippe Ombredanne,
3979+Phillip Alday,
3980+Prayag Verma,
3981+Puneeth Chaganti,
3982+qerub,
3983+Ralf Stephan,
3984+Raniere Silva,
3985+Recai Oktaş,
3986+robabla,
3987+rodja.trappe,
3988+rski,
3989+RyanGlScott,
3990+Scott Morrison,
3991+Sergei Trofimovich,
3992+Sergey Astanin,
3993+Shahbaz Youssefi,
3994+Shaun Attfield,
3995+Sidarth Kapur,
3996+shreevatsa.public,
3997+Simon Hengel,
3998+Sumit Sahrawat,
3999+takahashim,
4000+thsutton,
4001+Tim Lin,
4002+Timothy Humphries,
4003+Tiziano Müller,
4004+Thomas Hodgson,
4005+Todd Sifleet,
4006+Tom Leese,
4007+Uli Köhler,
4008+Václav Zeman,
4009+Viktor Kronvall,
4010+Vincent,
4011+Wikiwide, and
4012+Xavier Olive.
4013+
4014+[GPL]: http://www.gnu.org/copyleft/gpl.html "GNU General Public License"
Makefile+42−116
@@ -1,79 +1,37 @@
1−version?=$(shell grep '^[Vv]ersion:' pandoc.cabal | awk '{print $$2;}')
1+version=$(shell grep '^Version:' pandoc.cabal | awk '{print $$2;}')
2pandoc=$(shell find dist -name pandoc -type f -exec ls -t {} \; | head -1)
2pandoc=$(shell find dist -name pandoc -type f -exec ls -t {} \; | head -1)
3−SOURCEFILES?=$(shell git ls-tree -r master --name-only | grep "\.hs$$")
4−BRANCH?=master
5−ARCH=$(shell uname -m)
6−DOCKERIMAGE=registry.gitlab.b-data.ch/ghc/ghc4pandoc:8.10.4
7−COMMIT=$(shell git rev-parse --short HEAD)
8−TIMESTAMP=$(shell date "+%Y%m%d_%H%M")
9−LATESTBENCH=$(word 1,$(shell ls -t bench_*.csv 2>/dev/null))
10−BASELINE?=$(LATESTBENCH)
11−ifeq ($(BASELINE),)
12−BASELINECMD=
13−else
14−BASELINECMD=--baseline $(BASELINE)
15−endif
16−GHCOPTS=-fdiagnostics-color=always -j4 +RTS -A8m -RTS
17−WEBSITE=../../web/pandoc.org
18−REVISION?=1
19−# For gauge:
20−# BENCHARGS?=--small --ci=0.90 --match=pattern $(PATTERN)
21−# For tasty-bench:
22−BENCHARGS?=--csv bench_$(TIMESTAMP).csv $(BASELINECMD) --timeout=6 +RTS -T -RTS $(if $(PATTERN),--pattern "$(PATTERN)",)
23
3
24quick:
4quick:
25− stack install --ghc-options='$(GHCOPTS)' --install-ghc --flag 'pandoc:embed_data_files' --fast --test --ghc-options='$(GHCOPTS)' --test-arguments='-j4 --hide-successes $(TESTARGS)'
5+ cabal --ignore-sandbox configure --enable-tests -fembed_data_files --disable-optimization
26−
6+ cabal build
27−quick-cabal:
28− cabal new-configure . --ghc-options '$(GHCOPTS)' --disable-optimization --enable-tests
29− cabal new-build -j4 . --disable-optimization
30− cabal new-run test-pandoc --disable-optimization -- --hide-successes $(TESTARGS)
31−
32−full-cabal:
33− cabal new-configure . --ghc-options '$(GHCOPTS)' --flags '+embed_data_files +trypandoc' --enable-tests --enable-benchmarks
34− cabal new-build . --disable-optimization
35− cabal new-run test-pandoc --disable-optimization -- --hide-successes $(TESTARGS)
36
7
37full:
8full:
38− stack install --flag 'pandoc:embed_data_files' --flag 'pandoc:trypandoc' --bench --no-run-benchmarks --test --test-arguments='-j4 --hide-successes' --ghc-options '-Wall -Werror -fno-warn-unused-do-bind -O0 $(GHCOPTS)'
9+ cabal configure --enable-tests --enable-optimization -ftrypandoc -fembed_data_files --enable-benchmarks
10+ cabal build
11+ cabal haddock
39
12
40−ghci:
13+deps:
41− stack ghci --flag 'pandoc:embed_data_files'
14+ cabal install --only-dependencies --enable-tests -ftrypandoc -fembed_data_files --enable-benchmarks
42
15
43−haddock:
16+prof:
44− stack haddock
17+ cabal configure --enable-library-profiling --enable-executable-profiling --enable-optimization --enable-tests
18+ cabal build
45
19
46−# Note: to accept current results of golden tests,
47−# make test TESTARGS='--accept'
48test:
20test:
49− stack test --flag 'pandoc:embed_data_files' --fast --test-arguments='-j4 --hide-successes $(TESTARGS)' --ghc-options '$(GHCOPTS)'
21+ cabal test
50−
51−ghcid:
52− ghcid -c "stack repl --flag 'pandoc:embed_data_files'"
53−
54−ghcid-test:
55− ghcid -c "stack repl --ghc-options=-XNoImplicitPrelude --flag 'pandoc:embed_data_files' --ghci-options=-fobject-code pandoc:lib pandoc:test-pandoc"
56
22
57bench:
23bench:
58− stack bench \
24+ cabal bench
59− --ghc-options '$(GHCOPTS)' \
60− --benchmark-arguments='$(BENCHARGS)' 2>&1 | \
61− tee "bench_latest.txt"
62−
63−reformat:
64− for f in $(SOURCEFILES); do echo $$f; stylish-haskell -i $$f ; done
65
25
66−lint: hlint fix_spacing
26+changes_github:
67−
27+ pandoc --filter extract-changes.hs changelog -t markdown_github | pbcopy
68−hlint:
69− for f in $(SOURCEFILES); do echo $$f; hlint --verbose --refactor --refactor-options='-s -o -' $$f; done
70
28
71−fix_spacing:
29+install: full
72− # Fix trailing newlines and spaces at ends of lines
30+ cabal copy
73− for f in $(SOURCEFILES); do printf '%s\n' "`cat $$f`" | sed -e 's/ *$$//' > $$f.tmp; mv $$f.tmp $$f; done
31+ cabal register
74
32
75−changes_github:
33+stack:
76− pandoc --filter tools/extract-changes.hs changelog.md -t gfm --wrap=none --template tools/changes_template.html | sed -e 's/\\#/#/g' | pbcopy
34+ stack install --test --stack-yaml stack.full.yaml
77
35
78dist: man/pandoc.1
36dist: man/pandoc.1
79 cabal sdist
37 cabal sdist
@@ -82,67 +40,35 @@ dist: man/pandoc.1
82 cd pandoc-${version}
40 cd pandoc-${version}
83 stack setup && stack test && cd .. && rm -rf "pandoc-${version}"
41 stack setup && stack test && cd .. && rm -rf "pandoc-${version}"
84
42
85−check: checkdocs check-cabal
43+.travis.yml: pandoc.cabal make_travis_yml.hs
86−
44+ runghc make_travis_yml.hs $< > $@
87−checkdocs:
88− ! grep -q -n -e "\t" MANUAL.txt changelog.md
89
45
90debpkg: man/pandoc.1
46debpkg: man/pandoc.1
91− docker run -v `pwd`:/mnt \
47+ make -C deb
92− -v `pwd`/linux/artifacts:/artifacts \
93− --user $(id -u):$(id -g) \
94− -e REVISION=$(REVISION) \
95− -w /mnt \
96− --memory=0 \
97− --rm \
98− $(DOCKERIMAGE) \
99− bash \
100− /mnt/linux/make_artifacts.sh 2>&1 > docker.log
101−
102−man/pandoc.1: MANUAL.txt man/pandoc.1.before man/pandoc.1.after
103− pandoc $< -f markdown -t man -s \
104− --lua-filter man/manfilter.lua \
105− --include-before-body man/pandoc.1.before \
106− --include-after-body man/pandoc.1.after \
107− --metadata author="" \
108− --variable footer="pandoc $(version)" \
109− -o $@
110
48
111−README.md: README.template MANUAL.txt tools/update-readme.lua
49+osxpkg: man/pandoc.1
112− pandoc --lua-filter tools/update-readme.lua \
50+ ./make_osx_package.sh
113− --reference-location=section -t gfm $< -o $@
114
51
115−download_stats:
52+winpkg: pandoc-$(version)-windows.msi
116− curl https://api.github.com/repos/jgm/pandoc/releases | \
117− jq -r '.[] | .assets | .[] | "\(.download_count)\t\(.name)"'
118
53
119−pandoc-templates:
54+pandoc-$(version)-windows.msi:
120− rm ../pandoc-templates/default.* ; \
55+ wget 'https://ci.appveyor.com/api/projects/jgm/pandoc/artifacts/windows/pandoc.msi?branch=master' -O pandoc.msi && \
121− cp data/templates/* ../pandoc-templates/ ; \
56+ osslsigncode sign -pkcs12 ~/Private/ComodoCodeSigning.exp2017.p12 -in pandoc.msi -i http://johnmacfarlane.net/ -t http://timestamp.comodoca.com/ -out $@ -askpass
122− pushd ../pandoc-templates/ && \
57+ rm pandoc.msi
123− git add * && \
124− git commit -m "Updated templates for pandoc $(version)" && \
125− popd
126
58
127−trypandoc:
59+man/pandoc.1: MANUAL.txt man/pandoc.1.template
128− ssh -t macfarlane 'cd src/pandoc && git pull && stack install --flag pandoc:trypandoc --flag pandoc:embed_data_files && cd trypandoc && sudo make install'
60+ pandoc $< -t man -s --template man/pandoc.1.template \
61+ --filter man/capitalizeHeaders.hs \
62+ --filter man/removeNotes.hs \
63+ --filter man/removeLinks.hs \
64+ --variable version="pandoc $(version)" \
65+ -o $@
129
66
130−update-website:
67+download_stats:
131− make -C $(WEBSITE) update
68+ curl https://api.github.com/repos/jgm/pandoc/releases | \
132− make -C $(WEBSITE)
69+ jq -r '.[] | .assets | .[] | "\(.download_count)\t\(.name)"'
133− make -C $(WEBSITE) upload
134
70
135clean:
71clean:
136− stack clean
72+ cabal clean
137−
138−check-cabal: git-files.txt sdist-files.txt
139− echo "Checking to see if all committed test/data files are in sdist."
140− diff -u $^
141−
142−sdist-files.txt: .FORCE
143− cabal sdist --list-only | sed 's/\.\///' | grep '^\(test\|data\)\/' | sort > $@
144−
145−git-files.txt: .FORCE
146− git ls-tree -r --name-only HEAD | grep '^\(test\|data\)\/' | sort > $@
147
73
148−.PHONY: .FORCE deps quick full haddock install clean test bench changes_github dist prof download_stats reformat lint weigh doc/lua-filters.md pandoc-templates trypandoc update-website debpkg checkdocs ghcid ghci fix_spacing hlint check check-cabal
74+.PHONY: deps quick full install clean test bench changes_github osxpkg dist prof download_stats
PROFILINGnew file+6
@@ -0,0 +1,6 @@
1+To use the GHC profiler:
2+
3+cabal clean
4+cabal install --enable-library-profiling --enable-executable-profiling
5+pandoc +RTS -p -RTS [file]...
6+less pandoc.prof
README.md+120−244
@@ -1,244 +1,120 @@
1−<!-- Do not edit this file. It is generated automatically from
1+Pandoc
2−README.template and MANUAL.txt via the command:
2+======
3−pandoc --lua-filter tools/update-readme.lua README.template -o README.md
3+
4−-->
4+The universal markup converter
5−
5+------------------------------
6−# Pandoc
6+
7−
7+Pandoc is a [Haskell] library for converting from one markup format to
8−[![github
8+another, and a command-line tool that uses this library. It can read
9−release](https://img.shields.io/github/release/jgm/pandoc.svg?label=current+release)](https://github.com/jgm/pandoc/releases)
9+[Markdown], [CommonMark], [PHP Markdown Extra], [GitHub-Flavored Markdown],
10−[![hackage
10+[MultiMarkdown], and (subsets of) [Textile], [reStructuredText], [HTML],
11−release](https://img.shields.io/hackage/v/pandoc.svg?label=hackage)](https://hackage.haskell.org/package/pandoc)
11+[LaTeX], [MediaWiki markup], [TWiki markup], [Haddock markup], [OPML], [Emacs
12−[![homebrew](https://img.shields.io/homebrew/v/pandoc.svg)](https://formulae.brew.sh/formula/pandoc)
12+Org mode], [DocBook], [txt2tags], [EPUB], [ODT] and [Word docx]; and it can
13−[![stackage LTS
13+write plain text, [Markdown], [CommonMark], [PHP Markdown Extra],
14−package](https://stackage.org/package/pandoc/badge/lts)](https://www.stackage.org/lts/package/pandoc-types)
14+[GitHub-Flavored Markdown], [MultiMarkdown], [reStructuredText], [XHTML],
15−[![CI
15+[HTML5], [LaTeX] \(including [`beamer`] slide shows\), [ConTeXt], [RTF], [OPML],
16−tests](https://github.com/jgm/pandoc/workflows/CI%20tests/badge.svg)](https://github.com/jgm/pandoc/actions)
16+[DocBook], [OpenDocument], [ODT], [Word docx], [GNU Texinfo], [MediaWiki
17−[![license](https://img.shields.io/badge/license-GPLv2+-lightgray.svg)](https://www.gnu.org/licenses/gpl.html)
17+markup], [DokuWiki markup], [ZimWiki markup], [Haddock markup],
18−[![pandoc-discuss on google
18+[EPUB] \(v2 or v3\), [FictionBook2], [Textile], [groff man] pages,
19−groups](https://img.shields.io/badge/pandoc-discuss-red.svg?style=social)](https://groups.google.com/forum/#!forum/pandoc-discuss)
19+[Emacs Org mode], [AsciiDoc], [InDesign ICML], [TEI Simple], and [Slidy],
20−
20+[Slideous], [DZSlides], [reveal.js] or [S5] HTML slide shows. It can also
21−## The universal markup converter
21+produce [PDF] output on systems where LaTeX, ConTeXt, or `wkhtmltopdf` is
22−
22+installed.
23−Pandoc is a [Haskell](https://haskell.org) library for converting from
23+
24−one markup format to another, and a command-line tool that uses this
24+Pandoc's enhanced version of Markdown includes syntax for footnotes, tables,
25−library. It can convert *from*
25+flexible ordered lists, definition lists, fenced code blocks, superscripts and
26−
26+subscripts, strikeout, metadata blocks, automatic tables of contents, embedded
27−<div id="input-formats">
27+LaTeX math, citations, and Markdown inside HTML block elements. (These
28−
28+enhancements, described in the manual under *pandoc's Markdown*, can be
29−- `bibtex` ([BibTeX](https://ctan.org/pkg/bibtex) bibliography)
29+disabled using the `markdown_strict` input or output format.)
30−- `biblatex` ([BibLaTeX](https://ctan.org/pkg/biblatex) bibliography)
30+
31−- `commonmark` ([CommonMark](https://commonmark.org) Markdown)
31+In contrast to most existing tools for converting Markdown to HTML, which
32−- `commonmark_x` ([CommonMark](https://commonmark.org) Markdown with
32+use regex substitutions, pandoc has a modular design: it consists of a
33− extensions)
33+set of readers, which parse text in a given format and produce a native
34−- `creole` ([Creole 1.0](http://www.wikicreole.org/wiki/Creole1.0))
34+representation of the document, and a set of writers, which convert
35−- `csljson` ([CSL
35+this native representation into a target format. Thus, adding an input
36− JSON](https://citeproc-js.readthedocs.io/en/latest/csl-json/markup.html)
36+or output format requires only adding a reader or writer.
37− bibliography)
37+
38−- `csv` ([CSV](https://tools.ietf.org/html/rfc4180) table)
38+Because pandoc's intermediate representation of a document is less
39−- `docbook` ([DocBook](https://docbook.org))
39+expressive than many of the formats it converts between, one should
40−- `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))
40+not expect perfect conversions between every format and every other.
41−- `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))
41+Pandoc attempts to preserve the structural elements of a document, but
42−- `epub` ([EPUB](http://idpf.org/epub))
42+not formatting details such as margin size. And some document elements,
43−- `fb2`
43+such as complex tables, may not fit into pandoc's simple document
44− ([FictionBook2](http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1)
44+model. While conversions from pandoc's Markdown to all formats aspire
45− e-book)
45+to be perfect, conversions from formats more expressive than pandoc's
46−- `gfm` ([GitHub-Flavored
46+Markdown can be expected to be lossy.
47− Markdown](https://help.github.com/articles/github-flavored-markdown/)),
47+
48− or the deprecated and less accurate `markdown_github`; use
48+[Markdown]: http://daringfireball.net/projects/markdown/
49− [`markdown_github`](https://pandoc.org/MANUAL.html#markdown-variants)
49+[CommonMark]: http://commonmark.org
50− only if you need extensions not supported in
50+[PHP Markdown Extra]: https://michelf.ca/projects/php-markdown/extra/
51− [`gfm`](https://pandoc.org/MANUAL.html#markdown-variants).
51+[GitHub-Flavored Markdown]: https://help.github.com/articles/github-flavored-markdown/
52−- `haddock` ([Haddock
52+[MultiMarkdown]: http://fletcherpenney.net/multimarkdown/
53− markup](https://www.haskell.org/haddock/doc/html/ch03s08.html))
53+[reStructuredText]: http://docutils.sourceforge.net/docs/ref/rst/introduction.html
54−- `html` ([HTML](https://www.w3.org/html/))
54+[S5]: http://meyerweb.com/eric/tools/s5/
55−- `ipynb` ([Jupyter
55+[Slidy]: http://www.w3.org/Talks/Tools/Slidy/
56− notebook](https://nbformat.readthedocs.io/en/latest/))
56+[Slideous]: http://goessner.net/articles/slideous/
57−- `jats` ([JATS](https://jats.nlm.nih.gov) XML)
57+[HTML]: http://www.w3.org/html/
58−- `jira`
58+[HTML5]: http://www.w3.org/TR/html5/
59− ([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)/Confluence
59+[XHTML]: http://www.w3.org/TR/xhtml1/
60− wiki markup)
60+[LaTeX]: http://latex-project.org
61−- `json` (JSON version of native AST)
61+[`beamer`]: https://ctan.org/pkg/beamer
62−- `latex` ([LaTeX](https://www.latex-project.org/))
62+[Beamer User's Guide]: http://ctan.math.utah.edu/ctan/tex-archive/macros/latex/contrib/beamer/doc/beameruserguide.pdf
63−- `markdown` ([Pandoc’s
63+[ConTeXt]: http://contextgarden.net/
64− Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown))
64+[RTF]: http://en.wikipedia.org/wiki/Rich_Text_Format
65−- `markdown_mmd`
65+[DocBook]: http://docbook.org
66− ([MultiMarkdown](https://fletcherpenney.net/multimarkdown/))
66+[txt2tags]: http://txt2tags.org
67−- `markdown_phpextra` ([PHP Markdown
67+[EPUB]: http://idpf.org/epub
68− Extra](https://michelf.ca/projects/php-markdown/extra/))
68+[OPML]: http://dev.opml.org/spec2.html
69−- `markdown_strict` (original unextended
69+[OpenDocument]: http://opendocument.xml.org
70− [Markdown](https://daringfireball.net/projects/markdown/))
70+[ODT]: http://en.wikipedia.org/wiki/OpenDocument
71−- `mediawiki` ([MediaWiki
71+[Textile]: http://redcloth.org/textile
72− markup](https://www.mediawiki.org/wiki/Help:Formatting))
72+[MediaWiki markup]: https://www.mediawiki.org/wiki/Help:Formatting
73−- `man` ([roff man](https://man.cx/groff_man(7)))
73+[DokuWiki markup]: https://www.dokuwiki.org/dokuwiki
74−- `muse` ([Muse](https://amusewiki.org/library/manual))
74+[ZimWiki markup]: http://zim-wiki.org/manual/Help/Wiki_Syntax.html
75−- `native` (native Haskell)
75+[TWiki markup]: http://twiki.org/cgi-bin/view/TWiki/TextFormattingRules
76−- `odt` ([ODT](https://en.wikipedia.org/wiki/OpenDocument))
76+[Haddock markup]: https://www.haskell.org/haddock/doc/html/ch03s08.html
77−- `opml` ([OPML](http://dev.opml.org/spec2.html))
77+[groff man]: http://developer.apple.com/DOCUMENTATION/Darwin/Reference/ManPages/man7/groff_man.7.html
78−- `org` ([Emacs Org mode](https://orgmode.org))
78+[Haskell]: https://www.haskell.org
79−- `rst`
79+[GNU Texinfo]: http://www.gnu.org/software/texinfo/
80− ([reStructuredText](https://docutils.sourceforge.io/docs/ref/rst/introduction.html))
80+[Emacs Org mode]: http://orgmode.org
81−- `t2t` ([txt2tags](https://txt2tags.org))
81+[AsciiDoc]: http://www.methods.co.nz/asciidoc/
82−- `textile` ([Textile](https://www.promptworks.com/textile))
82+[DZSlides]: http://paulrouget.com/dzslides/
83−- `tikiwiki` ([TikiWiki
83+[Word docx]: http://www.microsoft.com/interop/openup/openxml/default.aspx
84− markup](https://doc.tiki.org/Wiki-Syntax-Text#The_Markup_Language_Wiki-Syntax))
84+[PDF]: https://www.adobe.com/pdf/
85−- `twiki` ([TWiki
85+[reveal.js]: http://lab.hakim.se/reveal-js/
86− markup](https://twiki.org/cgi-bin/view/TWiki/TextFormattingRules))
86+[FictionBook2]: http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1
87−- `vimwiki` ([Vimwiki](https://vimwiki.github.io))
87+[InDesign ICML]: https://www.adobe.com/content/dam/Adobe/en/devnet/indesign/cs55-docs/IDML/idml-specification.pdf
88−
88+[TEI Simple]: https://github.com/TEIC/TEI-Simple
89−</div>
89+
90−
90+[![license](https://img.shields.io/badge/license-GPLv2+-brightgreen.svg)](https://www.gnu.org/licenses/gpl.html)
91−It can convert *to*
91+[![hackage release](https://img.shields.io/hackage/v/pandoc.svg?label=current+release)](http://hackage.haskell.org/package/pandoc)
92−
92+[![stackage LTS package](http://stackage.org/package/pandoc/badge/lts)](http://stackage.org/lts/package/pandoc)
93−<div id="output-formats">
93+[![github release](https://img.shields.io/github/release/jgm/pandoc.svg?label=github+release)](https://github.com/jgm/pandoc/releases)
94−
94+[![travis build status](https://img.shields.io/travis/jgm/pandoc.svg)](https://travis-ci.org/jgm/pandoc)
95−- `asciidoc` ([AsciiDoc](https://www.methods.co.nz/asciidoc/)) or
95+[![appveyor build status](https://ci.appveyor.com/api/projects/status/nvqs4ct090igjiqc?svg=true)](https://ci.appveyor.com/project/jgm/pandoc)
96− `asciidoctor` ([AsciiDoctor](https://asciidoctor.org/))
96+
97−- `beamer` ([LaTeX beamer](https://ctan.org/pkg/beamer) slide show)
97+
98−- `bibtex` ([BibTeX](https://ctan.org/pkg/bibtex) bibliography)
98+Documentation
99−- `biblatex` ([BibLaTeX](https://ctan.org/pkg/biblatex) bibliography)
99+-------------
100−- `commonmark` ([CommonMark](https://commonmark.org) Markdown)
100+
101−- `commonmark_x` ([CommonMark](https://commonmark.org) Markdown with
101+The full documentation can be found [online](http://pandoc.org/MANUAL.html)
102− extensions)
102+and as pandoc-flavored Markdown in the file `MANUAL.txt`.
103−- `context` ([ConTeXt](https://www.contextgarden.net/))
103+
104−- `csljson` ([CSL
104+
105− JSON](https://citeproc-js.readthedocs.io/en/latest/csl-json/markup.html)
105+Contributing
106− bibliography)
106+------------
107−- `docbook` or `docbook4` ([DocBook](https://docbook.org) 4)
107+
108−- `docbook5` (DocBook 5)
108+Pull requests, bug reports, and feature requests are welcome. Please make
109−- `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))
109+sure to read [the contributor guidelines](CONTRIBUTING.md) before opening a
110−- `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))
110+new issue.
111−- `epub` or `epub3` ([EPUB](http://idpf.org/epub) v3 book)
111+
112−- `epub2` (EPUB v2)
112+
113−- `fb2`
113+License
114− ([FictionBook2](http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1)
114+-------
115− e-book)
115+
116−- `gfm` ([GitHub-Flavored
116+© 2006-2016 John MacFarlane (jgm@berkeley.edu). Released under the
117− Markdown](https://help.github.com/articles/github-flavored-markdown/)),
117+[GPL], version 2 or greater. This software carries no warranty of
118− or the deprecated and less accurate `markdown_github`; use
118+any kind. (See COPYRIGHT for full copyright and warranty notices.)
119− [`markdown_github`](https://pandoc.org/MANUAL.html#markdown-variants)
119+
120− only if you need extensions not supported in
120+[GPL]: http://www.gnu.org/copyleft/gpl.html "GNU General Public License"
121− [`gfm`](https://pandoc.org/MANUAL.html#markdown-variants).
122−- `haddock` ([Haddock
123− markup](https://www.haskell.org/haddock/doc/html/ch03s08.html))
124−- `html` or `html5` ([HTML](https://www.w3.org/html/),
125− i.e. [HTML5](https://html.spec.whatwg.org/)/XHTML [polyglot
126− markup](https://www.w3.org/TR/html-polyglot/))
127−- `html4` ([XHTML](https://www.w3.org/TR/xhtml1/) 1.0 Transitional)
128−- `icml` ([InDesign
129− ICML](https://wwwimages.adobe.com/www.adobe.com/content/dam/acom/en/devnet/indesign/sdk/cs6/idml/idml-cookbook.pdf))
130−- `ipynb` ([Jupyter
131− notebook](https://nbformat.readthedocs.io/en/latest/))
132−- `jats_archiving` ([JATS](https://jats.nlm.nih.gov) XML, Archiving
133− and Interchange Tag Set)
134−- `jats_articleauthoring` ([JATS](https://jats.nlm.nih.gov) XML,
135− Article Authoring Tag Set)
136−- `jats_publishing` ([JATS](https://jats.nlm.nih.gov) XML, Journal
137− Publishing Tag Set)
138−- `jats` (alias for `jats_archiving`)
139−- `jira`
140− ([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)/Confluence
141− wiki markup)
142−- `json` (JSON version of native AST)
143−- `latex` ([LaTeX](https://www.latex-project.org/))
144−- `man` ([roff man](https://man.cx/groff_man(7)))
145−- `markdown` ([Pandoc’s
146− Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown))
147−- `markdown_mmd`
148− ([MultiMarkdown](https://fletcherpenney.net/multimarkdown/))
149−- `markdown_phpextra` ([PHP Markdown
150− Extra](https://michelf.ca/projects/php-markdown/extra/))
151−- `markdown_strict` (original unextended
152− [Markdown](https://daringfireball.net/projects/markdown/))
153−- `mediawiki` ([MediaWiki
154− markup](https://www.mediawiki.org/wiki/Help:Formatting))
155−- `ms` ([roff ms](https://man.cx/groff_ms(7)))
156−- `muse` ([Muse](https://amusewiki.org/library/manual)),
157−- `native` (native Haskell),
158−- `odt` ([OpenOffice text
159− document](https://en.wikipedia.org/wiki/OpenDocument))
160−- `opml` ([OPML](http://dev.opml.org/spec2.html))
161−- `opendocument` ([OpenDocument](http://opendocument.xml.org))
162−- `org` ([Emacs Org mode](https://orgmode.org))
163−- `pdf` ([PDF](https://www.adobe.com/pdf/))
164−- `plain` (plain text),
165−- `pptx`
166− ([PowerPoint](https://en.wikipedia.org/wiki/Microsoft_PowerPoint)
167− slide show)
168−- `rst`
169− ([reStructuredText](https://docutils.sourceforge.io/docs/ref/rst/introduction.html))
170−- `rtf` ([Rich Text
171− Format](https://en.wikipedia.org/wiki/Rich_Text_Format))
172−- `texinfo` ([GNU Texinfo](https://www.gnu.org/software/texinfo/))
173−- `textile` ([Textile](https://www.promptworks.com/textile))
174−- `slideous` ([Slideous](https://goessner.net/articles/slideous/) HTML
175− and JavaScript slide show)
176−- `slidy` ([Slidy](https://www.w3.org/Talks/Tools/Slidy2/) HTML and
177− JavaScript slide show)
178−- `dzslides` ([DZSlides](https://paulrouget.com/dzslides/) HTML5 +
179− JavaScript slide show),
180−- `revealjs` ([reveal.js](https://revealjs.com/) HTML5 + JavaScript
181− slide show)
182−- `s5` ([S5](https://meyerweb.com/eric/tools/s5/) HTML and JavaScript
183− slide show)
184−- `tei` ([TEI Simple](https://github.com/TEIC/TEI-Simple))
185−- `xwiki` ([XWiki
186− markup](https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiSyntax/))
187−- `zimwiki` ([ZimWiki
188− markup](https://zim-wiki.org/manual/Help/Wiki_Syntax.html))
189−- the path of a custom Lua writer, see [Custom
190− writers](https://pandoc.org/MANUAL.html#custom-writers) below
191−
192−</div>
193−
194−Pandoc can also produce PDF output via LaTeX, Groff ms, or HTML.
195−
196−Pandoc’s enhanced version of Markdown includes syntax for tables,
197−definition lists, metadata blocks, footnotes, citations, math, and much
198−more. See the User’s Manual below under [Pandoc’s
199−Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown).
200−
201−Pandoc has a modular design: it consists of a set of readers, which
202−parse text in a given format and produce a native representation of the
203−document (an *abstract syntax tree* or AST), and a set of writers, which
204−convert this native representation into a target format. Thus, adding an
205−input or output format requires only adding a reader or writer. Users
206−can also run custom pandoc filters to modify the intermediate AST (see
207−the documentation for [filters](https://pandoc.org/filters.html) and
208−[Lua filters](https://pandoc.org/lua-filters.html)).
209−
210−Because pandoc’s intermediate representation of a document is less
211−expressive than many of the formats it converts between, one should not
212−expect perfect conversions between every format and every other. Pandoc
213−attempts to preserve the structural elements of a document, but not
214−formatting details such as margin size. And some document elements, such
215−as complex tables, may not fit into pandoc’s simple document model.
216−While conversions from pandoc’s Markdown to all formats aspire to be
217−perfect, conversions from formats more expressive than pandoc’s Markdown
218−can be expected to be lossy.
219−
220−## Installing
221−
222−Here’s [how to install pandoc](INSTALL.md).
223−
224−## Documentation
225−
226−Pandoc’s website contains a full [User’s
227−Guide](https://pandoc.org/MANUAL.html). It is also available
228−[here](MANUAL.txt) as pandoc-flavored Markdown. The website also
229−contains some [examples of the use of
230−pandoc](https://pandoc.org/demos.html) and a limited [online
231−demo](https://pandoc.org/try).
232−
233−## Contributing
234−
235−Pull requests, bug reports, and feature requests are welcome. Please
236−make sure to read [the contributor guidelines](CONTRIBUTING.md) before
237−opening a new issue.
238−
239−## License
240−
241−© 2006-2021 John MacFarlane (jgm@berkeley.edu). Released under the
242−[GPL](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html "GNU General Public License"),
243−version 2 or greater. This software carries no warranty of any kind.
244−(See COPYRIGHT for full copyright and warranty notices.)
README.templatedeleted−89
@@ -1,89 +0,0 @@
1−<!-- Do not edit this file. It is generated automatically from
2−README.template and MANUAL.txt via the command:
3−pandoc --lua-filter tools/update-readme.lua README.template -o README.md
4−-->
5−
6−Pandoc
7−======
8−
9−[![github release](https://img.shields.io/github/release/jgm/pandoc.svg?label=current+release)](https://github.com/jgm/pandoc/releases)
10−[![hackage release](https://img.shields.io/hackage/v/pandoc.svg?label=hackage)](https://hackage.haskell.org/package/pandoc)
11−[![homebrew](https://img.shields.io/homebrew/v/pandoc.svg)](https://formulae.brew.sh/formula/pandoc)
12−[![stackage LTS package](https://stackage.org/package/pandoc/badge/lts)](https://www.stackage.org/lts/package/pandoc-types)
13−[![CI tests](https://github.com/jgm/pandoc/workflows/CI%20tests/badge.svg)](https://github.com/jgm/pandoc/actions)
14−[![license](https://img.shields.io/badge/license-GPLv2+-lightgray.svg)](https://www.gnu.org/licenses/gpl.html)
15−[![pandoc-discuss on google groups](https://img.shields.io/badge/pandoc-discuss-red.svg?style=social)](https://groups.google.com/forum/#!forum/pandoc-discuss)
16−
17−
18−The universal markup converter
19−------------------------------
20−
21−Pandoc is a [Haskell] library for converting from one markup format to
22−another, and a command-line tool that uses this library. It can convert *from*
23−
24−::: {#input-formats}
25−:::
26−
27−It can convert *to*
28−
29−::: {#output-formats}
30−:::
31−
32−Pandoc can also produce PDF output via LaTeX, Groff ms, or HTML.
33−
34−Pandoc's enhanced version of Markdown includes syntax for tables,
35−definition lists, metadata blocks, footnotes, citations, math,
36−and much more. See the User's Manual below under
37−[Pandoc's Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown).
38−
39−Pandoc has a modular design: it consists of a set of readers, which parse
40−text in a given format and produce a native representation of the document
41−(an _abstract syntax tree_ or AST), and a set of writers, which convert
42−this native representation into a target format. Thus, adding an input
43−or output format requires only adding a reader or writer. Users can also
44−run custom pandoc filters to modify the intermediate AST (see
45−the documentation for [filters](https://pandoc.org/filters.html)
46−and [Lua filters](https://pandoc.org/lua-filters.html)).
47−
48−Because pandoc's intermediate representation of a document is less
49−expressive than many of the formats it converts between, one should
50−not expect perfect conversions between every format and every other.
51−Pandoc attempts to preserve the structural elements of a document, but
52−not formatting details such as margin size. And some document elements,
53−such as complex tables, may not fit into pandoc's simple document
54−model. While conversions from pandoc's Markdown to all formats aspire
55−to be perfect, conversions from formats more expressive than pandoc's
56−Markdown can be expected to be lossy.
57−
58−
59−Installing
60−----------
61−
62−Here's [how to install pandoc](INSTALL.md).
63−
64−Documentation
65−-------------
66−
67−Pandoc's website contains a full [User's Guide](https://pandoc.org/MANUAL.html).
68−It is also available [here](MANUAL.txt) as pandoc-flavored Markdown.
69−The website also contains some [examples of the use of
70−pandoc](https://pandoc.org/demos.html) and a limited [online
71−demo](https://pandoc.org/try).
72−
73−Contributing
74−------------
75−
76−Pull requests, bug reports, and feature requests are welcome. Please make
77−sure to read [the contributor guidelines](CONTRIBUTING.md) before opening a
78−new issue.
79−
80−
81−License
82−-------
83−
84−© 2006-2021 John MacFarlane (jgm@berkeley.edu). Released under the
85−[GPL], version 2 or greater. This software carries no warranty of
86−any kind. (See COPYRIGHT for full copyright and warranty notices.)
87−
88−[GPL]: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html "GNU General Public License"
89−[Haskell]: https://haskell.org
RELEASE-CHECKLIST+34−20
@@ -1,21 +1,35 @@
1−[ ] use 'policeman' to check API changes and version update
1+_ Test, on linux, windows, mac (inc. website demos)
2−[ ] make README.md and commit if needed
2+
3−[ ] make man/pandoc.1 and commit if needed
3+_ Finalize changelog
4−[ ] Finalize changelog
4+ git log --pretty='format:%n%n* %s (%an)%n%b%n%h%n' --reverse --name-only 1.17.0.3..HEAD > LOG
5−[ ] push release candidate branch rc/VERSION and (if it builds
5+
6− successfully) download artifacts
6+_ make man/pandoc.1 and commit if needed
7−[ ] run tools/build-arm.sh to create and download arm64 linux package
7+
8−[ ] download macos artifacts from CircleCI
8+_ Tag release in git
9−[ ] Use 'make' in macos and windows artifacts to sign code
9+
10−[ ] make update-website
10+_ Tag templates
11−[ ] make trypandoc
11+
12−[ ] Tag release in git
12+_ 'make dist' to generate tarball
13−[ ] make pandoc-templates
13+
14− cd ../pandoc-templates
14+_ Generate Windows package and copy to directory.
15− git tag REL
15+
16− git push
16+_ Generate Mac OSX package.
17− git push --tags
17+
18−[ ] Add release on github (use 'make changes_github' and upload files)
18+_ Generate Ubuntu/Debian deb package (cd deb; make package).
19−[ ] stack upload .
19+
20−[ ] Announce on pandoc-announce, pandoc-discuss
20+- Add release on github (use 'make changes_github' and upload files)
21+
22+_ Upload to HackageDB
23+
24+_ if docs don't build on Hackage:
25+ 'cabal install neil && neil docs --username=MYUSERNAME'
26+
27+_ Update website, including short description of changes ('make changes')
28+
29+_ Announce on pandoc-announce, pandoc-discuss
30+
31+_ on server, 'cabal install --enable-tests -ftrypandoc'
32+ and then 'cd trypandoc; sudo make install'
33+
34+_ recompile gitit
21
35
SECURITY.mddeleted−12
@@ -1,12 +0,0 @@
1−# Security Policy
2−
3−## Supported Versions
4−
5−Only the most recent version of pandoc is supported with security updates.
6−
7−## Reporting a Vulnerability
8−
9−To report a vulnerability, email the maintainer, jgm@berkeley.edu.
10−But first please read the section of the manual entitled
11−[A note on security](https://pandoc.org/MANUAL.html#a-note-on-security),
12−which describes some security guarantees pandoc does NOT make.
Setup.hs+69−1
@@ -1,2 +1,70 @@
1+{-
2+Copyright (C) 2006-2015 John MacFarlane <jgm@berkeley.edu>
3+
4+This program is free software; you can redistribute it and/or modify
5+it under the terms of the GNU General Public License as published by
6+the Free Software Foundation; either version 2 of the License, or
7+(at your option) any later version.
8+
9+This program is distributed in the hope that it will be useful,
10+but WITHOUT ANY WARRANTY; without even the implied warranty of
11+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12+GNU General Public License for more details.
13+
14+You should have received a copy of the GNU General Public License
15+along with this program; if not, write to the Free Software
16+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17+-}
18+
1import Distribution.Simple
19import Distribution.Simple
2−main = defaultMain
20+import Distribution.Simple.PreProcess
21+import Distribution.Simple.Setup (ConfigFlags(..))
22+import Distribution.PackageDescription (PackageDescription(..), FlagName(..))
23+import Distribution.Simple.Utils ( rawSystemExitCode, findProgramVersion )
24+import System.Exit
25+import Distribution.Verbosity ( Verbosity )
26+import Distribution.Simple.Utils (info, notice, installOrdinaryFiles)
27+import Distribution.Simple.Setup
28+import Distribution.Simple.Program (simpleProgram, Program(..))
29+import Distribution.Simple.LocalBuildInfo
30+import Data.Version
31+import Control.Monad (when)
32+import qualified Control.Exception as E
33+
34+main :: IO ()
35+main = defaultMainWithHooks $ simpleUserHooks {
36+ -- enable hsb2hs preprocessor for .hsb files
37+ hookedPreProcessors = [ppBlobSuffixHandler]
38+ , hookedPrograms = [(simpleProgram "hsb2hs"){
39+ programFindVersion = \verbosity fp ->
40+ findProgramVersion "--version" id verbosity fp }]
41+ , postCopy = installManPage
42+ }
43+
44+ppBlobSuffixHandler :: PPSuffixHandler
45+ppBlobSuffixHandler = ("hsb", \_ lbi ->
46+ PreProcessor {
47+ platformIndependent = True,
48+ runPreProcessor = mkSimplePreProcessor $ \infile outfile verbosity ->
49+ do let embedData = case lookup (FlagName "embed_data_files")
50+ (configConfigurationsFlags (configFlags lbi)) of
51+ Just True -> True
52+ _ -> False
53+ when embedData $
54+ do info verbosity $ "Preprocessing " ++ infile ++ " to " ++ outfile
55+ ec <- rawSystemExitCode verbosity "hsb2hs"
56+ [infile, infile, outfile]
57+ case ec of
58+ ExitSuccess -> return ()
59+ ExitFailure _ -> error "hsb2hs is needed to build this program"
60+ })
61+
62+installManPage :: Args -> CopyFlags
63+ -> PackageDescription -> LocalBuildInfo -> IO ()
64+installManPage _ flags pkg lbi = do
65+ let verbosity = fromFlag (copyVerbosity flags)
66+ let copydest = fromFlag (copyDest flags)
67+ let mandest = mandir (absoluteInstallDirs pkg lbi copydest)
68+ ++ "/man1"
69+ notice verbosity $ "Copying man page to " ++ mandest
70+ installOrdinaryFiles verbosity mandest [("man", "pandoc.1")]
app/pandoc.hsdeleted−20
@@ -1,20 +0,0 @@
1−{- |
2− Module : Main
3− Copyright : Copyright (C) 2006-2021 John MacFarlane
4− License : GNU GPL, version 2 or above
5−
6− Maintainer : John MacFarlane <jgm@berkeley@edu>
7− Stability : alpha
8− Portability : portable
9−
10−Parses command-line options and calls the appropriate readers and
11−writers.
12−-}
13−module Main where
14−import qualified Control.Exception as E
15−import Text.Pandoc.App (convertWithOpts, defaultOpts, options, parseOptions)
16−import Text.Pandoc.Error (handleError)
17−
18−main :: IO ()
19−main = E.catch (parseOptions options defaultOpts >>= convertWithOpts)
20− (handleError . Left)
appveyor.ymlnew file+54
@@ -0,0 +1,54 @@
1+clone_folder: "c:\\stack"
2+environment:
3+ global:
4+ STACK_ROOT: "c:\\sr"
5+ STACK_YAML: "c:\\stack\\windows\\stack.yaml"
6+ WIXBIN: "c:\\Program Files (x86)\\WiX Toolset v3.10\\bin"
7+
8+cache:
9+ - "c:\\sr" # stack root, short paths == fewer problems
10+ - "c:\\stack\\stack.exe"
11+ - '%WIXBIN%'
12+
13+# We don't do a normal C build, but build in test_script via stack
14+build: off
15+
16+install:
17+ - '"%WIXBIN%"\candle -? || choco install wixtoolset'
18+ - |
19+ stack --version || curl -ostack.zip -L --insecure http://www.stackage.org/stack/windows-i386 && 7z x stack.zip stack.exe
20+ - stack setup > nul
21+
22+before_test:
23+ # the stack install already fails without the templates...
24+ - git submodule update --init
25+ # set PATH to where the hsb2hs binary is copied to
26+ - cmd: set "PATH=%PATH%;%APPDATA%\\local\\bin"
27+ - stack install hsb2hs
28+
29+test_script:
30+ # The ugly echo "" hack is to avoid complaints about 0 being an invalid file
31+ # descriptor
32+ - echo "" | stack clean
33+ - echo "" | stack --no-terminal test
34+ - echo "" | stack --local-bin-path . install pandoc pandoc-citeproc
35+
36+after_test:
37+ # .\ in the stack commandline seems to be .\windows\ (where the stack-appveyor.yaml is)
38+ - cd windows
39+ - 7z a "pandoc.zip" pandoc.exe
40+ - .\pandoc.exe -s -S --toc ..\MANUAL.txt -o MANUAL.html
41+ - .\pandoc.exe -s -S ..\COPYING -o COPYING.rtf
42+ - copy ..\COPYRIGHT COPYRIGHT.txt
43+ - |
44+ set VERSION=
45+ for /f "tokens=1-2 delims= " %%a in ('.\pandoc.exe --version') do ( if not defined VERSION set "VERSION=%%b" )
46+ echo %VERSION%
47+ "%WIXBIN%\\candle" -dVERSION=%VERSION% -dBINPATH=. *.wxs -out wixobj\
48+ "%WIXBIN%\\light" -sw1076 -ext WixUIExtension -ext WixUtilExtension -cultures:en-us -loc Pandoc-en-us.wxl -out pandoc.msi wixobj\*.wixobj
49+
50+artifacts:
51+ - path: windows\pandoc.zip
52+ name: exe
53+ - path: windows\pandoc.msi
54+ name: msi
benchmark/benchmark-pandoc.hs+29−78
@@ -1,6 +1,5 @@
1−{-# LANGUAGE OverloadedStrings #-}
2{-
1{-
3−Copyright (C) 2012-2021 John MacFarlane <jgm@berkeley.edu>
2+Copyright (C) 2012-2014 John MacFarlane <jgm@berkeley.edu>
4
3
5This program is free software; you can redistribute it and/or modify
4This program is free software; you can redistribute it and/or modify
6it under the terms of the GNU General Public License as published by
5it under the terms of the GNU General Public License as published by
@@ -17,87 +16,39 @@ along with this program; if not, write to the Free Software
17Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18-}
17-}
19import Text.Pandoc
18import Text.Pandoc
20−import Text.Pandoc.MIME
19+import Criterion.Main
21−import Control.DeepSeq (force)
20+import Criterion.Types (Config(..))
22−import Control.Monad.Except (throwError)
23−import qualified Text.Pandoc.UTF8 as UTF8
24−import qualified Data.ByteString as B
25−import qualified Data.Text as T
26−import Test.Tasty.Bench
27−-- import Gauge
28−import qualified Data.ByteString.Lazy as BL
29import Data.Maybe (mapMaybe)
21import Data.Maybe (mapMaybe)
30−import Data.List (sortOn)
22+import Debug.Trace (trace)
23+import Text.Pandoc.Error
31
24
32readerBench :: Pandoc
25readerBench :: Pandoc
33− -> T.Text
26+ -> (String, ReaderOptions -> String -> IO (Either PandocError Pandoc))
34 -> Maybe Benchmark
27 -> Maybe Benchmark
35−readerBench _ name
28+readerBench doc (name, reader) =
36− | name `elem` ["bibtex", "biblatex", "csljson"] = Nothing
29+ case lookup name writers of
37−readerBench doc name = either (const Nothing) Just $
30+ Just (PureStringWriter writer) ->
38− runPure $ do
31+ let inp = writer def{ writerWrapText = WrapAuto} doc
39− (rdr, rexts) <- getReader name
32+ in return $ bench (name ++ " reader") $ nfIO $
40− (wtr, wexts) <- getWriter name
33+ (fmap handleError <$> reader def{ readerSmart = True }) inp
41− case (rdr, wtr) of
34+ _ -> trace ("\nCould not find writer for " ++ name ++ "\n") Nothing
42− (TextReader r, TextWriter w) -> do
43− inp <- w def{ writerWrapText = WrapAuto
44− , writerExtensions = wexts } doc
45− return $ bench (T.unpack name) $
46− nf (either (error . show) id . runPure . r def) inp
47− (ByteStringReader r, ByteStringWriter w) -> do
48− tmpl <- Just <$> compileDefaultTemplate name
49− inp <- w def{ writerWrapText = WrapAuto
50− , writerExtensions = wexts
51− , writerTemplate = tmpl } doc
52− return $ bench (T.unpack name) $
53− nf (either (error . show) id .
54− runPure . r def{readerExtensions = rexts}) inp
55− _ -> throwError $ PandocSomeError $ "text/bytestring format mismatch: "
56− <> name
57
35
58−getImages :: IO [(FilePath, MimeType, BL.ByteString)]
36+writerBench :: Pandoc
59−getImages = do
37+ -> (String, WriterOptions -> Pandoc -> String)
60− ll <- B.readFile "test/lalune.jpg"
38+ -> Benchmark
61− mv <- B.readFile "test/movie.jpg"
39+writerBench doc (name, writer) = bench (name ++ " writer") $ nf
62− return [("lalune.jpg", "image/jpg", BL.fromStrict ll)
40+ (writer def{ writerWrapText = WrapAuto }) doc
63− ,("movie.jpg", "image/jpg", BL.fromStrict mv)]
64−
65−writerBench :: [(FilePath, MimeType, BL.ByteString)]
66− -> Pandoc
67− -> T.Text
68− -> Maybe Benchmark
69−writerBench _ _ name
70− | name `elem` ["bibtex", "biblatex", "csljson"] = Nothing
71−writerBench imgs doc name = either (const Nothing) Just $
72− runPure $ do
73− (wtr, wexts) <- getWriter name
74− case wtr of
75− TextWriter writerFun ->
76− return $ bench (T.unpack name)
77− $ nf (\d -> either (error . show) id $
78− runPure $ do
79− mapM_ (\(fp,mt,bs) -> insertMedia fp (Just mt) bs) imgs
80− writerFun def{ writerExtensions = wexts} d)
81− doc
82− ByteStringWriter writerFun ->
83− return $ bench (T.unpack name)
84− $ nf (\d -> either (error . show) id $
85− runPure $ do
86− mapM_ (\(fp,mt,bs) -> insertMedia fp (Just mt) bs) imgs
87− writerFun def{ writerExtensions = wexts} d)
88− doc
89
41
90main :: IO ()
42main :: IO ()
91main = do
43main = do
92− inp <- UTF8.toText <$> B.readFile "test/testsuite.txt"
44+ inp <- readFile "tests/testsuite.txt"
93− let opts = def
45+ let opts = def{ readerSmart = True }
94− let doc = either (error . show) force $ runPure $ readMarkdown opts inp
46+ let doc = handleError $ readMarkdown opts inp
95− defaultMain
47+ let readers' = [(n,r) | (n, StringReader r) <- readers]
96− [ env getImages $ \imgs ->
48+ let readerBs = mapMaybe (readerBench doc)
97− bgroup "writers" $ mapMaybe (writerBench imgs doc . fst)
49+ $ filter (\(n,_) -> n /="haddock") readers'
98− (sortOn fst
50+ let writers' = [(n,w) | (n, PureStringWriter w) <- writers]
99− writers :: [(T.Text, Writer PandocPure)])
51+ let writerBs = map (writerBench doc)
100− , bgroup "readers" $ mapMaybe (readerBench doc . fst)
52+ $ writers'
101− (sortOn fst
53+ defaultMainWith defaultConfig{ timeLimit = 6.0 }
102− readers :: [(T.Text, Reader PandocPure)])
54+ (writerBs ++ readerBs)
103− ]
cabal.projectdeleted−13
@@ -1,13 +0,0 @@
1−packages: pandoc.cabal
2−tests: True
3−flags: +embed_data_files
4−
5−source-repository-package
6− type: git
7− location: https://github.com/jgm/doctemplates
8− tag: 428c26d5303cf7a2b1051fe1ffd9aafe9ba71c81
9−
10−source-repository-package
11− type: git
12− location: https://github.com/jgm/citeproc
13− tag: 4ce0501cd6f9c86eee087afcf878c256e49b9615
changelognew file+10050

This diff is too big to show here.

changelog.mddeleted−20339

This diff is too big to show here.

citeproc/biblatex-localization/.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/UKenglish.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/USenglish.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/american.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/australian.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/austrian.lbx.stringsdeleted−1

This diff is too big to show here.

citeproc/biblatex-localization/brazil.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/brazilian.lbx.stringsdeleted−233

This diff is too big to show here.

citeproc/biblatex-localization/british.lbx.stringsdeleted−3

This diff is too big to show here.

citeproc/biblatex-localization/bulgarian.lbx.stringsdeleted−28

This diff is too big to show here.

citeproc/biblatex-localization/canadian.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/catalan.lbx.stringsdeleted−158

This diff is too big to show here.

citeproc/biblatex-localization/croatian.lbx.stringsdeleted−214

This diff is too big to show here.

citeproc/biblatex-localization/czech.lbx.stringsdeleted−91

This diff is too big to show here.

citeproc/biblatex-localization/danish.lbx.stringsdeleted−106

This diff is too big to show here.

citeproc/biblatex-localization/dutch.lbx.stringsdeleted−23

This diff is too big to show here.

citeproc/biblatex-localization/english.lbx.stringsdeleted−254

This diff is too big to show here.

citeproc/biblatex-localization/estonian.lbx.stringsdeleted−178

This diff is too big to show here.

citeproc/biblatex-localization/finnish.lbx.stringsdeleted−254

This diff is too big to show here.

citeproc/biblatex-localization/french.lbx.stringsdeleted−245

This diff is too big to show here.

citeproc/biblatex-localization/galician.lbx.stringsdeleted−28

This diff is too big to show here.

citeproc/biblatex-localization/german.lbx.stringsdeleted−28

This diff is too big to show here.

citeproc/biblatex-localization/greek.lbx.stringsdeleted−9

This diff is too big to show here.

citeproc/biblatex-localization/hungarian.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/icelandic.lbx.stringsdeleted−7

This diff is too big to show here.

citeproc/biblatex-localization/italian.lbx.stringsdeleted−9

This diff is too big to show here.

citeproc/biblatex-localization/latvian.lbx.stringsdeleted−75

This diff is too big to show here.

citeproc/biblatex-localization/lithuanian.lbx.stringsdeleted−31

This diff is too big to show here.

citeproc/biblatex-localization/magyar.lbx.stringsdeleted−29

This diff is too big to show here.

citeproc/biblatex-localization/naustrian.lbx.stringsdeleted−2

This diff is too big to show here.

citeproc/biblatex-localization/newzealand.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/ngerman.lbx.stringsdeleted−1

This diff is too big to show here.

citeproc/biblatex-localization/norsk.lbx.stringsdeleted−98

This diff is too big to show here.

citeproc/biblatex-localization/nswissgerman.lbx.stringsdeleted−2

This diff is too big to show here.

citeproc/biblatex-localization/nynorsk.lbx.stringsdeleted−28

This diff is too big to show here.

citeproc/biblatex-localization/polish.lbx.stringsdeleted−100

This diff is too big to show here.

citeproc/biblatex-localization/portuges.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/portuguese.lbx.stringsdeleted−95

This diff is too big to show here.

citeproc/biblatex-localization/russian.lbx.stringsdeleted−102

This diff is too big to show here.

citeproc/biblatex-localization/serbian.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/serbianc.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/slovak.lbx.stringsdeleted−82

This diff is too big to show here.

citeproc/biblatex-localization/slovene.lbx.stringsdeleted−28

This diff is too big to show here.

citeproc/biblatex-localization/slovenian.lbx.stringsdeleted

No changes to the content.

citeproc/biblatex-localization/spanish.lbx.stringsdeleted−190

This diff is too big to show here.

citeproc/biblatex-localization/swedish.lbx.stringsdeleted−9

This diff is too big to show here.

citeproc/biblatex-localization/swissgerman.lbx.stringsdeleted−1

This diff is too big to show here.

citeproc/biblatex-localization/turkish.lbx.stringsdeleted−157

This diff is too big to show here.

citeproc/biblatex-localization/ukrainian.lbx.stringsdeleted−102

This diff is too big to show here.

data/LaTeXMathML.jsnew file+198

This diff is too big to show here.

data/MathMLinHTML.jsnew file+70

This diff is too big to show here.

data/abbreviationsdeleted−80

This diff is too big to show here.

data/bash_completion.tpl+10−30

This diff is too big to show here.

data/default.csldeleted−658

This diff is too big to show here.

data/docx/[Content_Types].xml+1−1

This diff is too big to show here.

data/docx/_rels/.rels+1−2

This diff is too big to show here.

data/docx/docProps/core.xml+1−1

This diff is too big to show here.

data/docx/docProps/custom.xmldeleted−2

This diff is too big to show here.

data/docx/word/_rels/document.xml.rels+1−1

This diff is too big to show here.

data/docx/word/_rels/footnotes.xml.rels+1−1

This diff is too big to show here.

data/docx/word/comments.xmldeleted−2

This diff is too big to show here.

data/docx/word/document.xml+2−398

This diff is too big to show here.

data/docx/word/footnotes.xml+26−7

This diff is too big to show here.

data/docx/word/numbering.xml+1−1

This diff is too big to show here.

data/docx/word/settings.xml+15−5

This diff is too big to show here.

data/docx/word/styles.xml+20−92

This diff is too big to show here.

data/epub.css+6−20

This diff is too big to show here.

data/init.luadeleted−3

This diff is too big to show here.

data/make-reference-files.hsnew file+27

This diff is too big to show here.

data/odt/styles.xml+13−25

This diff is too big to show here.

data/pandoc.List.luadeleted−142

This diff is too big to show here.

data/pandoc.luadeleted−1169

This diff is too big to show here.

data/pptx/[Content_Types].xmldeleted−2

This diff is too big to show here.

data/pptx/_rels/.relsdeleted−2

This diff is too big to show here.

data/pptx/docProps/app.xmldeleted−2

This diff is too big to show here.

data/pptx/docProps/core.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/_rels/presentation.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/notesMasters/_rels/notesMaster1.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/notesMasters/notesMaster1.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/notesSlides/_rels/notesSlide1.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/notesSlides/_rels/notesSlide2.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/notesSlides/notesSlide1.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/notesSlides/notesSlide2.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/presProps.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/presentation.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/_rels/slideLayout1.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/_rels/slideLayout10.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/_rels/slideLayout11.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/_rels/slideLayout2.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/_rels/slideLayout3.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/_rels/slideLayout4.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/_rels/slideLayout5.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/_rels/slideLayout6.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/_rels/slideLayout7.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/_rels/slideLayout8.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/_rels/slideLayout9.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/slideLayout1.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/slideLayout10.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/slideLayout11.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/slideLayout2.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/slideLayout3.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/slideLayout4.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/slideLayout5.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/slideLayout6.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/slideLayout7.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/slideLayout8.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slideLayouts/slideLayout9.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slideMasters/_rels/slideMaster1.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slideMasters/slideMaster1.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slides/_rels/slide1.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slides/_rels/slide2.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slides/_rels/slide3.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slides/_rels/slide4.xml.relsdeleted−2

This diff is too big to show here.

data/pptx/ppt/slides/slide1.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slides/slide2.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slides/slide3.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/slides/slide4.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/tableStyles.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/theme/theme1.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/theme/theme2.xmldeleted−2

This diff is too big to show here.

data/pptx/ppt/viewProps.xmldeleted−2

This diff is too big to show here.

data/sample.lua+32−55

This diff is too big to show here.

data/templatesnew file+1

This diff is too big to show here.

data/templates/affiliations.jatsdeleted−38

This diff is too big to show here.

data/templates/article.jats_publishingdeleted−211

This diff is too big to show here.

data/templates/default.asciidocdeleted−38

This diff is too big to show here.

data/templates/default.asciidoctordeleted−41

This diff is too big to show here.

data/templates/default.biblatexdeleted−10

This diff is too big to show here.

data/templates/default.bibtexdeleted−10

This diff is too big to show here.

data/templates/default.commonmarkdeleted−21

This diff is too big to show here.

data/templates/default.contextdeleted−179

This diff is too big to show here.

data/templates/default.docbook4deleted−32

This diff is too big to show here.

data/templates/default.docbook5deleted−37

This diff is too big to show here.

data/templates/default.dokuwikideleted−13

This diff is too big to show here.

data/templates/default.dzslidesdeleted−192

This diff is too big to show here.

data/templates/default.epub2deleted−67

This diff is too big to show here.

data/templates/default.epub3deleted−68

This diff is too big to show here.

data/templates/default.haddockdeleted−1

This diff is too big to show here.

data/templates/default.html4deleted−64

This diff is too big to show here.

data/templates/default.html5deleted−67

This diff is too big to show here.

data/templates/default.icmldeleted−43

This diff is too big to show here.

data/templates/default.jats_archivingdeleted−7

This diff is too big to show here.

data/templates/default.jats_articleauthoringdeleted−93

This diff is too big to show here.

data/templates/default.jats_publishingdeleted−7

This diff is too big to show here.

data/templates/default.jiradeleted−9

This diff is too big to show here.

data/templates/default.latexdeleted−549

This diff is too big to show here.

data/templates/default.mandeleted−30

This diff is too big to show here.

data/templates/default.markdowndeleted−21

This diff is too big to show here.

data/templates/default.mediawikideleted−13

This diff is too big to show here.

data/templates/default.msdeleted−118

This diff is too big to show here.

data/templates/default.musedeleted−44

This diff is too big to show here.

data/templates/default.opendocumentdeleted−165

This diff is too big to show here.

data/templates/default.opmldeleted−11

This diff is too big to show here.

data/templates/default.orgdeleted−24

This diff is too big to show here.

data/templates/default.plaindeleted−21

This diff is too big to show here.

data/templates/default.revealjsdeleted−318

This diff is too big to show here.

data/templates/default.rstdeleted−46

This diff is too big to show here.

data/templates/default.rtfdeleted−30

This diff is too big to show here.

data/templates/default.s5deleted−83

This diff is too big to show here.

data/templates/default.slideousdeleted−91

This diff is too big to show here.

data/templates/default.slidydeleted−75

This diff is too big to show here.

data/templates/default.teideleted−51

This diff is too big to show here.

data/templates/default.texinfodeleted−42

This diff is too big to show here.

data/templates/default.textiledeleted−9

This diff is too big to show here.

data/templates/default.xwikideleted−13

This diff is too big to show here.

data/templates/default.zimwikideleted−16

This diff is too big to show here.

data/templates/styles.htmldeleted−180

This diff is too big to show here.

data/translations/am.yamldeleted−20

This diff is too big to show here.

data/translations/ar.yamldeleted−20

This diff is too big to show here.

data/translations/bg.yamldeleted−19

This diff is too big to show here.

data/translations/bn.yamldeleted−21

This diff is too big to show here.

data/translations/ca.yamldeleted−21

This diff is too big to show here.

data/translations/cs.yamldeleted−21

This diff is too big to show here.

data/translations/da.yamldeleted−21

This diff is too big to show here.

data/translations/de.yamldeleted−22

This diff is too big to show here.

data/translations/el.yamldeleted−21

This diff is too big to show here.

data/translations/en.yamldeleted−22

This diff is too big to show here.

data/translations/eo.yamldeleted−20

This diff is too big to show here.

data/translations/es.yamldeleted−21

This diff is too big to show here.

data/translations/et.yamldeleted−20

This diff is too big to show here.

data/translations/eu.yamldeleted−21

This diff is too big to show here.

data/translations/fa.yamldeleted−21

This diff is too big to show here.

data/translations/fi.yamldeleted−21

This diff is too big to show here.

data/translations/fr.yamldeleted−20

This diff is too big to show here.

data/translations/he.yamldeleted−22

This diff is too big to show here.

data/translations/hi.yamldeleted−20

This diff is too big to show here.

data/translations/hr.yamldeleted−21

This diff is too big to show here.

data/translations/hu.yamldeleted−21

This diff is too big to show here.

data/translations/is.yamldeleted−21

This diff is too big to show here.

data/translations/it.yamldeleted−21

This diff is too big to show here.

data/translations/km.yamldeleted−21

This diff is too big to show here.

data/translations/ko.yamldeleted−17

This diff is too big to show here.

data/translations/lo.yamldeleted−21

This diff is too big to show here.

data/translations/lt.yamldeleted−21

This diff is too big to show here.

data/translations/lv.yamldeleted−20

This diff is too big to show here.

data/translations/nl.yamldeleted−21

This diff is too big to show here.

data/translations/no.yamldeleted−21

This diff is too big to show here.

data/translations/pl.yamldeleted−21

This diff is too big to show here.

data/translations/pt.yamldeleted−21

This diff is too big to show here.

data/translations/rm.yamldeleted−21

This diff is too big to show here.

data/translations/ro.yamldeleted−21

This diff is too big to show here.

data/translations/ru.yamldeleted−20

This diff is too big to show here.

data/translations/sk.yamldeleted−21

This diff is too big to show here.

data/translations/sl.yamldeleted−21

This diff is too big to show here.

data/translations/sq.yamldeleted−18

This diff is too big to show here.

data/translations/sr-cyrl.yamldeleted−21

This diff is too big to show here.

data/translations/sr.yamldeleted−21

This diff is too big to show here.

data/translations/sv.yamldeleted−21

This diff is too big to show here.

data/translations/th.yamldeleted−20

This diff is too big to show here.

data/translations/tr.yamldeleted−22

This diff is too big to show here.

data/translations/uk.yamldeleted−21

This diff is too big to show here.

data/translations/ur.yamldeleted−22

This diff is too big to show here.

data/translations/vi.yamldeleted−21

This diff is too big to show here.

data/translations/zh-Hans.yamldeleted−22

This diff is too big to show here.

data/translations/zh-Hant.yamldeleted−22

This diff is too big to show here.

deb/GlobalSignDomainValidationCA-SHA256-G2.pemnew file+26

This diff is too big to show here.

deb/Makefilenew file+14

This diff is too big to show here.

deb/Vagrantfilenew file+75

This diff is too big to show here.

deb/control.innew file+20

This diff is too big to show here.

deb/haskell.org.pemnew file+30

This diff is too big to show here.

deb/make_deb.shnew file+56

This diff is too big to show here.

deb/stack.yamlnew file+24

This diff is too big to show here.

default.nixdeleted−13

This diff is too big to show here.

doc/customizing-pandoc.mddeleted−168

This diff is too big to show here.

doc/epub.mddeleted−163

This diff is too big to show here.

doc/faqs.mddeleted−128

This diff is too big to show here.

doc/filters.mddeleted−512

This diff is too big to show here.

doc/getting-started.mddeleted−318

This diff is too big to show here.

doc/jats.mddeleted−414

This diff is too big to show here.

doc/libraries.mddeleted−63

This diff is too big to show here.

doc/lua-filters.mddeleted−3692

This diff is too big to show here.

doc/org.mddeleted−379

This diff is too big to show here.

doc/using-the-pandoc-api.mddeleted−476

This diff is too big to show here.

extract-changes.hsnew file+9

This diff is too big to show here.

tools/github-upload.sh → github-upload.shrenamed

The content is the same.

googlecode-upload.shnew file+5

This diff is too big to show here.

lib/fonts/Makefilenew file+6

This diff is too big to show here.

lib/fonts/parseUnicodeMapping.hsnew file+40

This diff is too big to show here.

lib/fonts/symbol.txtnew file+256

This diff is too big to show here.

linux/control.indeleted−26

This diff is too big to show here.

linux/make_artifacts.shdeleted−84

This diff is too big to show here.

macos/Makefiledeleted−35

This diff is too big to show here.

make_osx_package.shnew file+76

This diff is too big to show here.

make_travis_yml.hsnew file+210

This diff is too big to show here.

man/capitalizeHeaders.hsnew file+20

This diff is too big to show here.

man/manfilter.luadeleted−22

This diff is too big to show here.

man/pandoc.1+2967−5839

This diff is too big to show here.

man/pandoc.1.afterdeleted−3

This diff is too big to show here.

man/pandoc.1.beforedeleted−2

This diff is too big to show here.

man/pandoc.1.templatenew file+10

This diff is too big to show here.

man/removeLinks.hsnew file+9

This diff is too big to show here.

man/removeNotes.hsnew file+9

This diff is too big to show here.

macos/distribution.xml.in → osx/distribution.xml.inrenamed

The content is the same.

osx/stack.yamlnew file+27

This diff is too big to show here.

macos/uninstall-pandoc.pl → osx/uninstall-pandoc.plrenamed+1−1

This diff is too big to show here.

pandoc.cabal+336−639

This diff is too big to show here.

pandoc.hsnew file+1426

This diff is too big to show here.

prelude/Prelude.hs+23−8

This diff is too big to show here.

release.nixdeleted−4

This diff is too big to show here.

shell.nixdeleted−106

This diff is too big to show here.

src/Text/Pandoc.hs+345−28

This diff is too big to show here.

src/Text/Pandoc/App.hsdeleted−392

This diff is too big to show here.

src/Text/Pandoc/App/CommandLineOptions.hsdeleted−1092

This diff is too big to show here.

src/Text/Pandoc/App/FormatHeuristics.hsdeleted−90

This diff is too big to show here.

src/Text/Pandoc/App/Opt.hsdeleted−747

This diff is too big to show here.

src/Text/Pandoc/App/OutputSettings.hsdeleted−256

This diff is too big to show here.

src/Text/Pandoc/Asciify.hs+408−14

This diff is too big to show here.

src/Text/Pandoc/CSS.hs+25−38

This diff is too big to show here.

src/Text/Pandoc/CSV.hsdeleted−81

This diff is too big to show here.

src/Text/Pandoc/Citeproc.hsdeleted−661

This diff is too big to show here.

src/Text/Pandoc/Citeproc/BibTeX.hsdeleted−1476

This diff is too big to show here.

src/Text/Pandoc/Citeproc/CslJson.hsdeleted−37

This diff is too big to show here.

src/Text/Pandoc/Citeproc/Data.hsdeleted−32

This diff is too big to show here.

src/Text/Pandoc/Citeproc/Locator.hsdeleted−295

This diff is too big to show here.

src/Text/Pandoc/Citeproc/MetaValue.hsdeleted−255

This diff is too big to show here.

src/Text/Pandoc/Citeproc/Util.hsdeleted−70

This diff is too big to show here.

src/Text/Pandoc/Class.hsdeleted−29

This diff is too big to show here.

src/Text/Pandoc/Class/CommonState.hsdeleted−83

This diff is too big to show here.

src/Text/Pandoc/Class/IO.hsdeleted−231

This diff is too big to show here.

src/Text/Pandoc/Class/PandocIO.hsdeleted−74

This diff is too big to show here.

src/Text/Pandoc/Class/PandocMonad.hsdeleted−711

This diff is too big to show here.

src/Text/Pandoc/Class/PandocPure.hsdeleted−218

This diff is too big to show here.

src/Text/Pandoc/Compat/Directory.hsnew file+21

This diff is too big to show here.

src/Text/Pandoc/Compat/Except.hsnew file+37

This diff is too big to show here.

src/Text/Pandoc/Compat/Monoid.hsnew file+17

This diff is too big to show here.

src/Text/Pandoc/Compat/TagSoupEntity.hsnew file+15

This diff is too big to show here.

src/Text/Pandoc/Compat/Time.hsnew file+18

This diff is too big to show here.

src/Text/Pandoc/Data.hsdeleted−32

This diff is too big to show here.

src/Text/Pandoc/Data.hsbnew file+15

This diff is too big to show here.

src/Text/Pandoc/Emoji.hs+892−10

This diff is too big to show here.

src/Text/Pandoc/Error.hs+51−185

This diff is too big to show here.

src/Text/Pandoc/Extensions.hsdeleted−623

This diff is too big to show here.

src/Text/Pandoc/Filter.hsdeleted−100

This diff is too big to show here.

src/Text/Pandoc/Filter/JSON.hsdeleted−80

This diff is too big to show here.

src/Text/Pandoc/Filter/Lua.hsdeleted−47

This diff is too big to show here.

src/Text/Pandoc/Filter/Path.hsdeleted−35

This diff is too big to show here.

src/Text/Pandoc/Highlighting.hs+104−166

This diff is too big to show here.

src/Text/Pandoc/Image.hsdeleted−37

This diff is too big to show here.

src/Text/Pandoc/ImageSize.hs+392−227

This diff is too big to show here.

src/Text/Pandoc/Logging.hsdeleted−416

This diff is too big to show here.

src/Text/Pandoc/Lua.hsdeleted−23

This diff is too big to show here.

src/Text/Pandoc/Lua/ErrorConversion.hsdeleted−61

This diff is too big to show here.

src/Text/Pandoc/Lua/Filter.hsdeleted−253

This diff is too big to show here.

src/Text/Pandoc/Lua/Global.hsdeleted−89

This diff is too big to show here.

src/Text/Pandoc/Lua/Init.hsdeleted−103

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling.hsdeleted−19

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/AST.hsdeleted−378

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/AnyValue.hsdeleted−24

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/CommonState.hsdeleted−102

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/Context.hsdeleted−28

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/List.hsdeleted−43

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/MediaBag.hsdeleted−73

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/PandocError.hsdeleted−65

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/ReaderOptions.hsdeleted−79

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/SimpleTable.hsdeleted−59

This diff is too big to show here.

src/Text/Pandoc/Lua/Marshaling/Version.hsdeleted−154

This diff is too big to show here.

src/Text/Pandoc/Lua/Module/MediaBag.hsdeleted−103

This diff is too big to show here.

src/Text/Pandoc/Lua/Module/Pandoc.hsdeleted−133

This diff is too big to show here.

src/Text/Pandoc/Lua/Module/System.hsdeleted−33

This diff is too big to show here.

src/Text/Pandoc/Lua/Module/Types.hsdeleted−68

This diff is too big to show here.

src/Text/Pandoc/Lua/Module/Utils.hsdeleted−175

This diff is too big to show here.

src/Text/Pandoc/Lua/Packages.hsdeleted−60

This diff is too big to show here.

src/Text/Pandoc/Lua/PandocLua.hsdeleted−141

This diff is too big to show here.

src/Text/Pandoc/Lua/Util.hsdeleted−145

This diff is too big to show here.

src/Text/Pandoc/Lua/Walk.hsdeleted−158

This diff is too big to show here.

src/Text/Pandoc/MIME.hs+41−61

This diff is too big to show here.

src/Text/Pandoc/MediaBag.hs+63−66

This diff is too big to show here.

src/Text/Pandoc/Options.hs+320−244

This diff is too big to show here.

src/Text/Pandoc/PDF.hs+261−437

This diff is too big to show here.

src/Text/Pandoc/Parsing.hs+521−931

This diff is too big to show here.

src/Text/Pandoc/Pretty.hsnew file+539

This diff is too big to show here.

src/Text/Pandoc/Process.hs+64−72

This diff is too big to show here.

src/Text/Pandoc/Readers.hsdeleted−188

This diff is too big to show here.

src/Text/Pandoc/Readers/BibTeX.hsdeleted−77

This diff is too big to show here.

src/Text/Pandoc/Readers/CSV.hsdeleted−48

This diff is too big to show here.

src/Text/Pandoc/Readers/CommonMark.hs+102−93

This diff is too big to show here.

src/Text/Pandoc/Readers/Creole.hsdeleted−294

This diff is too big to show here.

src/Text/Pandoc/Readers/CslJson.hsdeleted−54

This diff is too big to show here.

src/Text/Pandoc/Readers/DocBook.hs+285−510

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx.hs+377−513

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Combine.hs+78−112

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Fields.hsdeleted−74

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Fonts.hsnew file+238

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Lists.hs+87−66

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Parse.hs+512−644

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Parse/Styles.hsdeleted−322

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/StyleMap.hsnew file+108

This diff is too big to show here.

src/Text/Pandoc/Readers/Docx/Util.hs+13−57

This diff is too big to show here.

src/Text/Pandoc/Readers/DokuWiki.hsdeleted−516

This diff is too big to show here.

src/Text/Pandoc/Readers/EPUB.hs+115−133

This diff is too big to show here.

src/Text/Pandoc/Readers/FB2.hsdeleted−462

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML.hs+726−755

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML/Parsing.hsdeleted−225

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML/Table.hsdeleted−283

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML/TagCategories.hsdeleted−78

This diff is too big to show here.

src/Text/Pandoc/Readers/HTML/Types.hsdeleted−97

This diff is too big to show here.

src/Text/Pandoc/Readers/Haddock.hs+49−76

This diff is too big to show here.

src/Text/Pandoc/Readers/Ipynb.hsdeleted−230

This diff is too big to show here.

src/Text/Pandoc/Readers/JATS.hsdeleted−531

This diff is too big to show here.

src/Text/Pandoc/Readers/Jira.hsdeleted−203

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX.hs+1314−1153

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Citation.hsdeleted−210

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Inline.hsdeleted−397

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Lang.hsdeleted−234

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Macro.hsdeleted−184

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Math.hsdeleted−221

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Parsing.hsdeleted−1004

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/SIunitx.hsdeleted−434

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Table.hsdeleted−378

This diff is too big to show here.

src/Text/Pandoc/Readers/LaTeX/Types.hsdeleted−50

This diff is too big to show here.

src/Text/Pandoc/Readers/Man.hsdeleted−520

This diff is too big to show here.

src/Text/Pandoc/Readers/Markdown.hs+1031−1214

This diff is too big to show here.

src/Text/Pandoc/Readers/MediaWiki.hs+263−293

This diff is too big to show here.

src/Text/Pandoc/Readers/Metadata.hsdeleted−200

This diff is too big to show here.

src/Text/Pandoc/Readers/Muse.hsdeleted−989

This diff is too big to show here.

src/Text/Pandoc/Readers/Native.hs+29−22

This diff is too big to show here.

src/Text/Pandoc/Readers/OPML.hs+53−64

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt.hs+59−69

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Arrows/State.hs+126−12

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Arrows/Utils.hs+300−18

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Base.hs+23−2

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/ContentReader.hs+108−260

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Generic/Fallible.hs+158−3

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Generic/Namespaces.hs+20−3

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Generic/SetMap.hs+18

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Generic/Utils.hs+71−16

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Generic/XMLConverter.hs+375−96

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/Namespaces.hs+26−9

This diff is too big to show here.

src/Text/Pandoc/Readers/Odt/StyleReader.hs+183−86

This diff is too big to show here.

src/Text/Pandoc/Readers/Org.hs+34−25

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/BlockStarts.hs+58−77

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/Blocks.hs+620−584

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/DocumentTree.hsdeleted−408

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/ExportSettings.hs+66−89

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/Inlines.hs+313−358

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/Meta.hsdeleted−296

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/ParserState.hs+90−170

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/Parsing.hs+48−51

This diff is too big to show here.

src/Text/Pandoc/Readers/Org/Shared.hs+60−43

This diff is too big to show here.

src/Text/Pandoc/Readers/RST.hs+498−927

This diff is too big to show here.

src/Text/Pandoc/Readers/Roff.hsdeleted−728

This diff is too big to show here.

src/Text/Pandoc/Readers/TWiki.hs+226−193

This diff is too big to show here.

src/Text/Pandoc/Readers/TeXMath.hsnew file+48

This diff is too big to show here.

src/Text/Pandoc/Readers/Textile.hs+229−213

This diff is too big to show here.

src/Text/Pandoc/Readers/TikiWiki.hsdeleted−656

This diff is too big to show here.

src/Text/Pandoc/Readers/Txt2Tags.hs+160−179

This diff is too big to show here.

src/Text/Pandoc/Readers/Vimwiki.hsdeleted−671

This diff is too big to show here.

src/Text/Pandoc/RoffChar.hsdeleted−421

This diff is too big to show here.

src/Text/Pandoc/SelfContained.hs+118−207

This diff is too big to show here.

src/Text/Pandoc/Shared.hs+812−716

This diff is too big to show here.

src/Text/Pandoc/Slides.hs+25−12

This diff is too big to show here.

src/Text/Pandoc/Sources.hsdeleted−195

This diff is too big to show here.

src/Text/Pandoc/Templates.hs+314−106

This diff is too big to show here.

src/Text/Pandoc/Translations.hsdeleted−121

This diff is too big to show here.

src/Text/Pandoc/UTF8.hs+67−85

This diff is too big to show here.

src/Text/Pandoc/UUID.hs+35−19

This diff is too big to show here.

src/Text/Pandoc/Writers.hsdeleted−221

This diff is too big to show here.

src/Text/Pandoc/Writers/AnnotatedTable.hsdeleted−323

This diff is too big to show here.

src/Text/Pandoc/Writers/AsciiDoc.hs+221−373

This diff is too big to show here.

src/Text/Pandoc/Writers/BibTeX.hsdeleted−61

This diff is too big to show here.

src/Text/Pandoc/Writers/CommonMark.hs+164−2

This diff is too big to show here.

src/Text/Pandoc/Writers/ConTeXt.hs+243−353

This diff is too big to show here.

src/Text/Pandoc/Writers/CslJson.hsdeleted−91

This diff is too big to show here.

src/Text/Pandoc/Writers/Custom.hs+255−163

This diff is too big to show here.

src/Text/Pandoc/Writers/Docbook.hs+245−360

This diff is too big to show here.

src/Text/Pandoc/Writers/Docx.hs+785−890

This diff is too big to show here.

src/Text/Pandoc/Writers/Docx/StyleMap.hsdeleted−47

This diff is too big to show here.

src/Text/Pandoc/Writers/Docx/Table.hsdeleted−227

This diff is too big to show here.

src/Text/Pandoc/Writers/Docx/Types.hsdeleted−185

This diff is too big to show here.

src/Text/Pandoc/Writers/DokuWiki.hs+233−243

This diff is too big to show here.

src/Text/Pandoc/Writers/EPUB.hs+488−736

This diff is too big to show here.

src/Text/Pandoc/Writers/FB2.hs+363−318

This diff is too big to show here.

src/Text/Pandoc/Writers/GridTable.hsdeleted−157

This diff is too big to show here.

src/Text/Pandoc/Writers/HTML.hs+656−1311

This diff is too big to show here.

src/Text/Pandoc/Writers/Haddock.hs+200−132

This diff is too big to show here.

src/Text/Pandoc/Writers/ICML.hs+259−320

This diff is too big to show here.

src/Text/Pandoc/Writers/Ipynb.hsdeleted−239

This diff is too big to show here.

src/Text/Pandoc/Writers/JATS.hsdeleted−579

This diff is too big to show here.

src/Text/Pandoc/Writers/JATS/References.hsdeleted−164

This diff is too big to show here.

src/Text/Pandoc/Writers/JATS/Table.hsdeleted−268

This diff is too big to show here.

src/Text/Pandoc/Writers/JATS/Types.hsdeleted−57

This diff is too big to show here.

src/Text/Pandoc/Writers/Jira.hsdeleted−339

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX.hs+974−715

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Caption.hsdeleted−47

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Citation.hsdeleted−181

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Lang.hsdeleted−192

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Notes.hsdeleted−34

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Table.hsdeleted−307

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Types.hsdeleted−83

This diff is too big to show here.

src/Text/Pandoc/Writers/LaTeX/Util.hsdeleted−275

This diff is too big to show here.

src/Text/Pandoc/Writers/Man.hs+212−179

This diff is too big to show here.

src/Text/Pandoc/Writers/Markdown.hs+819−639

This diff is too big to show here.

src/Text/Pandoc/Writers/Markdown/Inline.hsdeleted−616

This diff is too big to show here.

src/Text/Pandoc/Writers/Markdown/Types.hsdeleted−81

This diff is too big to show here.

src/Text/Pandoc/Writers/Math.hsdeleted−53

This diff is too big to show here.

src/Text/Pandoc/Writers/MediaWiki.hs+180−847

This diff is too big to show here.

src/Text/Pandoc/Writers/Ms.hsdeleted−614

This diff is too big to show here.

src/Text/Pandoc/Writers/Muse.hsdeleted−720

This diff is too big to show here.

src/Text/Pandoc/Writers/Native.hs+43−56

This diff is too big to show here.

src/Text/Pandoc/Writers/ODT.hs+102−195

This diff is too big to show here.

src/Text/Pandoc/Writers/OOXML.hsdeleted−99

This diff is too big to show here.

src/Text/Pandoc/Writers/OPML.hs+69−54

This diff is too big to show here.

src/Text/Pandoc/Writers/OpenDocument.hs+307−651

This diff is too big to show here.

src/Text/Pandoc/Writers/Org.hs+199−309

This diff is too big to show here.

src/Text/Pandoc/Writers/Powerpoint.hsdeleted−43

This diff is too big to show here.

src/Text/Pandoc/Writers/Powerpoint/Output.hsdeleted−1922

This diff is too big to show here.

src/Text/Pandoc/Writers/Powerpoint/Presentation.hsdeleted−1004

This diff is too big to show here.

src/Text/Pandoc/Writers/RST.hs+259−514

This diff is too big to show here.

src/Text/Pandoc/Writers/RTF.hs+241−285

This diff is too big to show here.

src/Text/Pandoc/Writers/Roff.hsdeleted−125

This diff is too big to show here.

src/Text/Pandoc/Writers/Shared.hs+113−466

This diff is too big to show here.

src/Text/Pandoc/Writers/TEI.hs+209−194

This diff is too big to show here.

src/Text/Pandoc/Writers/Texinfo.hs+179−199

This diff is too big to show here.

src/Text/Pandoc/Writers/Textile.hs+218−232

This diff is too big to show here.

src/Text/Pandoc/Writers/XWiki.hsdeleted−267

This diff is too big to show here.

src/Text/Pandoc/Writers/ZimWiki.hs+191−223

This diff is too big to show here.

src/Text/Pandoc/XML.hs+68−471

This diff is too big to show here.

src/Text/Pandoc/XML/Light.hsdeleted−89

This diff is too big to show here.

src/Text/Pandoc/XML/Light/Output.hsdeleted−234

This diff is too big to show here.

src/Text/Pandoc/XML/Light/Proc.hsdeleted−139

This diff is too big to show here.

src/Text/Pandoc/XML/Light/Types.hsdeleted−193

This diff is too big to show here.

stack.full.yamlnew file+29

This diff is too big to show here.

stack.hsb2hs.yamlnew file+4

This diff is too big to show here.

stack.lts6.yamlnew file+15

This diff is too big to show here.

stack.yaml+10−16

This diff is too big to show here.

test/Tests/Command.hsdeleted−136

This diff is too big to show here.

test/Tests/Helpers.hsdeleted−151

This diff is too big to show here.

test/Tests/Lua.hsdeleted−242

This diff is too big to show here.

test/Tests/Lua/Module.hsdeleted−37

This diff is too big to show here.

test/Tests/Old.hsdeleted−343

This diff is too big to show here.

test/Tests/Readers/Creole.hsdeleted−298

This diff is too big to show here.

test/Tests/Readers/DokuWiki.hsdeleted−321

This diff is too big to show here.

test/Tests/Readers/EPUB.hsdeleted−86

This diff is too big to show here.

test/Tests/Readers/FB2.hsdeleted−39

This diff is too big to show here.

test/Tests/Readers/HTML.hsdeleted−127

This diff is too big to show here.

test/Tests/Readers/JATS.hsdeleted−145

This diff is too big to show here.

test/Tests/Readers/Jira.hsdeleted−204

This diff is too big to show here.

test/Tests/Readers/Man.hsdeleted−144

This diff is too big to show here.

test/Tests/Readers/Muse.hsdeleted−1653

This diff is too big to show here.

test/Tests/Readers/Org.hsdeleted−27

This diff is too big to show here.

test/Tests/Readers/Org/Block.hsdeleted−213

This diff is too big to show here.

test/Tests/Readers/Org/Block/CodeBlock.hsdeleted−205

This diff is too big to show here.

test/Tests/Readers/Org/Block/Figure.hsdeleted−75

This diff is too big to show here.

test/Tests/Readers/Org/Block/Header.hsdeleted−272

This diff is too big to show here.

test/Tests/Readers/Org/Block/List.hsdeleted−279

This diff is too big to show here.

test/Tests/Readers/Org/Block/Table.hsdeleted−186

This diff is too big to show here.

test/Tests/Readers/Org/Directive.hsdeleted−359

This diff is too big to show here.

test/Tests/Readers/Org/Inline.hsdeleted−385

This diff is too big to show here.

test/Tests/Readers/Org/Inline/Citation.hsdeleted−230

This diff is too big to show here.

test/Tests/Readers/Org/Inline/Note.hsdeleted−97

This diff is too big to show here.

test/Tests/Readers/Org/Inline/Smart.hsdeleted−57

This diff is too big to show here.

test/Tests/Readers/Org/Meta.hsdeleted−292

This diff is too big to show here.

test/Tests/Readers/Org/Shared.hsdeleted−41

This diff is too big to show here.

test/Tests/Shared.hsdeleted−112

This diff is too big to show here.

test/Tests/Writers/AnnotatedTable.hsdeleted−253

This diff is too big to show here.

test/Tests/Writers/ConTeXt.hsdeleted−163

This diff is too big to show here.

test/Tests/Writers/Docx.hsdeleted−196

This diff is too big to show here.

test/Tests/Writers/FB2.hsdeleted−34

This diff is too big to show here.

test/Tests/Writers/HTML.hsdeleted−93

This diff is too big to show here.

test/Tests/Writers/JATS.hsdeleted−164

This diff is too big to show here.

test/Tests/Writers/Jira.hsdeleted−124

This diff is too big to show here.

test/Tests/Writers/LaTeX.hsdeleted−176

This diff is too big to show here.

test/Tests/Writers/Markdown.hsdeleted−269

This diff is too big to show here.

test/Tests/Writers/Ms.hsdeleted−35

This diff is too big to show here.

test/Tests/Writers/Muse.hsdeleted−658

This diff is too big to show here.

test/Tests/Writers/Native.hsdeleted−22

This diff is too big to show here.

test/Tests/Writers/OOXML.hsdeleted−187

This diff is too big to show here.

test/Tests/Writers/Org.hsdeleted−60

This diff is too big to show here.

test/Tests/Writers/Powerpoint.hsdeleted−132

This diff is too big to show here.

test/Tests/Writers/RST.hsdeleted−178

This diff is too big to show here.

test/command/01.csvdeleted−4

This diff is too big to show here.

test/command/1126.mddeleted−28

This diff is too big to show here.

test/command/1166.mddeleted−48

This diff is too big to show here.

test/command/1279.mddeleted−19

This diff is too big to show here.

test/command/1390.mddeleted−20

This diff is too big to show here.

test/command/1592.mddeleted−70

This diff is too big to show here.

test/command/1608.mddeleted−41

This diff is too big to show here.

test/command/1629.mddeleted−10

This diff is too big to show here.

test/command/168.mddeleted−43

This diff is too big to show here.

test/command/1710.mddeleted−85

This diff is too big to show here.

test/command/1718.mddeleted−11

This diff is too big to show here.

test/command/1745.mddeleted−13

This diff is too big to show here.

test/command/1762.mddeleted−18

This diff is too big to show here.

test/command/1773.mddeleted−6

This diff is too big to show here.

test/command/1841.mddeleted−42

This diff is too big to show here.

test/command/1881.mddeleted−87

This diff is too big to show here.

test/command/1905.mddeleted−30

This diff is too big to show here.

test/command/2103.mddeleted−8

This diff is too big to show here.

test/command/2118.mddeleted−11

This diff is too big to show here.

test/command/2228.mddeleted−6

This diff is too big to show here.

test/command/2378.mddeleted−27

This diff is too big to show here.

test/command/2397.mddeleted−9

This diff is too big to show here.

test/command/2434.mddeleted−59

This diff is too big to show here.

test/command/2549.mddeleted−38

This diff is too big to show here.

test/command/2552.mddeleted−14

This diff is too big to show here.

test/command/256.mddeleted−12

This diff is too big to show here.

test/command/2602.mddeleted−18

This diff is too big to show here.

test/command/2606.mddeleted−58

This diff is too big to show here.

test/command/262.mddeleted−26

This diff is too big to show here.

test/command/2649.mddeleted−108

This diff is too big to show here.

test/command/2662.mddeleted−11

This diff is too big to show here.

test/command/2834.mddeleted−29

This diff is too big to show here.

test/command/2874.mddeleted−14

This diff is too big to show here.

test/command/2994.mddeleted−10

This diff is too big to show here.

test/command/3113.mddeleted−13

This diff is too big to show here.

test/command/3123.mddeleted−13

This diff is too big to show here.

test/command/3236.mddeleted−9

This diff is too big to show here.

test/command/3257.mddeleted−13

This diff is too big to show here.

test/command/3309.mddeleted−52

This diff is too big to show here.

test/command/3314.mddeleted−34

This diff is too big to show here.

test/command/3324.mddeleted−18

This diff is too big to show here.

test/command/3337.mddeleted−13

This diff is too big to show here.

test/command/3348.mddeleted−30

This diff is too big to show here.

test/command/3401.mddeleted−19

This diff is too big to show here.

test/command/3407.mddeleted−13

This diff is too big to show here.

test/command/3422.mddeleted−9

This diff is too big to show here.

test/command/3432.mddeleted−289

This diff is too big to show here.

test/command/3432a.mddeleted−19

This diff is too big to show here.

test/command/3450.mddeleted−12

This diff is too big to show here.

test/command/3475.mddeleted−45

This diff is too big to show here.

test/command/3487.mddeleted−11

This diff is too big to show here.

test/command/3494.mddeleted−40

This diff is too big to show here.

test/command/3497.mddeleted−51

This diff is too big to show here.

test/command/3499.mddeleted−18

This diff is too big to show here.

test/command/3510-export.latexdeleted−1

This diff is too big to show here.

test/command/3510-src.hsdeleted−1

This diff is too big to show here.

test/command/3510-subdoc.orgdeleted−5

This diff is too big to show here.

test/command/3510.mddeleted−20

This diff is too big to show here.

test/command/3511.mddeleted−46

This diff is too big to show here.

test/command/3512.mddeleted−13

This diff is too big to show here.

test/command/3516.mddeleted−81

This diff is too big to show here.

test/command/3518.mddeleted−6

This diff is too big to show here.

test/command/3523.mddeleted−31

This diff is too big to show here.

test/command/3526.mddeleted−14

This diff is too big to show here.

test/command/3529.mddeleted−15

This diff is too big to show here.

test/command/3530.mddeleted−19

This diff is too big to show here.

test/command/3531.mddeleted−20

This diff is too big to show here.

test/command/3533-rst-csv-tables.csvdeleted−4

This diff is too big to show here.

test/command/3533-rst-csv-tables.mddeleted−108

This diff is too big to show here.

test/command/3534.mddeleted−45

This diff is too big to show here.

test/command/3537.mddeleted−28

This diff is too big to show here.

test/command/3539.mddeleted−45

This diff is too big to show here.

test/command/3558.mddeleted−12

This diff is too big to show here.

test/command/3568.mddeleted−16

This diff is too big to show here.

test/command/3570.mddeleted−6

This diff is too big to show here.

test/command/3577.mddeleted−35

This diff is too big to show here.

test/command/3585.mddeleted−16

This diff is too big to show here.

test/command/3587.mddeleted−147

This diff is too big to show here.

test/command/3596.mddeleted−59

This diff is too big to show here.

test/command/3615.mddeleted−18

This diff is too big to show here.

test/command/3619.mddeleted−28

This diff is too big to show here.

test/command/3630.mddeleted−8

This diff is too big to show here.

test/command/3667.mddeleted−13

This diff is too big to show here.

test/command/3674.mddeleted−39

This diff is too big to show here.

test/command/3675.mddeleted−15

This diff is too big to show here.

test/command/3681.mddeleted−27

This diff is too big to show here.

test/command/3690.mddeleted−8

This diff is too big to show here.

test/command/3701.mddeleted−60

This diff is too big to show here.

test/command/3706.mddeleted−65

This diff is too big to show here.

test/command/3708.mddeleted−28

This diff is too big to show here.

test/command/3715.mddeleted−15

This diff is too big to show here.

test/command/3716.mddeleted−6

This diff is too big to show here.

test/command/3730.mddeleted−21

This diff is too big to show here.

test/command/3733.mddeleted−13

This diff is too big to show here.

test/command/3734.mddeleted−32

This diff is too big to show here.

test/command/3736.mddeleted−22

This diff is too big to show here.

test/command/3752.mddeleted−60

This diff is too big to show here.

test/command/3755.mddeleted−23

This diff is too big to show here.

test/command/3771.mddeleted−14

This diff is too big to show here.

test/command/3773.mddeleted−14

This diff is too big to show here.

test/command/3779.mddeleted−28

This diff is too big to show here.

test/command/3792.mddeleted−13

This diff is too big to show here.

test/command/3794.mddeleted−7

This diff is too big to show here.

test/command/3803.mddeleted−10

This diff is too big to show here.

test/command/3804.mddeleted−6

This diff is too big to show here.

test/command/3816.mddeleted−32

This diff is too big to show here.

test/command/3824.mddeleted−14

This diff is too big to show here.

test/command/3840.mddeleted−15

This diff is too big to show here.

test/command/3853.mddeleted−26

This diff is too big to show here.

test/command/3880.mddeleted−6

This diff is too big to show here.

test/command/3880.txtdeleted−1

This diff is too big to show here.

test/command/3916.mddeleted−11

This diff is too big to show here.

test/command/3937.mddeleted−13

This diff is too big to show here.

test/command/3947.mddeleted−11

This diff is too big to show here.

test/command/3958.mddeleted−20

This diff is too big to show here.

test/command/3968.mddeleted−10

This diff is too big to show here.

test/command/3971.mddeleted−9

This diff is too big to show here.

test/command/3971b.texdeleted−2

This diff is too big to show here.

test/command/3974.mddeleted−6

This diff is too big to show here.

test/command/3978.mddeleted−6

This diff is too big to show here.

test/command/3983.mddeleted−29

This diff is too big to show here.

test/command/3989.mddeleted−7

This diff is too big to show here.

test/command/4007.mddeleted−23

This diff is too big to show here.

test/command/4012.mddeleted−8

This diff is too big to show here.

test/command/4016.mddeleted−42

This diff is too big to show here.

test/command/4019.mddeleted−8

This diff is too big to show here.

test/command/4038.mddeleted−6

This diff is too big to show here.

test/command/4054.mddeleted−14

This diff is too big to show here.

test/command/4056.mddeleted−35

This diff is too big to show here.

test/command/4061.mddeleted−14

This diff is too big to show here.

test/command/4062.mddeleted−6

This diff is too big to show here.

test/command/4063.mddeleted−29

This diff is too big to show here.

test/command/4068.mddeleted−9

This diff is too big to show here.

test/command/4091.mddeleted−6

This diff is too big to show here.

test/command/4113.mddeleted−12

This diff is too big to show here.

test/command/4119.mddeleted−32

This diff is too big to show here.

test/command/4125.mddeleted−6

This diff is too big to show here.

test/command/4134.mddeleted−25

This diff is too big to show here.

test/command/4156.mddeleted−10

This diff is too big to show here.

test/command/4159.mddeleted−8

This diff is too big to show here.

test/command/4162.mddeleted−10

This diff is too big to show here.

test/command/4164.mddeleted−31

This diff is too big to show here.

test/command/4171.mddeleted−34

This diff is too big to show here.

test/command/4172.mddeleted−29

This diff is too big to show here.

test/command/4183.mddeleted−32

This diff is too big to show here.

test/command/4186.mddeleted−60

This diff is too big to show here.

test/command/4193.mddeleted−10

This diff is too big to show here.

test/command/4199.mddeleted−6

This diff is too big to show here.

test/command/4208.mddeleted−18

This diff is too big to show here.

test/command/4235.mddeleted−12

This diff is too big to show here.

test/command/4240.mddeleted−33

This diff is too big to show here.

test/command/4253.mddeleted−8

This diff is too big to show here.

test/command/4254.mddeleted−12

This diff is too big to show here.

test/command/4280.mddeleted−7

This diff is too big to show here.

test/command/4281.mddeleted−18

This diff is too big to show here.

test/command/4284.mddeleted−40

This diff is too big to show here.

test/command/4306.mddeleted−10

This diff is too big to show here.

test/command/4320.mddeleted−29

This diff is too big to show here.

test/command/4374.mddeleted−7

This diff is too big to show here.

test/command/4382.mddeleted−10

This diff is too big to show here.

test/command/4420.mddeleted−11

This diff is too big to show here.

test/command/4424.mddeleted−10

This diff is too big to show here.

test/command/4442.mddeleted−9

This diff is too big to show here.

test/command/4454.mddeleted−9

This diff is too big to show here.

test/command/4465.mddeleted−15

This diff is too big to show here.

test/command/4499.mddeleted−87

This diff is too big to show here.

test/command/4513.mddeleted−20

This diff is too big to show here.

test/command/4527.mddeleted−36

This diff is too big to show here.

test/command/4528.mddeleted−156

This diff is too big to show here.

test/command/4529.mddeleted−36

This diff is too big to show here.

test/command/4545.mddeleted−20

This diff is too big to show here.

test/command/4550.mddeleted−7

This diff is too big to show here.

test/command/4553.mddeleted−15

This diff is too big to show here.

test/command/4576.mddeleted−6

This diff is too big to show here.

test/command/4578.mddeleted−14

This diff is too big to show here.

test/command/4579.mddeleted−30

This diff is too big to show here.

test/command/4589.mddeleted−14

This diff is too big to show here.

test/command/4594.mddeleted−24

This diff is too big to show here.

test/command/4598.mddeleted−10

This diff is too big to show here.

test/command/4624.mddeleted−30

This diff is too big to show here.

test/command/4635.mddeleted−31

This diff is too big to show here.

test/command/4637.mddeleted−6

This diff is too big to show here.

test/command/4639.mddeleted−10

This diff is too big to show here.

test/command/4653.mddeleted−8

This diff is too big to show here.

test/command/4667.mddeleted−20

This diff is too big to show here.

test/command/4669.mddeleted−29

This diff is too big to show here.

test/command/4677.mddeleted−8

This diff is too big to show here.

test/command/4690.mddeleted−26

This diff is too big to show here.

test/command/4715.mddeleted−16

This diff is too big to show here.

test/command/4722.mddeleted−34

This diff is too big to show here.

test/command/4742.mddeleted−29

This diff is too big to show here.

test/command/4743.mddeleted−25

This diff is too big to show here.

test/command/4748.mddeleted−16

This diff is too big to show here.

test/command/4768.mddeleted−7

This diff is too big to show here.

test/command/4781.mddeleted−22

This diff is too big to show here.

test/command/4794.mddeleted−17

This diff is too big to show here.

test/command/4805-beamer-columns-alignment.mddeleted−40

This diff is too big to show here.

test/command/4811.mddeleted−48

This diff is too big to show here.

test/command/4817.mddeleted−10

This diff is too big to show here.

test/command/4819.mddeleted−50

This diff is too big to show here.

test/command/4832.mddeleted−21

This diff is too big to show here.

test/command/4833.mddeleted−20

This diff is too big to show here.

test/command/4842.mddeleted−6

This diff is too big to show here.

test/command/4845.mddeleted−6

This diff is too big to show here.

test/command/4848.mddeleted−59

This diff is too big to show here.

test/command/4860.mddeleted−9

This diff is too big to show here.

test/command/4877.mddeleted−13

This diff is too big to show here.

test/command/4880.mddeleted−7

This diff is too big to show here.

test/command/4885.mddeleted−8

This diff is too big to show here.

test/command/4908.mddeleted−16

This diff is too big to show here.

test/command/4913.mddeleted−34

This diff is too big to show here.

test/command/4919.mddeleted−14

This diff is too big to show here.

test/command/4928.mddeleted−48

This diff is too big to show here.

test/command/4933.mddeleted−6

This diff is too big to show here.

test/command/4960.mddeleted−22

This diff is too big to show here.

test/command/5010.mddeleted−21

This diff is too big to show here.

test/command/5014.mddeleted−30

This diff is too big to show here.

test/command/5039.mddeleted−27

This diff is too big to show here.

test/command/5050.mddeleted−7

This diff is too big to show here.

test/command/5053.mddeleted−14

This diff is too big to show here.

test/command/5072.mddeleted−14

This diff is too big to show here.

test/command/5079.mddeleted−25

This diff is too big to show here.

test/command/5080.mddeleted−13

This diff is too big to show here.

test/command/5099.mddeleted−13

This diff is too big to show here.

test/command/5107.mddeleted−23

This diff is too big to show here.

test/command/5119.mddeleted−9

This diff is too big to show here.

test/command/512.mddeleted−42

This diff is too big to show here.

test/command/5121.mddeleted−12

This diff is too big to show here.

test/command/5128.mddeleted−26

This diff is too big to show here.

test/command/5177.mddeleted−12

This diff is too big to show here.

test/command/5178.mddeleted−41

This diff is too big to show here.

test/command/5182.mddeleted−6

This diff is too big to show here.

test/command/5182.txtdeleted−5

This diff is too big to show here.

test/command/5195.mddeleted−7

This diff is too big to show here.

test/command/5233.mddeleted−9

This diff is too big to show here.

test/command/5241.mddeleted−12

This diff is too big to show here.

test/command/5271.mddeleted−12

This diff is too big to show here.

test/command/5285.mddeleted−32

This diff is too big to show here.

test/command/5304.mddeleted−24

This diff is too big to show here.

test/command/5321.mddeleted−24

This diff is too big to show here.

test/command/5340.mddeleted−14

This diff is too big to show here.

test/command/5360.mddeleted−19

This diff is too big to show here.

test/command/5367.mddeleted−43

This diff is too big to show here.

test/command/5368.mddeleted−23

This diff is too big to show here.

test/command/5369.mddeleted−7

This diff is too big to show here.

test/command/5407.mddeleted−14

This diff is too big to show here.

test/command/5410.mddeleted−7

This diff is too big to show here.

test/command/5416.mddeleted−13

This diff is too big to show here.

test/command/5420.mddeleted−6

This diff is too big to show here.

test/command/5439.mddeleted−6

This diff is too big to show here.

test/command/5446.mddeleted−6

This diff is too big to show here.

test/command/5474-figures.mddeleted−15

This diff is too big to show here.

test/command/5474-tables.mddeleted−63

This diff is too big to show here.

test/command/5476.mddeleted−12

This diff is too big to show here.

test/command/5495.mddeleted−18

This diff is too big to show here.

test/command/5519.mddeleted−14

This diff is too big to show here.

test/command/5529.mddeleted−10

This diff is too big to show here.

test/command/5540.mddeleted−8

This diff is too big to show here.

test/command/5541-localLink.mddeleted−149

This diff is too big to show here.

test/command/5541-nesting.mddeleted−98

This diff is too big to show here.

test/command/5541-urlLink.mddeleted−112

This diff is too big to show here.

test/command/5543.mddeleted−8

This diff is too big to show here.

test/command/5549.mddeleted−9

This diff is too big to show here.

test/command/5565.mddeleted−6

This diff is too big to show here.

test/command/5566.mddeleted−6

This diff is too big to show here.

test/command/5574.mddeleted−8

This diff is too big to show here.

test/command/5619.mddeleted−10

This diff is too big to show here.

test/command/5620.mddeleted−9

This diff is too big to show here.

test/command/5627.mddeleted−83

This diff is too big to show here.

test/command/5635.mddeleted−23

This diff is too big to show here.

test/command/5642.mddeleted−8

This diff is too big to show here.

test/command/5650.mddeleted−22

This diff is too big to show here.

test/command/5654.mddeleted−6

This diff is too big to show here.

test/command/5655.mddeleted−14

This diff is too big to show here.

test/command/5682.mddeleted−8

This diff is too big to show here.

test/command/5684.mddeleted−6

This diff is too big to show here.

test/command/5686.mddeleted−9

This diff is too big to show here.

test/command/5690.mddeleted−16

This diff is too big to show here.

test/command/5700-metadata-file-1.ymldeleted−1

This diff is too big to show here.

test/command/5700-metadata-file-2.ymldeleted−2

This diff is too big to show here.

test/command/5700.mddeleted−6

This diff is too big to show here.

test/command/5705.mddeleted−11

This diff is too big to show here.

test/command/5708.mddeleted−22

This diff is too big to show here.

test/command/5711.mddeleted−22

This diff is too big to show here.

test/command/5714.mddeleted−13

This diff is too big to show here.

test/command/5740.mddeleted−9

This diff is too big to show here.

test/command/5753.mddeleted−15

This diff is too big to show here.

test/command/5795.mddeleted−20

This diff is too big to show here.

test/command/5797.mddeleted−20

This diff is too big to show here.

test/command/5805.mddeleted−20

This diff is too big to show here.

test/command/5813.mddeleted−6

This diff is too big to show here.

test/command/5819.mddeleted−18

This diff is too big to show here.

test/command/5836.mddeleted−27

This diff is too big to show here.

test/command/5845.mddeleted−16

This diff is too big to show here.

test/command/5846.mddeleted−170

This diff is too big to show here.

test/command/5849-prefix.mddeleted−31

This diff is too big to show here.

test/command/5857.mddeleted−11

This diff is too big to show here.

test/command/5878.mddeleted−7

This diff is too big to show here.

test/command/5881.mddeleted−14

This diff is too big to show here.

test/command/5885.mddeleted−20

This diff is too big to show here.

test/command/5898.mddeleted−36

This diff is too big to show here.

test/command/5899.mddeleted−51

This diff is too big to show here.

test/command/5904.mddeleted−10

This diff is too big to show here.

test/command/5918.mddeleted−6

This diff is too big to show here.

test/command/5936.mddeleted−40

This diff is too big to show here.

test/command/5967.mddeleted−15

This diff is too big to show here.

test/command/5986.mddeleted−17

This diff is too big to show here.

test/command/6009.mddeleted−18

This diff is too big to show here.

test/command/6026.mddeleted−19

This diff is too big to show here.

test/command/6030.mddeleted−96

This diff is too big to show here.

test/command/6033.mddeleted−91

This diff is too big to show here.

test/command/6034.mddeleted−11

This diff is too big to show here.

test/command/6043.mddeleted−8

This diff is too big to show here.

test/command/6062.mddeleted−6

This diff is too big to show here.

test/command/6107.mddeleted−27

This diff is too big to show here.

test/command/6114.mddeleted−7

This diff is too big to show here.

test/command/6119.mddeleted−10

This diff is too big to show here.

test/command/6133.mddeleted−12

This diff is too big to show here.

test/command/6137.mddeleted−47

This diff is too big to show here.

test/command/6194.mddeleted−14

This diff is too big to show here.

test/command/6265.mddeleted−6

This diff is too big to show here.

test/command/6288.mddeleted−8

This diff is too big to show here.

test/command/6296.mddeleted−14

This diff is too big to show here.

test/command/6308.mddeleted−18

This diff is too big to show here.

test/command/6324.mddeleted−17

This diff is too big to show here.

test/command/6360.mddeleted−6

This diff is too big to show here.

test/command/6385.mddeleted−18

This diff is too big to show here.

test/command/6388.mddeleted−16

This diff is too big to show here.

test/command/645.mddeleted−12

This diff is too big to show here.

test/command/6481.mddeleted−38

This diff is too big to show here.

test/command/6541.mddeleted−27

This diff is too big to show here.

test/command/6549.mddeleted−26

This diff is too big to show here.

test/command/6620.mddeleted−18

This diff is too big to show here.

test/command/6658.mddeleted−75

This diff is too big to show here.

test/command/6675.mddeleted−134

This diff is too big to show here.

test/command/6699.mddeleted−13

This diff is too big to show here.

test/command/6709.mddeleted−11

This diff is too big to show here.

test/command/6719.mddeleted−18

This diff is too big to show here.

test/command/6723.mddeleted−32

This diff is too big to show here.

test/command/6739.mddeleted−21

This diff is too big to show here.

test/command/6740.mddeleted−7

This diff is too big to show here.

test/command/6741.mddeleted−145

This diff is too big to show here.

test/command/6752.mddeleted−36

This diff is too big to show here.

test/command/6755.mddeleted−11

This diff is too big to show here.

test/command/6765.mddeleted−31

This diff is too big to show here.

test/command/6768.mddeleted−21

This diff is too big to show here.

test/command/6774.mddeleted−63

This diff is too big to show here.

test/command/6783.mddeleted−26

This diff is too big to show here.

test/command/6791.mddeleted−32

This diff is too big to show here.

test/command/6792.mddeleted−66

This diff is too big to show here.

test/command/6796.mddeleted−16

This diff is too big to show here.

test/command/6802.mddeleted−9

This diff is too big to show here.

test/command/6836.mddeleted−17

This diff is too big to show here.

test/command/6837.mddeleted−29

This diff is too big to show here.

test/command/6844.mddeleted−27

This diff is too big to show here.

test/command/6855.mddeleted−12

This diff is too big to show here.

test/command/6858.mddeleted−52

This diff is too big to show here.

test/command/6869.mddeleted−6

This diff is too big to show here.

test/command/6873.mddeleted−7

This diff is too big to show here.

test/command/6890.mddeleted−36

This diff is too big to show here.

test/command/6925.mddeleted−34

This diff is too big to show here.

test/command/6948.mddeleted−31

This diff is too big to show here.

test/command/6951.mddeleted−18

This diff is too big to show here.

test/command/6958.mddeleted−10

This diff is too big to show here.

test/command/6993.mddeleted−21

This diff is too big to show here.

test/command/7003.mddeleted−37

This diff is too big to show here.

test/command/7006.mddeleted−20

This diff is too big to show here.

test/command/7009.mddeleted−8

This diff is too big to show here.

test/command/7016.mddeleted−48

This diff is too big to show here.

test/command/7041.mddeleted−23

This diff is too big to show here.

test/command/7042.mddeleted−146

This diff is too big to show here.

test/command/7058.mddeleted−6

This diff is too big to show here.

test/command/7064.mddeleted−32

This diff is too big to show here.

test/command/7067.mddeleted−90

This diff is too big to show here.

test/command/7080.mddeleted−8

This diff is too big to show here.

test/command/7092.mddeleted−8

This diff is too big to show here.

test/command/7099.mddeleted−18

This diff is too big to show here.

test/command/7112.mddeleted−15

This diff is too big to show here.

test/command/7129.mddeleted−27

This diff is too big to show here.

test/command/7132.mddeleted−10

This diff is too big to show here.

test/command/7134.mddeleted−16

This diff is too big to show here.

test/command/7145.mddeleted−12

This diff is too big to show here.

test/command/7155.mddeleted−15

This diff is too big to show here.

test/command/7173.mddeleted−137

This diff is too big to show here.

test/command/7208.mddeleted−6

This diff is too big to show here.

test/command/7214.mddeleted−28

This diff is too big to show here.

test/command/7216.mddeleted−19

This diff is too big to show here.

test/command/7266.mddeleted−10

This diff is too big to show here.

test/command/7272.mddeleted−27

This diff is too big to show here.

test/command/7278.mddeleted−38

This diff is too big to show here.

test/command/7282.mddeleted−7

This diff is too big to show here.

test/command/7288.mddeleted−40

This diff is too big to show here.

test/command/7299.mddeleted−23

This diff is too big to show here.

test/command/7321.mddeleted−24

This diff is too big to show here.

test/command/7323.mddeleted−29

This diff is too big to show here.

test/command/7324.mddeleted−25

This diff is too big to show here.

test/command/7339.mddeleted−11

This diff is too big to show here.

test/command/7340.mddeleted−6

This diff is too big to show here.

test/command/7376.mddeleted−16

This diff is too big to show here.

test/command/7394.mddeleted−85

This diff is too big to show here.

test/command/7397.mddeleted−14

This diff is too big to show here.

test/command/7400.mddeleted−9

This diff is too big to show here.

test/command/7416.mddeleted−19

This diff is too big to show here.

test/command/853.mddeleted−18

This diff is too big to show here.

test/command/934.mddeleted−12

This diff is too big to show here.

test/command/982.mddeleted−11

This diff is too big to show here.

test/command/987.mddeleted−12

This diff is too big to show here.

test/command/A.txtdeleted−1

This diff is too big to show here.

test/command/B.txtdeleted−1

This diff is too big to show here.

test/command/C.txtdeleted−1

This diff is too big to show here.

test/command/D.txtdeleted−1

This diff is too big to show here.

test/command/SVG_logo-without-xml-declaration.svgdeleted−32

This diff is too big to show here.

test/command/SVG_logo.svgdeleted−33

This diff is too big to show here.

test/command/abbrevsdeleted−2

This diff is too big to show here.

test/command/adjacent_latex_blocks.mddeleted−9

This diff is too big to show here.

test/command/advanced-optical-materials.csldeleted−155

This diff is too big to show here.

test/command/annales.csldeleted−334

This diff is too big to show here.

test/command/apa.csldeleted−474

This diff is too big to show here.

test/command/archeologie-medievale.csldeleted−291

This diff is too big to show here.

test/command/ascii.mddeleted−89

This diff is too big to show here.

test/command/averroes.bibdeleted−95

This diff is too big to show here.

test/command/bar.texdeleted−1

This diff is too big to show here.

test/command/biblatex-266.mddeleted−34

This diff is too big to show here.

test/command/biblatex-aksin.mddeleted−78

This diff is too big to show here.

test/command/biblatex-almendro.mddeleted−71

This diff is too big to show here.

test/command/biblatex-angenendt.mddeleted−66

This diff is too big to show here.

test/command/biblatex-aristotle-anima.mddeleted−62

This diff is too big to show here.

test/command/biblatex-aristotle-physics.mddeleted−63

This diff is too big to show here.

test/command/biblatex-aristotle-poetics.mddeleted−65

This diff is too big to show here.

test/command/biblatex-aristotle-rhetoric.mddeleted−80

This diff is too big to show here.

test/command/biblatex-article.mddeleted−128

This diff is too big to show here.

test/command/biblatex-augustine.mddeleted−56

This diff is too big to show here.

test/command/biblatex-averroes-bland.mddeleted−85

This diff is too big to show here.

test/command/biblatex-averroes-hannes.mddeleted−84

This diff is too big to show here.

test/command/biblatex-averroes-hercz.mddeleted−85

This diff is too big to show here.

test/command/biblatex-baez-article.mddeleted−76

This diff is too big to show here.

test/command/biblatex-baez-online.mddeleted−69

This diff is too big to show here.

test/command/biblatex-basic.mddeleted−71

This diff is too big to show here.

test/command/biblatex-bertram.mddeleted−66

This diff is too big to show here.

test/command/biblatex-bibstring-resolution.mddeleted−20

This diff is too big to show here.

test/command/biblatex-book-averroes.mddeleted−129

This diff is too big to show here.

test/command/biblatex-book-coleridge.mddeleted−59

This diff is too big to show here.

test/command/biblatex-book-title-maintitle-series.mddeleted−39

This diff is too big to show here.

test/command/biblatex-book-vazques-de-parga.mddeleted−48

This diff is too big to show here.

test/command/biblatex-brandt.mddeleted−88

This diff is too big to show here.

test/command/biblatex-britannica.mddeleted−85

This diff is too big to show here.

test/command/biblatex-chiu.mddeleted−77

This diff is too big to show here.

test/command/biblatex-cicero.mddeleted−82

This diff is too big to show here.

test/command/biblatex-cms.mddeleted−81

This diff is too big to show here.

test/command/biblatex-coleridge.mddeleted−86

This diff is too big to show here.

test/command/biblatex-companion.mddeleted−70

This diff is too big to show here.

test/command/biblatex-cotton.mddeleted−69

This diff is too big to show here.

test/command/biblatex-crossref-inbook-mvbook.mddeleted−58

This diff is too big to show here.

test/command/biblatex-crossref-nested.mddeleted−100

This diff is too big to show here.

test/command/biblatex-ctan.mddeleted−73

This diff is too big to show here.

test/command/biblatex-dates.mddeleted−162

This diff is too big to show here.

test/command/biblatex-doody.mddeleted−101

This diff is too big to show here.

test/command/biblatex-edtf-date.mddeleted−72

This diff is too big to show here.

test/command/biblatex-escapedquotes.mddeleted−51

This diff is too big to show here.

test/command/biblatex-formatting.mddeleted−23

This diff is too big to show here.

test/command/biblatex-gaonkar-in.mddeleted−62

This diff is too big to show here.

test/command/biblatex-gaonkar.mddeleted−59

This diff is too big to show here.

test/command/biblatex-geer.mddeleted−70

This diff is too big to show here.

test/command/biblatex-gerhardt.mddeleted−64

This diff is too big to show here.

test/command/biblatex-gillies.mddeleted−69

This diff is too big to show here.

test/command/biblatex-glashow.mddeleted−51

This diff is too big to show here.

test/command/biblatex-gonzalez.mddeleted−62

This diff is too big to show here.

test/command/biblatex-hammond.mddeleted−63

This diff is too big to show here.

test/command/biblatex-herrmann.mddeleted−70

This diff is too big to show here.

test/command/biblatex-hyman.mddeleted−79

This diff is too big to show here.

test/command/biblatex-iliad.mddeleted−68

This diff is too big to show here.

test/command/biblatex-inbook-title-booktitle-maintitle-series-2.mddeleted−48

This diff is too big to show here.

test/command/biblatex-inbook-title-booktitle-maintitle-series.mddeleted−44

This diff is too big to show here.

test/command/biblatex-inbook.mddeleted−147

This diff is too big to show here.

test/command/biblatex-incollection-2.mddeleted−98

This diff is too big to show here.

test/command/biblatex-incollection.mddeleted−130

This diff is too big to show here.

test/command/biblatex-inproceedings.mddeleted−88

This diff is too big to show here.

test/command/biblatex-issue288.mddeleted−35

This diff is too big to show here.

test/command/biblatex-itzhaki.mddeleted−82

This diff is too big to show here.

test/command/biblatex-jaffe.mddeleted−82

This diff is too big to show here.

test/command/biblatex-jcg.mddeleted−54

This diff is too big to show here.

test/command/biblatex-kant-kpv.mddeleted−90

This diff is too big to show here.

test/command/biblatex-kant-ku.mddeleted−82

This diff is too big to show here.

test/command/biblatex-kastenholz.mddeleted−126

This diff is too big to show here.

test/command/biblatex-knuth-ct-a.mddeleted−78

This diff is too big to show here.

test/command/biblatex-knuth-ct-b.mddeleted−70

This diff is too big to show here.

test/command/biblatex-knuth-ct-c.mddeleted−69

This diff is too big to show here.

test/command/biblatex-knuth-ct-d.mddeleted−71

This diff is too big to show here.

test/command/biblatex-knuth-ct-e.mddeleted−66

This diff is too big to show here.

test/command/biblatex-knuth-ct-related.mddeleted−72

This diff is too big to show here.

test/command/biblatex-knuth-ct.mddeleted−66

This diff is too big to show here.

test/command/biblatex-kowalik.mddeleted−68

This diff is too big to show here.

test/command/biblatex-kullback-related.mddeleted−62

This diff is too big to show here.

test/command/biblatex-kullback-reprint.mddeleted−71

This diff is too big to show here.

test/command/biblatex-kullback.mddeleted−52

This diff is too big to show here.

test/command/biblatex-laufenberg.mddeleted−109

This diff is too big to show here.

test/command/biblatex-loh.mddeleted−65

This diff is too big to show here.

test/command/biblatex-malinowski.mddeleted−67

This diff is too big to show here.

test/command/biblatex-manual.mddeleted−51

This diff is too big to show here.

test/command/biblatex-markey.mddeleted−65

This diff is too big to show here.

test/command/biblatex-maron.mddeleted−70

This diff is too big to show here.

test/command/biblatex-massa.mddeleted−56

This diff is too big to show here.

test/command/biblatex-moore-related.mddeleted−66

This diff is too big to show here.

test/command/biblatex-moore.mddeleted−56

This diff is too big to show here.

test/command/biblatex-moraux.mddeleted−94

This diff is too big to show here.

test/command/biblatex-murray.mddeleted−105

This diff is too big to show here.

test/command/biblatex-nietzsche-historie.mddeleted−100

This diff is too big to show here.

test/command/biblatex-nietzsche-ksa.mddeleted−89

This diff is too big to show here.

test/command/biblatex-nietzsche-ksa1.mddeleted−95

This diff is too big to show here.

test/command/biblatex-online.mddeleted−64

This diff is too big to show here.

test/command/biblatex-options-url-false-doi-false.mddeleted−57

This diff is too big to show here.

test/command/biblatex-padhye.mddeleted−117

This diff is too big to show here.

test/command/biblatex-patent.mddeleted−158

This diff is too big to show here.

test/command/biblatex-periodical.mddeleted−31

This diff is too big to show here.

test/command/biblatex-piccato.mddeleted−59

This diff is too big to show here.

test/command/biblatex-pines.mddeleted−77

This diff is too big to show here.

test/command/biblatex-quotes.mddeleted−44

This diff is too big to show here.

test/command/biblatex-reese.mddeleted−71

This diff is too big to show here.

test/command/biblatex-report.mddeleted−119

This diff is too big to show here.

test/command/biblatex-salam.mddeleted−69

This diff is too big to show here.

test/command/biblatex-sarfraz.mddeleted−65

This diff is too big to show here.

test/command/biblatex-shore.mddeleted−66

This diff is too big to show here.

test/command/biblatex-sigfridsson.mddeleted−106

This diff is too big to show here.

test/command/biblatex-sorace.mddeleted−65

This diff is too big to show here.

test/command/biblatex-spiegelberg.mddeleted−74

This diff is too big to show here.

test/command/biblatex-springer.mddeleted−58

This diff is too big to show here.

test/command/biblatex-strings.mddeleted−46

This diff is too big to show here.

test/command/biblatex-test-case-conversion.mddeleted−73

This diff is too big to show here.

test/command/biblatex-textnormal.mddeleted−17

This diff is too big to show here.

test/command/biblatex-thesis.mddeleted−68

This diff is too big to show here.

test/command/biblatex-title-and-shorttitle.mddeleted−76

This diff is too big to show here.

test/command/biblatex-vangennep-related.mddeleted−69

This diff is too big to show here.

test/command/biblatex-vangennep-trans.mddeleted−69

This diff is too big to show here.

test/command/biblatex-vangennep.mddeleted−61

This diff is too big to show here.

test/command/biblatex-vazques-de-parga-mvbook.mddeleted−75

This diff is too big to show here.

test/command/biblatex-vazques-de-parga.mddeleted−74

This diff is too big to show here.

test/command/biblatex-video.mddeleted−19

This diff is too big to show here.

test/command/biblatex-vizedom-related.mddeleted−68

This diff is too big to show here.

test/command/biblatex-wassenberg.mddeleted−83

This diff is too big to show here.

test/command/biblatex-weinberg.mddeleted−52

This diff is too big to show here.

test/command/biblatex-westfahl-frontier.mddeleted−60

This diff is too big to show here.

test/command/biblatex-westfahl-space.mddeleted−106

This diff is too big to show here.

test/command/biblatex-wilde.mddeleted−65

This diff is too big to show here.

test/command/biblatex-worman.mddeleted−60

This diff is too big to show here.

test/command/biblatex-yoon.mddeleted−67

This diff is too big to show here.

test/command/biblio.bibdeleted−26

This diff is too big to show here.

test/command/bibtex-basic.mddeleted−71

This diff is too big to show here.

test/command/bioethics.csldeleted−226

This diff is too big to show here.

test/command/chap1/spider.pngdeleted

Binary file not shown.

test/command/chap1/text.mddeleted−17

This diff is too big to show here.

test/command/chap2/spider.pngdeleted

Binary file not shown.

test/command/chap2/text.mddeleted−5

This diff is too big to show here.

test/command/chicago-annotated-bibliography.csldeleted−1207

This diff is too big to show here.

test/command/chicago-author-date-with-original-date-and-status.csldeleted−575

This diff is too big to show here.

test/command/chicago-fullnote-bibliography.csldeleted−1430

This diff is too big to show here.

test/command/chicago-note-bibliography.csldeleted−1005

This diff is too big to show here.

test/command/chinese-gb7714-2005-numeric.csldeleted−213

This diff is too big to show here.

test/command/cite-in-inline-note.mddeleted−6

This diff is too big to show here.

test/command/citeproc-17.mddeleted−17

This diff is too big to show here.

test/command/citeproc-20.mddeleted−25

This diff is too big to show here.

test/command/citeproc-7a.mddeleted−42

This diff is too big to show here.

test/command/citeproc-7b.mddeleted−36

This diff is too big to show here.

test/command/citeproc-author-in-text-suffix.mddeleted−6

This diff is too big to show here.

test/command/corrupt.svgdeleted−5

This diff is too big to show here.

test/command/csv.mddeleted−46

This diff is too big to show here.

test/command/defaults-inheritance-1.mddeleted−6

This diff is too big to show here.

test/command/defaults-inheritance-2.mddeleted−5

This diff is too big to show here.

test/command/defaults-inheritance-3.mddeleted−6

This diff is too big to show here.

test/command/defaults1.yamldeleted−1

This diff is too big to show here.

test/command/defaults2.yamldeleted−4

This diff is too big to show here.

test/command/defaults3.yamldeleted−4

This diff is too big to show here.

test/command/defaults4.yamldeleted−3

This diff is too big to show here.

test/command/defaults5.yamldeleted−2

This diff is too big to show here.

test/command/defaults6.yamldeleted−2

This diff is too big to show here.

test/command/defaults7.yamldeleted−2

This diff is too big to show here.

test/command/defaults8.yamldeleted−2

This diff is too big to show here.

test/command/defaults9.yamldeleted−1

This diff is too big to show here.

test/command/din-1505-2.csldeleted−406

This diff is too big to show here.

test/command/docbook-bibliography.mddeleted−20

This diff is too big to show here.

test/command/dots.mddeleted−12

This diff is too big to show here.

test/command/duplicate_attributes.mddeleted−7

This diff is too big to show here.

test/command/emoji.mddeleted−27

This diff is too big to show here.

test/command/empty_paragraphs.mddeleted−93

This diff is too big to show here.

test/command/gfm.mddeleted−166

This diff is too big to show here.

test/command/harvard-university-of-kent.csldeleted−253

This diff is too big to show here.

test/command/hspace.mddeleted−56

This diff is too big to show here.

test/command/html-read-figure.mddeleted−45

This diff is too big to show here.

test/command/html-trim-definition-list-terms.mddeleted−17

This diff is too big to show here.

test/command/hyphenat.mddeleted−49

This diff is too big to show here.

test/command/ieee.csldeleted−339

This diff is too big to show here.

test/command/ifstrequal.mddeleted−9

This diff is too big to show here.

test/command/indented-fences.mddeleted−20

This diff is too big to show here.

test/command/inkscape-cube.svgdeleted−119

This diff is too big to show here.

test/command/issue160.csldeleted−28

This diff is too big to show here.

test/command/issue437.csldeleted−26

This diff is too big to show here.

test/command/issue58.csldeleted−553

This diff is too big to show here.

test/command/jats.csldeleted−208

This diff is too big to show here.

test/command/latex-center.mddeleted−13

This diff is too big to show here.

test/command/latex-color.mddeleted−127

This diff is too big to show here.

test/command/latex-command-comment.mddeleted−7

This diff is too big to show here.

test/command/latex-fontawesome.mddeleted−13

This diff is too big to show here.

test/command/latex-tabular-column-specs.mddeleted−45

This diff is too big to show here.

test/command/le-tapuscrit-note.csldeleted−496

This diff is too big to show here.

test/command/lettrine.mddeleted−9

This diff is too big to show here.

test/command/lists-inside-definition.mddeleted−67

This diff is too big to show here.

test/command/locators.csldeleted−68

This diff is too big to show here.

test/command/lstlisting.mddeleted−25

This diff is too big to show here.

test/command/lua-pandoc-state.luadeleted−11

This diff is too big to show here.

test/command/lua-pandoc-state.mddeleted−14

This diff is too big to show here.

test/command/macro-defs-in-preamble.mddeleted−16

This diff is too big to show here.

test/command/macros.mddeleted−125

This diff is too big to show here.

test/command/make-section-column-divs.mddeleted−28

This diff is too big to show here.

test/command/md-abbrevs.mddeleted−20

This diff is too big to show here.

test/command/mmd-metadata.mddeleted−20

This diff is too big to show here.

test/command/modern-humanities-research-association.csldeleted−445

This diff is too big to show here.

test/command/multiple-metadata-blocks.mddeleted−15

This diff is too big to show here.

test/command/nested-table-to-asciidoc-6942.mddeleted−82

This diff is too big to show here.

test/command/newif.mddeleted−55

This diff is too big to show here.

test/command/oscola.csl−680

This diff is too big to show here.

test/command/pandoc-citeproc-118.md−28

This diff is too big to show here.

test/command/pandoc-citeproc-119.md−38

This diff is too big to show here.

test/command/pandoc-citeproc-13.md−29

This diff is too big to show here.

test/command/pandoc-citeproc-136.md−23

This diff is too big to show here.

test/command/pandoc-citeproc-14.md−77

This diff is too big to show here.

test/command/pandoc-citeproc-152.md−63

This diff is too big to show here.

test/command/pandoc-citeproc-160.md−44

This diff is too big to show here.

test/command/pandoc-citeproc-175.md−43

This diff is too big to show here.

test/command/pandoc-citeproc-197.md−31

This diff is too big to show here.

test/command/pandoc-citeproc-213.md−33

This diff is too big to show here.

test/command/pandoc-citeproc-25.md−30

This diff is too big to show here.

test/command/pandoc-citeproc-250.md−21

This diff is too big to show here.

test/command/pandoc-citeproc-27.md−38

This diff is too big to show here.

test/command/pandoc-citeproc-292.md−43

This diff is too big to show here.

test/command/pandoc-citeproc-301.md−25

This diff is too big to show here.

test/command/pandoc-citeproc-307.md−31

This diff is too big to show here.

test/command/pandoc-citeproc-31.md−48

This diff is too big to show here.

test/command/pandoc-citeproc-312.md−171

This diff is too big to show here.

test/command/pandoc-citeproc-320.md−254

This diff is too big to show here.

test/command/pandoc-citeproc-320a.md−87

This diff is too big to show here.

test/command/pandoc-citeproc-322.md−35

This diff is too big to show here.

test/command/pandoc-citeproc-325.md−30

This diff is too big to show here.

test/command/pandoc-citeproc-327.md−51

This diff is too big to show here.

test/command/pandoc-citeproc-338.md−35

This diff is too big to show here.

test/command/pandoc-citeproc-351.md−27

This diff is too big to show here.

test/command/pandoc-citeproc-356.md−20

This diff is too big to show here.

test/command/pandoc-citeproc-360.md−35

This diff is too big to show here.

test/command/pandoc-citeproc-361.md−80

This diff is too big to show here.

test/command/pandoc-citeproc-365.md−39

This diff is too big to show here.

test/command/pandoc-citeproc-371.md−40

This diff is too big to show here.

test/command/pandoc-citeproc-38.md−29

This diff is too big to show here.

test/command/pandoc-citeproc-386.md−35

This diff is too big to show here.

test/command/pandoc-citeproc-392.md−29

This diff is too big to show here.

test/command/pandoc-citeproc-399.md−45

This diff is too big to show here.

test/command/pandoc-citeproc-401.md−59

This diff is too big to show here.

test/command/pandoc-citeproc-408.md−39

This diff is too big to show here.

test/command/pandoc-citeproc-416.md−60

This diff is too big to show here.

test/command/pandoc-citeproc-437.md−23

This diff is too big to show here.

test/command/pandoc-citeproc-47.md−112

This diff is too big to show here.

test/command/pandoc-citeproc-51.md−45

This diff is too big to show here.

test/command/pandoc-citeproc-53.md−56

This diff is too big to show here.

test/command/pandoc-citeproc-57.md−37

This diff is too big to show here.

test/command/pandoc-citeproc-58.md−32

This diff is too big to show here.

test/command/pandoc-citeproc-61.md−77

This diff is too big to show here.

test/command/pandoc-citeproc-64.md−24

This diff is too big to show here.

test/command/pandoc-citeproc-65.md−38

This diff is too big to show here.

test/command/pandoc-citeproc-68.md−56

This diff is too big to show here.

test/command/pandoc-citeproc-7.md−31

This diff is too big to show here.

test/command/pandoc-citeproc-70.md−73

This diff is too big to show here.

test/command/pandoc-citeproc-75.md−67

This diff is too big to show here.

test/command/pandoc-citeproc-76.md−64

This diff is too big to show here.

test/command/pandoc-citeproc-77.md−67

This diff is too big to show here.

test/command/pandoc-citeproc-82.md−39

This diff is too big to show here.

test/command/pandoc-citeproc-87.md−156

This diff is too big to show here.

test/command/pandoc-citeproc-chicago-author-date.md−109

This diff is too big to show here.

test/command/pandoc-citeproc-chicago-fullnote-bibliography.md−134

This diff is too big to show here.

test/command/pandoc-citeproc-ieee.md−113

This diff is too big to show here.

test/command/pandoc-citeproc-locators-delimited.md−127

This diff is too big to show here.

test/command/pandoc-citeproc-locators-integrated.md−159

This diff is too big to show here.

test/command/pandoc-citeproc-move-period-inside-quote.md−52

This diff is too big to show here.

test/command/pandoc-citeproc-no-author.md−73

This diff is too big to show here.

test/command/pandoc-citeproc-number-of-volumes.md−29

This diff is too big to show here.

test/command/pandoc-citeproc-page-range.md−32

This diff is too big to show here.

test/command/parse-raw.md−27

This diff is too big to show here.

test/command/refs.md−97

This diff is too big to show here.

test/command/rst-links.md−18

This diff is too big to show here.

test/command/sage-harvard.csl−202

This diff is too big to show here.

test/command/science.csl−245

This diff is too big to show here.

test/command/section-divs.md−25

This diff is too big to show here.

test/command/setext-fenced-div.md−9

This diff is too big to show here.

test/command/shift-heading-level-by.md−32

This diff is too big to show here.

test/command/sloppypar.md−23

This diff is too big to show here.

test/command/smart.md−45

This diff is too big to show here.

test/command/style399.csl−12

This diff is too big to show here.

test/command/sub-file-chapter-1.tex−8

This diff is too big to show here.

test/command/sub-file-chapter-2.tex−8

This diff is too big to show here.

test/command/svg.md−134

This diff is too big to show here.

test/command/table-with-cell-align.md−82

This diff is too big to show here.

test/command/table-with-column-span.md−276

This diff is too big to show here.

test/command/tabularx.md−185

This diff is too big to show here.

test/command/tasklist.md−113

This diff is too big to show here.

test/command/tex-group.md−12

This diff is too big to show here.

test/command/toc.md−47

This diff is too big to show here.

test/command/translations.md−29

This diff is too big to show here.

test/command/unicode-collation.md−130

This diff is too big to show here.

test/command/vancouver.csl−351

This diff is too big to show here.

test/command/vars-and-metadata.md−15

This diff is too big to show here.

test/command/video-audio.md−19

This diff is too big to show here.

test/command/write18.md−14

This diff is too big to show here.

test/command/yaml-metadata-blocks.md−63

This diff is too big to show here.

test/command/yaml-metadata.yaml−4

This diff is too big to show here.

test/command/yaml-with-chomp.md−12

This diff is too big to show here.

test/command/zeitschrift-fur-kunstgeschichte.csl−346

This diff is too big to show here.

test/creole-reader.native−132

This diff is too big to show here.

test/creole-reader.txt−137

This diff is too big to show here.

test/docbook-chapter.docbook−30

This diff is too big to show here.

test/docbook-chapter.native−17

This diff is too big to show here.

test/docx/0_level_headers.docx

This diff is too big to show here.

test/docx/0_level_headers.native−52

This diff is too big to show here.

test/docx/adjacent_codeblocks.docx

This diff is too big to show here.

test/docx/adjacent_codeblocks.native−6

This diff is too big to show here.

test/docx/alternate_document_path.docx

This diff is too big to show here.

test/docx/alternate_document_path.native−3

This diff is too big to show here.

test/docx/block_quotes.docx

This diff is too big to show here.

test/docx/char_styles.docx

This diff is too big to show here.

test/docx/compact-style-removal.docx

This diff is too big to show here.

test/docx/compact-style-removal.native−5

This diff is too big to show here.

test/docx/custom-style-no-styles.native−4

This diff is too big to show here.

test/docx/custom-style-preserve.native−15

This diff is too big to show here.

test/docx/custom-style-reference.docx

This diff is too big to show here.

test/docx/custom-style-roundtrip-end.native−5

This diff is too big to show here.

test/docx/custom-style-with-styles.native−7

This diff is too big to show here.

test/docx/custom_style.native−5

This diff is too big to show here.

test/docx/deep_normalize.docx

This diff is too big to show here.

test/docx/document-properties-short-desc.native−2

This diff is too big to show here.

test/docx/document-properties.native−2

This diff is too big to show here.

test/docx/drop_cap.docx

This diff is too big to show here.

test/docx/golden/block_quotes.docx

This diff is too big to show here.

test/docx/golden/codeblock.docx

This diff is too big to show here.

test/docx/golden/comments.docx

This diff is too big to show here.

test/docx/golden/custom_style_no_reference.docx

This diff is too big to show here.

test/docx/golden/custom_style_preserve.docx

This diff is too big to show here.

test/docx/golden/custom_style_reference.docx

This diff is too big to show here.

test/docx/golden/definition_list.docx

This diff is too big to show here.

test/docx/golden/document-properties-short-desc.docx

This diff is too big to show here.

test/docx/golden/document-properties.docx

This diff is too big to show here.

test/docx/golden/headers.docx

This diff is too big to show here.

test/docx/golden/image.docx

This diff is too big to show here.

test/docx/golden/inline_code.docx

This diff is too big to show here.

test/docx/golden/inline_formatting.docx

This diff is too big to show here.

test/docx/golden/inline_images.docx

This diff is too big to show here.

test/docx/golden/link_in_notes.docx

This diff is too big to show here.

test/docx/golden/links.docx

This diff is too big to show here.

test/docx/golden/lists.docx

This diff is too big to show here.

test/docx/golden/lists_continuing.docx

This diff is too big to show here.

test/docx/golden/lists_multiple_initial.docx

This diff is too big to show here.

test/docx/golden/lists_restarting.docx

This diff is too big to show here.

test/docx/golden/nested_anchors_in_header.docx

This diff is too big to show here.

test/docx/golden/notes.docx

This diff is too big to show here.

test/docx/golden/raw-blocks.docx

This diff is too big to show here.

test/docx/golden/raw-bookmarks.docx

This diff is too big to show here.

test/docx/golden/table_one_row.docx

This diff is too big to show here.

test/docx/golden/table_with_list_cell.docx

This diff is too big to show here.

test/docx/golden/tables-default-widths.docx

This diff is too big to show here.

test/docx/golden/tables.docx

This diff is too big to show here.

test/docx/golden/track_changes_deletion.docx

This diff is too big to show here.

test/docx/golden/track_changes_insertion.docx

This diff is too big to show here.

test/docx/golden/track_changes_move.docx

This diff is too big to show here.

test/docx/golden/track_changes_scrubbed_metadata.docx

This diff is too big to show here.

test/docx/golden/unicode.docx

This diff is too big to show here.

test/docx/golden/verbatim_subsuper.docx

This diff is too big to show here.

test/docx/hanging_indent.docx

This diff is too big to show here.

test/docx/headers.docx

This diff is too big to show here.

test/docx/image_no_embed.native−2

This diff is too big to show here.

test/docx/image_no_embed_writer.native−2

This diff is too big to show here.

test/docx/image_vml_as_object.docx

This diff is too big to show here.

test/docx/image_vml_as_object.native−2

This diff is too big to show here.

test/docx/image_writer_test.native−8

This diff is too big to show here.

test/docx/inline_formatting.docx

This diff is too big to show here.

test/docx/inline_images.docx

This diff is too big to show here.

test/docx/inline_images.native−2

This diff is too big to show here.

test/docx/inline_images_writer_test.native−2

This diff is too big to show here.

test/docx/instrText_hyperlink.docx

This diff is too big to show here.

test/docx/instrText_hyperlink.native−1

This diff is too big to show here.

test/docx/link_in_notes.docx

This diff is too big to show here.

test/docx/links.docx

This diff is too big to show here.

test/docx/lists-compact.docx

This diff is too big to show here.

test/docx/lists-compact.native−5

This diff is too big to show here.

test/docx/lists.docx

This diff is too big to show here.

test/docx/lists_continuing.docx

This diff is too big to show here.

test/docx/lists_continuing.native−7

This diff is too big to show here.

test/docx/lists_level_override.docx

This diff is too big to show here.

test/docx/lists_level_override.native−37

This diff is too big to show here.

test/docx/lists_multiple_initial.native−8

This diff is too big to show here.

test/docx/lists_restarting.docx

This diff is too big to show here.

test/docx/lists_restarting.native−8

This diff is too big to show here.

test/docx/lists_sublist_reset.docx

This diff is too big to show here.

test/docx/lists_sublist_reset.native−8

This diff is too big to show here.

test/docx/metadata.docx

This diff is too big to show here.

test/docx/metadata_after_normal.docx

This diff is too big to show here.

test/docx/nested_anchors_in_header.docx

This diff is too big to show here.

test/docx/nested_anchors_in_header.native−15

This diff is too big to show here.

test/docx/nested_sdt.docx

This diff is too big to show here.

test/docx/nested_sdt.native−3

This diff is too big to show here.

test/docx/nested_smart_tags.docx

This diff is too big to show here.

test/docx/nested_smart_tags.native−7

This diff is too big to show here.

test/docx/normalize.docx

This diff is too big to show here.

test/docx/notes.docx

This diff is too big to show here.

test/docx/numbered_header.docx

This diff is too big to show here.

test/docx/overlapping_targets.docx

This diff is too big to show here.

test/docx/overlapping_targets.native−3

This diff is too big to show here.

test/docx/paragraph_insertion_deletion.docx

This diff is too big to show here.

test/docx/paragraph_insertion_deletion_accept.native−2

This diff is too big to show here.

test/docx/paragraph_insertion_deletion_all.native−3

This diff is too big to show here.

test/docx/paragraph_insertion_deletion_reject.native−2

This diff is too big to show here.

test/docx/raw-blocks.native−6

This diff is too big to show here.

test/docx/raw-bookmarks.native−3

This diff is too big to show here.

test/docx/sdt_elements.docx

This diff is too big to show here.

test/docx/sdt_elements.native−24

This diff is too big to show here.

test/docx/sdt_in_footnote.docx

This diff is too big to show here.

test/docx/sdt_in_footnote.native−1

This diff is too big to show here.

test/docx/table_captions_no_field.docx

This diff is too big to show here.

test/docx/table_captions_no_field.native−34

This diff is too big to show here.

test/docx/table_captions_with_field.docx

This diff is too big to show here.

test/docx/table_captions_with_field.native−54

This diff is too big to show here.

test/docx/table_header_rowspan.docx

This diff is too big to show here.

test/docx/table_header_rowspan.native−189

This diff is too big to show here.

test/docx/table_one_header_row.docx

This diff is too big to show here.

test/docx/table_one_header_row.native−18

This diff is too big to show here.

test/docx/table_one_row.docx

This diff is too big to show here.

test/docx/table_one_row.native−18

This diff is too big to show here.

test/docx/table_variable_width.docx

This diff is too big to show here.

test/docx/table_variable_width.native−40

This diff is too big to show here.

test/docx/table_with_list_cell.docx

This diff is too big to show here.

test/docx/table_with_list_cell.native−25

This diff is too big to show here.

test/docx/tables-default-widths.native−92

This diff is too big to show here.

test/docx/tables.docx

This diff is too big to show here.

test/docx/tables.native−92

This diff is too big to show here.

test/docx/track_changes_scrubbed_metadata.docx

This diff is too big to show here.

test/docx/track_changes_scrubbed_metadata.native−9

This diff is too big to show here.

test/docx/trim_last_inline.docx

This diff is too big to show here.

test/docx/trim_last_inline.native−2

This diff is too big to show here.

test/docx/unused_anchors.docx

This diff is too big to show here.

test/docx/unused_anchors.native−3

This diff is too big to show here.

test/dokuwiki_multiblock_table.dokuwiki−5

This diff is too big to show here.

test/dokuwiki_multiblock_table.native−41

This diff is too big to show here.

test/epub/epub2_cover.epub

This diff is too big to show here.

test/epub/epub2_no_cover.epub

This diff is too big to show here.

test/epub/epub2_picture.epub

This diff is too big to show here.

test/epub/img_no_cover.epub

This diff is too big to show here.

test/epub/wasteland.epub

This diff is too big to show here.

test/epub/wasteland.native−938

This diff is too big to show here.

test/fb2/basic.fb2−73

This diff is too big to show here.

test/fb2/images-embedded.fb2−2

This diff is too big to show here.

test/fb2/images.fb2−2

This diff is too big to show here.

test/fb2/math.fb2−2

This diff is too big to show here.

test/fb2/meta.fb2−3

This diff is too big to show here.

test/fb2/meta.markdown−7

This diff is too big to show here.

test/fb2/reader/emphasis.fb2−11

This diff is too big to show here.

test/fb2/reader/emphasis.native−6

This diff is too big to show here.

test/fb2/reader/epigraph.fb2−18

This diff is too big to show here.

test/fb2/reader/epigraph.native−9

This diff is too big to show here.

test/fb2/reader/meta.fb2−26

This diff is too big to show here.

test/fb2/reader/meta.native−2

This diff is too big to show here.

test/fb2/reader/notes.fb2−19

This diff is too big to show here.

test/fb2/reader/notes.native−4

This diff is too big to show here.

test/fb2/reader/poem.fb2−28

This diff is too big to show here.

test/fb2/reader/poem.native−14

This diff is too big to show here.

test/fb2/reader/titles.fb2−18

This diff is too big to show here.

test/fb2/reader/titles.native−8

This diff is too big to show here.

test/fb2/test.jpg

This diff is too big to show here.

test/fb2/titles.fb2−3

This diff is too big to show here.

test/fb2/titles.markdown−6

This diff is too big to show here.

test/ipynb/simple.in.native−15

This diff is too big to show here.

test/ipynb/simple.ipynb−86

This diff is too big to show here.

test/ipynb/simple.out.native−15

This diff is too big to show here.

test/jats-reader.native−671

This diff is too big to show here.

test/jats-reader.xml−1161

This diff is too big to show here.

test/jira-reader.jira−284

This diff is too big to show here.

test/jira-reader.native−185

This diff is too big to show here.

test/lhs-test.html−231

This diff is too big to show here.

test/lhs-test.html+lhs−231

This diff is too big to show here.

test/lhs-test.latex−121

This diff is too big to show here.

test/lhs-test.latex+lhs−86

This diff is too big to show here.

test/lua/attr-test.lua−6

This diff is too big to show here.

test/lua/block-count.lua−11

This diff is too big to show here.

test/lua/blocks-filter.lua−8

This diff is too big to show here.

test/lua/hello-world-doc.lua−10

This diff is too big to show here.

test/lua/implicit-doc-filter.lua−6

This diff is too big to show here.

test/lua/inlines-filter.lua−19

This diff is too big to show here.

test/lua/markdown-reader.lua−12

This diff is too big to show here.

test/lua/math.lua−10

This diff is too big to show here.

test/lua/meta.lua−6

This diff is too big to show here.

test/lua/metatable-catch-all.lua−20

This diff is too big to show here.

test/lua/module/pandoc-list.lua−160

This diff is too big to show here.

test/lua/module/pandoc-mediabag.lua−72

This diff is too big to show here.

test/lua/module/pandoc-path.lua−44

This diff is too big to show here.

test/lua/module/pandoc-types.lua−111

This diff is too big to show here.

test/lua/module/pandoc-utils.lua−159

This diff is too big to show here.

test/lua/module/pandoc.lua−253

This diff is too big to show here.

test/lua/plain-to-para.lua−6

This diff is too big to show here.

test/lua/require-file.lua−2

This diff is too big to show here.

test/lua/script-name.lua−3

This diff is too big to show here.

test/lua/single-to-double-quoted.lua−10

This diff is too big to show here.

test/lua/smallcaps-title.lua−12

This diff is too big to show here.

test/lua/smart-constructors.lua−10

This diff is too big to show here.

test/lua/strmacro.lua−11

This diff is too big to show here.

test/lua/undiv.lua−3

This diff is too big to show here.

test/lua/uppercase-header.lua−9

This diff is too big to show here.

test/man-reader.man−391

This diff is too big to show here.

test/man-reader.native−300

This diff is too big to show here.

test/markdown-citations.native−17

This diff is too big to show here.

test/markdown-reader-more.native−311

This diff is too big to show here.

test/odt/markdown/formula.md−1

This diff is too big to show here.

test/odt/native/image.native−1

This diff is too big to show here.

test/odt/native/imageIndex.native−1

This diff is too big to show here.

test/odt/native/imageWithCaption.native−1

This diff is too big to show here.

test/odt/native/inlinedCode.native−1

This diff is too big to show here.

test/odt/native/simpleTable.native−1

This diff is too big to show here.

test/odt/native/simpleTableWithCaption.native−1

This diff is too big to show here.

test/odt/native/tab.native−1

This diff is too big to show here.

test/odt/native/tableWithContents.native−1

This diff is too big to show here.

test/odt/native/textMixedStyles.native−5

This diff is too big to show here.

test/odt/odt/inlinedCode.odt

This diff is too big to show here.

test/odt/odt/orderedListMixed.odt

This diff is too big to show here.

test/odt/odt/orderedListRoman.odt

This diff is too big to show here.

test/odt/odt/orderedListSimple.odt

This diff is too big to show here.

test/odt/odt/simpleTableWithCaption.odt

This diff is too big to show here.

test/odt/odt/tab.odt

This diff is too big to show here.

test/odt/odt/tableWithContents.odt

This diff is too big to show here.

test/odt/odt/textMixedStyles.odt

This diff is too big to show here.

test/org-select-tags.native−7

This diff is too big to show here.

test/org-select-tags.org−17

This diff is too big to show here.

test/pipe-tables.native−326

This diff is too big to show here.

test/pptx/code-custom.pptx

This diff is too big to show here.

test/pptx/code-custom_templated.pptx

This diff is too big to show here.

test/pptx/code.native−21

This diff is too big to show here.

test/pptx/code.pptx

This diff is too big to show here.

test/pptx/code_templated.pptx

This diff is too big to show here.

test/pptx/document-properties-short-desc.native−2

This diff is too big to show here.

test/pptx/document-properties-short-desc.pptx

This diff is too big to show here.

test/pptx/document-properties-short-desc_templated.pptx

This diff is too big to show here.

test/pptx/document-properties.native−2

This diff is too big to show here.

test/pptx/document-properties.pptx

This diff is too big to show here.

test/pptx/document-properties_templated.pptx

This diff is too big to show here.

test/pptx/endnotes.native−2

This diff is too big to show here.

test/pptx/endnotes.pptx

This diff is too big to show here.

test/pptx/endnotes_templated.pptx

This diff is too big to show here.

test/pptx/endnotes_toc.pptx

This diff is too big to show here.

test/pptx/endnotes_toc_templated.pptx

This diff is too big to show here.

test/pptx/images.native−5

This diff is too big to show here.

test/pptx/images.pptx

This diff is too big to show here.

test/pptx/images_templated.pptx

This diff is too big to show here.

test/pptx/inline_formatting.native−5

This diff is too big to show here.

test/pptx/inline_formatting.pptx

This diff is too big to show here.

test/pptx/inline_formatting_templated.pptx

This diff is too big to show here.

test/pptx/lists.native−18

This diff is too big to show here.

test/pptx/lists.pptx

This diff is too big to show here.

test/pptx/lists_templated.pptx

This diff is too big to show here.

test/pptx/raw_ooxml.native−3

This diff is too big to show here.

test/pptx/raw_ooxml.pptx

This diff is too big to show here.

test/pptx/raw_ooxml_templated.pptx

This diff is too big to show here.

test/pptx/reference_depth.pptx

This diff is too big to show here.

test/pptx/remove_empty_slides.native−5

This diff is too big to show here.

test/pptx/remove_empty_slides.pptx

This diff is too big to show here.

test/pptx/remove_empty_slides_templated.pptx

This diff is too big to show here.

test/pptx/slide_breaks.native−7

This diff is too big to show here.

test/pptx/slide_breaks.pptx

This diff is too big to show here.

test/pptx/slide_breaks_slide_level_1.pptx

This diff is too big to show here.

test/pptx/slide_breaks_slide_level_1_templated.pptx

This diff is too big to show here.

test/pptx/slide_breaks_templated.pptx

This diff is too big to show here.

test/pptx/slide_breaks_toc.pptx

This diff is too big to show here.

test/pptx/slide_breaks_toc_templated.pptx

This diff is too big to show here.

test/pptx/speaker_notes.native−17

This diff is too big to show here.

test/pptx/speaker_notes.pptx

This diff is too big to show here.

test/pptx/speaker_notes_after_metadata.native−5

This diff is too big to show here.

test/pptx/speaker_notes_after_metadata.pptx

This diff is too big to show here.

test/pptx/speaker_notes_after_metadata_templated.pptx

This diff is too big to show here.

test/pptx/speaker_notes_afterheader.native−3

This diff is too big to show here.

test/pptx/speaker_notes_afterheader.pptx

This diff is too big to show here.

test/pptx/speaker_notes_afterheader_templated.pptx

This diff is too big to show here.

test/pptx/speaker_notes_afterseps.native−63

This diff is too big to show here.

test/pptx/speaker_notes_afterseps.pptx

This diff is too big to show here.

test/pptx/speaker_notes_afterseps_templated.pptx

This diff is too big to show here.

test/pptx/speaker_notes_templated.pptx

This diff is too big to show here.

test/pptx/start_numbering_at.native−9

This diff is too big to show here.

test/pptx/start_numbering_at.pptx

This diff is too big to show here.

test/pptx/start_numbering_at_templated.pptx

This diff is too big to show here.

test/pptx/tables.native−95

This diff is too big to show here.

test/pptx/tables.pptx

This diff is too big to show here.

test/pptx/tables_templated.pptx

This diff is too big to show here.

test/pptx/two_column.native−9

This diff is too big to show here.

test/pptx/two_column.pptx

This diff is too big to show here.

test/pptx/two_column_templated.pptx

This diff is too big to show here.

test/s5-fancy.html−64

This diff is too big to show here.

test/tables-rstsubset.native−301

This diff is too big to show here.

test/tables.asciidoc−67

This diff is too big to show here.

test/tables.asciidoctor−67

This diff is too big to show here.

test/tables.context−230

This diff is too big to show here.

test/tables.custom−200

This diff is too big to show here.

test/tables.fb2−15

This diff is too big to show here.

test/tables.haddock−90

This diff is too big to show here.

test/tables.html5−204

This diff is too big to show here.

test/tables.jats_archiving−226

This diff is too big to show here.

test/tables.jats_articleauthoring−226

This diff is too big to show here.

test/tables.jats_publishing−226

This diff is too big to show here.

test/tables.jira−43

This diff is too big to show here.

test/tables.latex−134

This diff is too big to show here.

test/tables.ms−311

This diff is too big to show here.

test/tables.muse−59

This diff is too big to show here.

test/tables.native−293

This diff is too big to show here.

test/tables.org−51

This diff is too big to show here.

test/tables.rst−82

This diff is too big to show here.

test/tables.xwiki−45

This diff is too big to show here.

test/tables.zimwiki−55

This diff is too big to show here.

test/tables/nordics.html4−59

This diff is too big to show here.

test/tables/nordics.html5−59

This diff is too big to show here.

test/tables/nordics.jats_archiving−58

This diff is too big to show here.

test/tables/nordics.latex−42

This diff is too big to show here.

test/tables/nordics.native−73

This diff is too big to show here.

test/tables/planets.html4−133

This diff is too big to show here.

test/tables/planets.html5−133

This diff is too big to show here.

test/tables/planets.jats_archiving−128

This diff is too big to show here.

test/tables/planets.latex−30

This diff is too big to show here.

test/tables/planets.native−241

This diff is too big to show here.

test/tables/students.html4−55

This diff is too big to show here.

test/tables/students.html5−55

This diff is too big to show here.

test/tables/students.jats_archiving−56

This diff is too big to show here.

test/tables/students.latex−31

This diff is too big to show here.

test/tables/students.native−54

This diff is too big to show here.

test/test-pandoc.hs−118

This diff is too big to show here.

test/tikiwiki-reader.native−212

This diff is too big to show here.

test/tikiwiki-reader.tikiwiki−148

This diff is too big to show here.

test/vimwiki-reader.native−449

This diff is too big to show here.

test/vimwiki-reader.wiki−435

This diff is too big to show here.

test/writer.asciidoctor−649

This diff is too big to show here.

test/writer.custom−782

This diff is too big to show here.

test/writer.docbook4−1422

This diff is too big to show here.

test/writer.docbook5−1398

This diff is too big to show here.

test/writer.fb2−758

This diff is too big to show here.

test/writer.html5−684

This diff is too big to show here.

test/writer.jats_archiving−902

This diff is too big to show here.

test/writer.jats_articleauthoring−874

This diff is too big to show here.

test/writer.jats_publishing−902

This diff is too big to show here.

test/writer.jira−537

This diff is too big to show here.

test/writer.ms−1011

This diff is too big to show here.

test/writer.muse−722

This diff is too big to show here.

test/writer.opendocument−1924

This diff is too big to show here.

test/writer.xwiki−650

This diff is too big to show here.

tests/Tests/Arbitrary.hs+194

This diff is too big to show here.

tests/Tests/Helpers.hs+85

This diff is too big to show here.

tests/Tests/Old.hs+281

This diff is too big to show here.

tests/Tests/Readers/Docx.hs+53−192

This diff is too big to show here.

tests/Tests/Readers/EPUB.hs+37

This diff is too big to show here.

tests/Tests/Readers/HTML.hs+30

This diff is too big to show here.

tests/Tests/Readers/LaTeX.hs+21−224

This diff is too big to show here.

tests/Tests/Readers/Markdown.hs+54−136

This diff is too big to show here.

tests/Tests/Readers/Odt.hs+32−52

This diff is too big to show here.

tests/Tests/Readers/Org.hs+1552

This diff is too big to show here.

tests/Tests/Readers/RST.hs+44−91

This diff is too big to show here.

tests/Tests/Readers/Txt2Tags.hs+72−107

This diff is too big to show here.

tests/Tests/Shared.hs+60

This diff is too big to show here.

tests/Tests/Walk.hs+46

This diff is too big to show here.

tests/Tests/Writers/AsciiDoc.hs+17−25

This diff is too big to show here.

tests/Tests/Writers/ConTeXt.hs+70

This diff is too big to show here.

tests/Tests/Writers/Docbook.hs+7−184

This diff is too big to show here.

tests/Tests/Writers/Docx.hs+132

This diff is too big to show here.

tests/Tests/Writers/HTML.hs+43

This diff is too big to show here.

tests/Tests/Writers/LaTeX.hs+79

This diff is too big to show here.

tests/Tests/Writers/Markdown.hs+127

This diff is too big to show here.

tests/Tests/Writers/Native.hs+21

This diff is too big to show here.

tests/Tests/Writers/Plain.hs+7−9

This diff is too big to show here.

tests/Tests/Writers/RST.hs+109

This diff is too big to show here.

tests/Tests/Writers/TEI.hs+8−8

This diff is too big to show here.

tests/bodybg.gif

This diff is too big to show here.

tests/docbook-reader.docbook+2−39

This diff is too big to show here.

tests/docbook-reader.native+107−293

This diff is too big to show here.

tests/docbook-xref.docbook

This diff is too big to show here.

tests/docbook-xref.native+4−4

This diff is too big to show here.

tests/docx/adjacent_links.docx

This diff is too big to show here.

tests/docx/adjacent_links.native+1

This diff is too big to show here.

tests/docx/already_auto_ident.docx

This diff is too big to show here.

tests/docx/already_auto_ident.native

This diff is too big to show here.

tests/docx/block_quotes.docx

This diff is too big to show here.

tests/docx/block_quotes_parse_indent.native

This diff is too big to show here.

tests/docx/char_styles.docx

This diff is too big to show here.

tests/docx/char_styles.native

This diff is too big to show here.

tests/docx/codeblock.docx

This diff is too big to show here.

tests/docx/codeblock.native

This diff is too big to show here.

tests/docx/comments.docx

This diff is too big to show here.

tests/docx/comments.native

This diff is too big to show here.

tests/docx/comments_no_comments.native

This diff is too big to show here.

tests/docx/comments_warning.docx

This diff is too big to show here.

tests/docx/deep_normalize.docx

This diff is too big to show here.

tests/docx/deep_normalize.native

This diff is too big to show here.

tests/docx/definition_list.docx

This diff is too big to show here.

tests/docx/definition_list.native

This diff is too big to show here.

tests/docx/drop_cap.docx

This diff is too big to show here.

tests/docx/drop_cap.native

This diff is too big to show here.

tests/docx/dummy_item_after_list_item.docx

This diff is too big to show here.

tests/docx/dummy_item_after_list_item.native

This diff is too big to show here.

tests/docx/dummy_item_after_paragraph.docx

This diff is too big to show here.

tests/docx/dummy_item_after_paragraph.native

This diff is too big to show here.

tests/docx/enumerated_headings.docx

This diff is too big to show here.

tests/docx/enumerated_headings.native

This diff is too big to show here.

tests/docx/german_styled_lists.docx

This diff is too big to show here.

tests/docx/german_styled_lists.native

This diff is too big to show here.

tests/docx/hanging_indent.docx

This diff is too big to show here.

tests/docx/hanging_indent.native

This diff is too big to show here.

tests/docx/headers.docx

This diff is too big to show here.

tests/docx/headers.native

This diff is too big to show here.

tests/docx/i18n_blocks.docx

This diff is too big to show here.

tests/docx/i18n_blocks.native

This diff is too big to show here.

tests/docx/image.docx

This diff is too big to show here.

tests/docx/image_no_embed.native+2

This diff is too big to show here.

tests/docx/image_no_embed_writer.native+2

This diff is too big to show here.

tests/docx/image_vml.docx

This diff is too big to show here.

tests/docx/image_vml.native

This diff is too big to show here.

tests/docx/inline_code.docx

This diff is too big to show here.

tests/docx/inline_code.native

This diff is too big to show here.

tests/docx/inline_formatting.docx

This diff is too big to show here.

tests/docx/inline_formatting.native+1−2

This diff is too big to show here.

tests/docx/inline_formatting_writer.native

This diff is too big to show here.

tests/docx/inline_images.docx

This diff is too big to show here.

tests/docx/inline_images.native+2

This diff is too big to show here.

tests/docx/inline_images_writer.native

This diff is too big to show here.

tests/docx/link_in_notes.docx

This diff is too big to show here.

tests/docx/link_in_notes.native

This diff is too big to show here.

tests/docx/links.docx

This diff is too big to show here.

tests/docx/links.native

This diff is too big to show here.

tests/docx/links_writer.native

This diff is too big to show here.

tests/docx/lists.docx

This diff is too big to show here.

tests/docx/lists.native+1−1

This diff is too big to show here.

tests/docx/lists_writer.native

This diff is too big to show here.

tests/docx/metadata.docx

This diff is too big to show here.

tests/docx/metadata.native

This diff is too big to show here.

tests/docx/metadata_after_normal.docx

This diff is too big to show here.

tests/docx/metadata_after_normal.native

This diff is too big to show here.

tests/docx/normalize.docx

This diff is too big to show here.

tests/docx/normalize.native

This diff is too big to show here.

tests/docx/notes.docx

This diff is too big to show here.

tests/docx/notes.native

This diff is too big to show here.

tests/docx/numbered_header.docx

This diff is too big to show here.

tests/docx/numbered_header.native

This diff is too big to show here.

tests/docx/special_punctuation.docx

This diff is too big to show here.

tests/docx/special_punctuation.native

This diff is too big to show here.

tests/docx/table_with_list_cell.docx

This diff is too big to show here.

tests/docx/table_with_list_cell.native+11

This diff is too big to show here.

tests/docx/tables.docx

This diff is too big to show here.

tests/docx/tables.native+34

This diff is too big to show here.

tests/docx/tabs.docx

This diff is too big to show here.

tests/docx/tabs.native

This diff is too big to show here.

tests/docx/track_changes_deletion.docx

This diff is too big to show here.

tests/docx/track_changes_deletion_accept.native

This diff is too big to show here.

tests/docx/track_changes_deletion_all.native

This diff is too big to show here.

tests/docx/track_changes_deletion_reject.native

This diff is too big to show here.

tests/docx/track_changes_insertion.docx

This diff is too big to show here.

tests/docx/track_changes_insertion_accept.native

This diff is too big to show here.

tests/docx/track_changes_insertion_all.native

This diff is too big to show here.

tests/docx/track_changes_insertion_reject.native

This diff is too big to show here.

tests/docx/track_changes_move.docx

This diff is too big to show here.

tests/docx/track_changes_move_accept.native

This diff is too big to show here.

tests/docx/track_changes_move_all.native

This diff is too big to show here.

tests/docx/track_changes_move_reject.native

This diff is too big to show here.

tests/docx/trailing_spaces_in_formatting.docx

This diff is too big to show here.

tests/docx/trailing_spaces_in_formatting.native

This diff is too big to show here.

tests/docx/unicode.docx

This diff is too big to show here.

tests/docx/unicode.native

This diff is too big to show here.

tests/docx/verbatim_subsuper.docx

This diff is too big to show here.

tests/docx/verbatim_subsuper.native

This diff is too big to show here.

tests/dokuwiki_external_images.dokuwiki+1−1

This diff is too big to show here.

tests/dokuwiki_external_images.native

This diff is too big to show here.

tests/dokuwiki_inline_formatting.dokuwiki

This diff is too big to show here.

tests/dokuwiki_inline_formatting.native

This diff is too big to show here.

tests/dokuwiki_multiblock_table.dokuwiki+4

This diff is too big to show here.

tests/dokuwiki_multiblock_table.native+13

This diff is too big to show here.

tests/epub/features.epub

This diff is too big to show here.

tests/epub/features.native+3−4

This diff is too big to show here.

tests/epub/formatting.epub

This diff is too big to show here.

tests/epub/formatting.native

This diff is too big to show here.

tests/epub/img.epub

This diff is too big to show here.

tests/epub/wasteland.epub

This diff is too big to show here.

tests/epub/wasteland.native+941

This diff is too big to show here.

tests/fb2/basic.fb2+2

This diff is too big to show here.

tests/fb2/basic.markdown

This diff is too big to show here.

tests/fb2/images-embedded.fb2+2

This diff is too big to show here.

tests/fb2/images-embedded.html

This diff is too big to show here.

tests/fb2/images.fb2+2

This diff is too big to show here.

tests/fb2/images.markdown

This diff is too big to show here.

tests/fb2/math.fb2+2

This diff is too big to show here.

tests/fb2/math.markdown

This diff is too big to show here.

tests/fb2/test-small.png

This diff is too big to show here.

tests/fb2/test.jpg

This diff is too big to show here.

tests/fb2/titles.fb2+2

This diff is too big to show here.

tests/fb2/titles.markdown+10

This diff is too big to show here.

tests/haddock-reader.haddock

This diff is too big to show here.

tests/haddock-reader.native

This diff is too big to show here.

tests/html-reader.html−82

This diff is too big to show here.

tests/html-reader.native+123−497

This diff is too big to show here.

tests/insert

This diff is too big to show here.

tests/lalune.jpg

This diff is too big to show here.

tests/latex-reader.latex+10−4

This diff is too big to show here.

tests/latex-reader.native+27−68

This diff is too big to show here.

tests/lhs-test-markdown.native+1−1

This diff is too big to show here.

tests/lhs-test.fragment.html+lhs

This diff is too big to show here.

tests/lhs-test.html+63

This diff is too big to show here.

tests/lhs-test.html+lhs+63

This diff is too big to show here.

tests/lhs-test.latex+118

This diff is too big to show here.

tests/lhs-test.latex+lhs+80

This diff is too big to show here.

tests/lhs-test.markdown+1−1

This diff is too big to show here.

tests/lhs-test.markdown+lhs

This diff is too big to show here.

tests/lhs-test.native+1−1

This diff is too big to show here.

tests/lhs-test.rst+5−5

This diff is too big to show here.

tests/lhs-test.rst+lhs+2−2

This diff is too big to show here.

tests/markdown-citations.native+17

This diff is too big to show here.

tests/markdown-citations.txt

This diff is too big to show here.

tests/markdown-reader-more.native+166

This diff is too big to show here.

tests/markdown-reader-more.txt+6−37

This diff is too big to show here.

tests/media/rId25.jpg

This diff is too big to show here.

tests/media/rId26.jpg

This diff is too big to show here.

tests/media/rId27.jpg

This diff is too big to show here.

tests/mediawiki-reader.native+85−241

This diff is too big to show here.

tests/mediawiki-reader.wiki

This diff is too big to show here.

tests/movie.jpg

This diff is too big to show here.

tests/odt/markdown/bold.md

This diff is too big to show here.

tests/odt/markdown/citation.md

This diff is too big to show here.

tests/odt/markdown/endnote.md

This diff is too big to show here.

tests/odt/markdown/externalLink.md

This diff is too big to show here.

tests/odt/markdown/footnote.md

This diff is too big to show here.

tests/odt/markdown/headers.md

This diff is too big to show here.

tests/odt/markdown/horizontalRule.md

This diff is too big to show here.

tests/odt/markdown/image.md

This diff is too big to show here.

tests/odt/markdown/imageIndex.md

This diff is too big to show here.

tests/odt/markdown/imageWithCaption.md

This diff is too big to show here.

tests/odt/markdown/italic.md

This diff is too big to show here.

tests/odt/markdown/listBlocks.md

This diff is too big to show here.

tests/odt/markdown/paragraph.md

This diff is too big to show here.

tests/odt/markdown/strikeout.md

This diff is too big to show here.

tests/odt/markdown/trackedChanges.md

This diff is too big to show here.

tests/odt/markdown/underlined.md

This diff is too big to show here.

tests/odt/native/blockquote.native

This diff is too big to show here.

tests/odt/native/orderedListMixed.native+1−1

This diff is too big to show here.

tests/odt/native/orderedListRoman.native+1−1

This diff is too big to show here.

tests/odt/native/orderedListSimple.native+1−1

This diff is too big to show here.

tests/odt/native/referenceToChapter.native

This diff is too big to show here.

tests/odt/native/referenceToListItem.native

This diff is too big to show here.

tests/odt/native/referenceToText.native+1−1

This diff is too big to show here.

tests/odt/native/simpleTable.native+1

This diff is too big to show here.

tests/odt/native/unicode.native

This diff is too big to show here.

tests/odt/native/unorderedList.native

This diff is too big to show here.

tests/odt/odt/blockquote.odt

This diff is too big to show here.

tests/odt/odt/bold.odt

This diff is too big to show here.

tests/odt/odt/citation.odt

This diff is too big to show here.

tests/odt/odt/endnote.odt

This diff is too big to show here.

tests/odt/odt/expression.odt

This diff is too big to show here.

tests/odt/odt/expressionUnevaluated.odt

This diff is too big to show here.

tests/odt/odt/externalLink.odt

This diff is too big to show here.

tests/odt/odt/footnote.odt

This diff is too big to show here.

tests/odt/odt/formula.odt

This diff is too big to show here.

tests/odt/odt/headers.odt

This diff is too big to show here.

tests/odt/odt/hiddenTextByStyle.odt

This diff is too big to show here.

tests/odt/odt/hiddenTextByVariable.odt

This diff is too big to show here.

tests/odt/odt/horizontalRule.odt

This diff is too big to show here.

tests/odt/odt/image.odt

This diff is too big to show here.

tests/odt/odt/imageIndex.odt

This diff is too big to show here.

tests/odt/odt/imageWithCaption.odt

This diff is too big to show here.

tests/odt/odt/italic.odt

This diff is too big to show here.

tests/odt/odt/listBlocks.odt

This diff is too big to show here.

tests/odt/odt/orderedListMixed.odt

This diff is too big to show here.

tests/odt/odt/orderedListRoman.odt

This diff is too big to show here.

tests/odt/odt/orderedListSimple.odt

This diff is too big to show here.

tests/odt/odt/paragraph.odt

This diff is too big to show here.

tests/odt/odt/referenceAllInOne.odt

This diff is too big to show here.

tests/odt/odt/referenceToChapter.odt

This diff is too big to show here.

tests/odt/odt/referenceToListItem.odt

This diff is too big to show here.

tests/odt/odt/referenceToText.odt

This diff is too big to show here.

tests/odt/odt/simpleTable.odt

This diff is too big to show here.

tests/odt/odt/strikeout.odt

This diff is too big to show here.

tests/odt/odt/table.odt

This diff is too big to show here.

tests/odt/odt/tableWithCaption.odt

This diff is too big to show here.

tests/odt/odt/trackedChanges.odt

This diff is too big to show here.

tests/odt/odt/underlined.odt

This diff is too big to show here.

tests/odt/odt/unicode.odt

This diff is too big to show here.

tests/odt/odt/unorderedList.odt

This diff is too big to show here.

tests/odt/odt/variable.odt

This diff is too big to show here.

tests/opml-reader.native

This diff is too big to show here.

tests/opml-reader.opml

This diff is too big to show here.

tests/pipe-tables.native+115

This diff is too big to show here.

tests/pipe-tables.txt

This diff is too big to show here.

tests/rst-reader.native+81−190

This diff is too big to show here.

tests/rst-reader.rst+1−27

This diff is too big to show here.

tests/s5-basic.html+2−10

This diff is too big to show here.

tests/s5-fancy.html+257

This diff is too big to show here.

tests/s5-fragment.html

This diff is too big to show here.

tests/s5-inserts.html+1−9

This diff is too big to show here.

tests/s5.native

This diff is too big to show here.

tests/tables-rstsubset.native+117

This diff is too big to show here.

tests/tables.asciidoc+67

This diff is too big to show here.

tests/tables.context+175

This diff is too big to show here.

tests/tables.docbook+7−7

This diff is too big to show here.

tests/tables.docbook5+7−7

This diff is too big to show here.

tests/tables.dokuwiki+5−4

This diff is too big to show here.

tests/tables.fb2+2

This diff is too big to show here.

tests/tables.haddock+76

This diff is too big to show here.

tests/tables.html+10−10

This diff is too big to show here.

tests/tables.icml+8−8

This diff is too big to show here.

tests/tables.latex+168

This diff is too big to show here.

tests/tables.man+7−7

This diff is too big to show here.

tests/tables.markdown+2

This diff is too big to show here.

tests/tables.mediawiki+8−7

This diff is too big to show here.

tests/tables.native+114

This diff is too big to show here.

tests/tables.opendocument+101−101

This diff is too big to show here.

tests/tables.org+51

This diff is too big to show here.

tests/tables.plain+6−4

This diff is too big to show here.

tests/tables.rst+90

This diff is too big to show here.

tests/tables.rtf+12−12

This diff is too big to show here.

tests/tables.tei+15−3

This diff is too big to show here.

tests/tables.texinfo+3−3

This diff is too big to show here.

tests/tables.textile+4−3

This diff is too big to show here.

tests/tables.txt+1

This diff is too big to show here.

tests/tables.zimwiki+56

This diff is too big to show here.

tests/test-pandoc.hs+67

This diff is too big to show here.

tests/testsuite.native+8−6

This diff is too big to show here.

tests/testsuite.txt+8−3

This diff is too big to show here.

tests/textile-reader.native+45−112

This diff is too big to show here.

tests/textile-reader.textile+2−3

This diff is too big to show here.

tests/twiki-reader.native+34−110

This diff is too big to show here.

tests/twiki-reader.twiki

This diff is too big to show here.

tests/txt2tags.native+245−661

This diff is too big to show here.

tests/txt2tags.t2t+2−2

This diff is too big to show here.

tests/writer.asciidoc+157−112

This diff is too big to show here.

tests/writer.context+102−125

This diff is too big to show here.

tests/writer.docbook+1422

This diff is too big to show here.

tests/writer.docbook5+1395

This diff is too big to show here.

tests/writer.dokuwiki+7−14

This diff is too big to show here.

tests/writer.fb2+2

This diff is too big to show here.

tests/writer.haddock+11−8

This diff is too big to show here.

tests/writer.html+16−152

This diff is too big to show here.

tests/writer.icml+231−120

This diff is too big to show here.

tests/writer.latex+94−126

This diff is too big to show here.

tests/writer.man+165−124

This diff is too big to show here.

tests/writer.markdown+94−109

This diff is too big to show here.

tests/writer.mediawiki+20−12

This diff is too big to show here.

tests/writer.native+8−6

This diff is too big to show here.

tests/writer.opendocument+1620

This diff is too big to show here.

tests/writer.opml+13−13

This diff is too big to show here.

tests/writer.org+236−206

This diff is too big to show here.

tests/writer.plain+96−38

This diff is too big to show here.

tests/writer.rst+143−87

This diff is too big to show here.

tests/writer.rtf+9−1

This diff is too big to show here.

tests/writer.tei+35−33

This diff is too big to show here.

tests/writer.texinfo+26−11

This diff is too big to show here.

tests/writer.textile+13−9

This diff is too big to show here.

tests/writer.zimwiki+104−96

This diff is too big to show here.

tests/writers-lang-and-dir.context+18−35

This diff is too big to show here.

tests/writers-lang-and-dir.latex+57−69

This diff is too big to show here.

tests/writers-lang-and-dir.native

This diff is too big to show here.

tools/build-arm.sh−110

This diff is too big to show here.

tools/changelog-helper.sh−30

This diff is too big to show here.

tools/changes_template.html−6

This diff is too big to show here.

tools/diff-zip.sh−33

This diff is too big to show here.

tools/extract-changes.hs−15

This diff is too big to show here.

tools/pandoc-template-mode.el−64

This diff is too big to show here.

tools/parseTimings.pl−33

This diff is too big to show here.

tools/update-readme.lua−28

This diff is too big to show here.

trypandoc/Makefile+2−2

This diff is too big to show here.

trypandoc/index.html+28−75

This diff is too big to show here.

trypandoc/trypandoc.hs+61−34

This diff is too big to show here.

windows/Makefile−10

This diff is too big to show here.

windows/Pandoc-en-us.wxl+2−2

This diff is too big to show here.

windows/make-windows-installer.bat+29

This diff is too big to show here.

windows/pandoc.wxs+7−5

This diff is too big to show here.

windows/stack.yaml+24

This diff is too big to show here.