A pandoc filter which supports "include" files.
 
 
Go to file
Amy de Buitléir f71b3a97e5 unused 2023-05-19 20:29:31 +01:00
app initial commit 2023-03-14 10:05:10 +00:00
src/Text/Pandoc/Filters unused 2023-05-19 20:29:31 +01:00
test-files auto adjust image paths 2023-03-15 22:22:17 +00:00
.ghci initial commit 2023-03-14 10:04:42 +00:00
.gitignore package for hackage 2023-03-17 20:25:55 +00:00
CHANGELOG.md package for hackage 2023-03-17 20:57:01 +00:00
LICENSE Initial commit 2023-03-14 09:52:22 +00:00
README.md package for hackage 2023-03-17 20:57:01 +00:00
default.nix package for hackage 2023-03-17 20:25:55 +00:00
flake.lock package for hackage 2023-03-17 20:31:52 +00:00
flake.nix package for hackage 2023-03-17 20:24:03 +00:00
pandoc-include-plus.cabal package for hackage 2023-03-17 20:57:01 +00:00

README.md

pandoc-include-plus

A pandoc filter which supports "include" files. At the moment, only Markdown files can be included. However, I expect soon to be able to support all filetypes that Pandoc supports. If included files are not found, an error occurs. Included files can include other files, recursively. Paths to images are adjusted as needed to ensure that everything "just works".

To include files, list them in a code block with the include class. Here is an example in Markdown syntax.

```include
file1.md
file2.md
file3.md
```

You can also promote or demote headings in included files using the level keyword. In the example below, and level-1 headings in the file a.md will become level-2 headings, level2-headings become level-3 headings, and so on.

```{.include level="1"}
a.md
```

To demote headings, set level to a negative value. A heading that would be shifted below level 1 becomes a regular paragraph.