33 lines
1.1 KiB
Markdown
33 lines
1.1 KiB
Markdown
# Referencing
|
||
|
||
Referencing is powered by `pandoc-citeproc`, so any format supported by it is supported. A list of supported formats can be found [here](https://github.com/jgm/pandoc-citeproc/blob/master/man/pandoc-citeproc.1.md).
|
||
|
||
__Remember__: To use YAML, your file must end `.yaml` rather than `.yml`!
|
||
|
||
## CSL Files
|
||
There are many different ways of referencing, both inline, and in a bibliography. `md-pdf` supports _all_ of them.
|
||
|
||
The configuration used for this is stored in `csl` files, which can be downloaded through `md-pdf`. See the usage instructions on how to download these.
|
||
|
||
There's a full list of available `csl` files [here](https://github.com/citation-style-language/styles/).
|
||
|
||
## Example
|
||
Assuming youre using the same bibliography as the example, an input of:
|
||
|
||
```markdown
|
||
@item1 says blah.
|
||
```
|
||
Will render as:
|
||
```
|
||
Doe (2005) says blah.
|
||
```
|
||
|
||
### Advanced Citation
|
||
You can also use more advanced referencing to be more specific:
|
||
```markdown
|
||
A citation group [see @item1 p. 34-35; also @item3 chap. 3].
|
||
```
|
||
will result in:
|
||
```
|
||
A citation group (see Doe 2005, 34–35; also Doe and Roe 2007, chap. 3)
|
||
```
|