Consider the following markdown fragment:
Connecting these native implementations to the Python world is enabled
by the [Cython](http://cython.org/) toolchain [@behnel2011cython].
I use pandoc to convert from markdown to LaTeX:
pandoc --chapters ../Source/Chapters/Content.md -o ../Example/Chapters/Content.tex
This is converted to LaTeX and produces the following output:
Connecting these native implementations to the Python world is enabled
by the \href{http://cython.org/}{Cython} toolchain~
{[}@behnel2011cython{]}.
Why is the citation not handled appropriately? It should be easy to simply convert it to ~\cite{behnel2011cython}
. Did I forget to give pandoc some flag for this?
Best Answer
If you want to use citations, you also have to define the CSL-style (Citation Style Language) to be used, via a
*.csl
-file you have to reference.Here is an MWE in Markdown. It tests a few different methods to provide references to citations in Markdown:
You convert this Markdown with f.e. the following Pandoc command:
As you can see from the command, it references three files:
mwe.md
.stuttgart-media-university.csl
. (I downloaded it from the core repository, of citationstyles.org on GitHub.)The third one,
my-biblio.bib
, which holds my citation references. Its content is here:Here is a screenshot of the resulting PDF page:
Looking closely at that page, you can see how exactly each occurrence of Markdown source citational references translate into the final page layout.
Be aware, that the final page layout is heavily influenced by the specific CSL style file you use! Apply a different CSL, and the page content will look different (specifically: the spots with the references, the footnotes and the "Bibliography" section are all influenced by the CSL).