blob: 6df603288d62389b96bfcc2a89c95e6e64c2daa5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
|
---
author:
- John MacFarlane
date: 'November 21, 2021'
title: Creating Custom Pandoc Writers in Lua
---
# Introduction
If you need to render a format not already handled by pandoc,
or you want to change how pandoc renders a format,
you can create a custom writer using the [Lua] language.
Pandoc has a built-in Lua interpreter, so you needn't
install any additional software to do this.
[Lua]: https://www.lua.org
A custom writer is a Lua file that defines functions for
rendering each element of a pandoc AST.
For example,
``` lua
function Para(s)
return "<paragraph>" .. s .. "</paragraph>"
end
```
The best way to go about creating a custom writer is to modify
the example that comes with pandoc. To get the example, you
can do
```
pandoc --print-default-data-file sample.lua > sample.lua
```
# A custom HTML writer
`sample.lua` is a full-features HTML writer, with explanatory
comments. To use it, just use the path to the custom writer as
the writer name:
```
pandoc -t sample.lua myfile.md
```
`sample.lua` defines all the functions needed by any custom
writer, so you can design your own custom writer by modifying
the functions in `sample.lua` according to your needs.
``` {.lua include="sample.lua"}
```
|
