I was working on my last project, when I had to deal with the ReadMe file of the GitHub repository. That project should be a kind of data structure for environmental modeling purposes, and in scientific fields you always have to cite papers, reports and things like those.
However a simple ReadMe.md is not built or parsed by anything, then a problem rises: should I have to write the biblioraphy (or references) by hand, typing each single character? Naaaaaa, I’m too lazy for that.
What’s the solution? Pandoc!
From Wiki, Pandoc is an open-source document converter, widely used as a writing tool, it can export many many different types of formats and, while parsing the source text, it can easily generate the bibliography from your
To get a working tools, you should install:
The trick is add the citation between square brackets and after the at
@ symbol in the following way:
.rst file just generated is parsable by GitHub, and it is the one you will push on the online repository…with the bibliography automatically generated!
What I strongly suggest is to add the title
## References at the end of your MarkDown text, because the bibliography is automatically added at the end of it.
Here the source code in MarkDown format as example:
And the parsed source file in
.bib file is available at https://github.com/sidereus3/LaTeX.