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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
# pandoc-plot
## A Pandoc filter to generate figures from code blocks in documents
[](https://www.gnu.org/licenses/gpl.html)
`pandoc-plot` turns code blocks present in your documents (Markdown, LaTeX, etc.) into embedded figures, using your plotting toolkit of choice, including Matplotlib, ggplot2, MATLAB, Mathematica, and more.
## Overview
This program is a [Pandoc](https://pandoc.org/) filter. It can therefore
be used in the middle of conversion from input format to output format,
replacing code blocks with figures.
The filter recognizes code blocks with classes that match plotting
toolkits. For example, using the `matplotlib` toolkit:
```` markdown
# My document
This is a paragraph.
```{.matplotlib}
import matplotlib.pyplot as plt
plt.figure()
plt.plot([0,1,2,3,4], [1,2,3,4,5])
plt.title('This is an example figure')
```
````
Putting the above in `input.md`, we can then generate the plot and embed
it in an HTML page:
``` bash
pandoc --filter pandoc-plot input.md --output output.html
```
The resulting `output.html` looks like this:
```html
<h1 id="my-document">My document</h1>
<p>This is a paragraph.</p>
<figure>
<img src="plots\9671478262050082276.png" />
</figure>
```
## Supported toolkits
`pandoc-plot` currently supports the following plotting toolkits
(**installed separately**):
- `matplotlib`: plots using the [matplotlib](https://matplotlib.org/)
Python library;
- `plotly_python` : plots using the
[plotly](https://plotly.com/python/) Python library;
- `plotly_r`: plots using the [plotly](https://plotly.com/r/) R
library
- `matlabplot`: plots using [MATLAB](https://www.mathworks.com/);
- `mathplot` : plots using
[Mathematica](https://www.wolfram.com/mathematica/);
- `octaveplot`: plots using [GNU
Octave](https://www.gnu.org/software/octave/);
- `ggplot2`: plots using [ggplot2](https://ggplot2.tidyverse.org/);
- `gnuplot`: plots using [gnuplot](http://www.gnuplot.info/);
- `graphviz`: graphs using [Graphviz](http://graphviz.org/);
- `bokeh`: plots using the [Bokeh](https://bokeh.org/) visualization library;
- `plotsjl`: plots using the [Julia `Plots.jl`](https://docs.juliaplots.org/latest/) package;
- `plantuml`: diagrams using the [PlantUML](https://plantuml.com/) software suite;
- `sageplot`: plots using the [Sage](https://www.sagemath.org/) software system.
- `d2`: plots using [D2](https://d2lang.com/).
To know which toolkits are useable on *your machine* (and which ones are
not available), you can check with the `toolkits` command:
``` bash
pandoc-plot toolkits
```
**Wish your plotting toolkit of choice was available? Please [raise an
issue](https://github.com/LaurentRDC/pandoc-plot/issues)\!**
## Documentation
You can find more information in the documentation, available either in the
source repository file `MANUAL.md`, on the [webpage](https://laurentrdc.github.io/pandoc-plot/MANUAL.html), or via the command `pandoc-plot --manual`.
## Installation
### Binaries and Installers
[](https://github.com/LaurentRDC/pandoc-plot/releases)
Windows, Linux, and Mac OS binaries are available on the [GitHub release
page](https://github.com/LaurentRDC/pandoc-plot/releases). There are
also Windows installers.
### conda
[](https://anaconda.org/conda-forge/pandoc-plot)
Like `pandoc`, `pandoc-plot` is available as a package installable with
[`conda`](https://docs.conda.io/en/latest/). [Click here to see the
package page](https://anaconda.org/conda-forge/pandoc-plot).
To install in the current environment:
``` sh
conda install -c conda-forge pandoc-plot
```
### Homebrew
[](https://formulae.brew.sh/formula/pandoc-plot)
`pandoc-plot` is available as a package via [`Homebrew`](https://brew.sh/). [Click here to see the package page](https://formulae.brew.sh/formula/pandoc-plot#default).
To install:
```sh
brew install pandoc-plot
```
### winget
You can install `pandoc-plot` from the [Windows Package
Manager](https://github.com/microsoft/winget-cli) `winget` (just like
`pandoc`). To install:
``` sh
winget install pandoc-plot
```
### Arch Linux
[](https://aur.archlinux.org/packages/pandoc-plot-bin/)
You can install `pandoc-plot` from the [archlinux user repository](https://aur.archlinux.org/packages/pandoc-plot-bin/) as `pandoc-plot-bin`. You can install using e.g. `yay`:
```sh
yay -S pandoc-plot-bin
```
### From Hackage/Stackage
[](http://hackage.haskell.org/package/pandoc-plot)
`pandoc-plot` is available on
[Hackage](http://hackage.haskell.org/package/pandoc-plot) and
[Stackage](https://www.stackage.org/nightly/package/pandoc-plot). Using
the [`cabal-install`](https://www.haskell.org/cabal/) tool:
``` bash
cabal update
cabal install
```
### From source
Building from source can be done using [`cabal`](https://www.haskell.org/cabal/):
``` bash
git clone https://github.com/LaurentRDC/pandoc-plot
cd pandoc-plot
cabal install # Alternatively, `stack install`
```
|
