Support for this package is deprecated as of v0.6.0. Consider using
rehype-citation
instead.
remark-bibtex
is a remark plugin to generate footnoted citations from a bibtex
file. It uses citation-js
to load a specified .bib
file from which citations will be retrieved and added to the markdown file’s footnotes section.
The reason it exists is that when I created this blog, I found myself wanting to cite papers from my Mendeley library. As anyone who works with citations knows, they can be a beast to handle or format. A reference manager such as Mendeley makes our lives far more manageable because it becomes relatively painless to cite documents from latex
workflows. I wanted to reuse my existing .bib
files but from within the remark
markdown processing ecosystem of plugins, cue remark-bibtex
.
Citation keys take the form of (@citationKey)
: where “citationKey” corresponds to a bibtex entry in the provided .bib
file. The citation key will be replaced with a numbered footnote reference corresponding to the bibliography entry in the footnotes section. To work, this package has to be chained to the remark-footnotes
package, which adds the necessary markdown footnoting capability.
# My Document
So here is my citation (@Wasserman1994). End of story.
Will become:
So here is my citation[^1]. End of story.
[^1]: 1\. Wasserman S, Faust K. Social Network Analysis. Cambridge: Cambridge University Press; 1994.
And (Couclelis (1985)) ends (Berghauser Pont et al. (2019)) up (Batty (1997)) looking (Stewart et al. (2004)) like (Harris et al. (2020)) this (Wasserman & Faust (1994))! See the footnotes section below… (Nothing implied by the use of the example citations!)
See the remark-bibtex
repository for more information about use and configuration.