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
|
---
include-entry: '.'
listings: true
title: Test
date: \today{}
test:
adsf: a
base:
- b
- c
pandoc-options:
- --filter=pandoc-include
---
# Test
## Dollar signs in code
```
Console.WriteLine($"T");
Console.WriteLine($"T");
```
## Non-existent file
(Should give a warning)
!include not_exists.file
!include <not_exists>
## Included file list
* included-1.md
* included-r1.md
* included-r2.md
* included 2.tex
## Include header
!include-header included/header.yaml
## Included file
!include included/included-1.md
### A simple latex table
$include "included/included 2.tex"
## Include files
!include included/*.md
| Key | Value |
| --- | ----- |
| 1 | 2 |
| 2 | 4 |
## Include code
```cpp
!include 1.cpp
```
```py
!include `__test__.py`
```
```py
!include non-exist
```
## Include with options
### Delimiters
!include`snippetStart="|Start|", snippetEnd="|End|"` included/included-1.md
```cpp
!include`snippetStart="// Start", snippetEnd="// End"` 1.cpp
```
```cpp
!include`snippetStart="// Start"` 1.cpp
```
### Dedent
```cpp
!include`snippetStart="// Start", snippetEnd="// End", dedent=-1` 1.cpp
```
### Line Number
!include`startLine=1, endLine=5` included/included-1.md
## Doxygen/XSLT Example
A simple example showing how to include a doxygen XML output into the document
```
include`incrementSection=2, format="markdown", xslt="xslt/api.xslt"` xslt/doc/xml/main_8c.xml
```
!include`incrementSection=2, format="markdown", xslt="xslt/api.xslt"` xslt/doc/xml/main_8c.xml
|
