How to create Markdown files

The submission process

What happens after you are done with writing the report is fairly standard in academic publishing. Namely:

• You will submit the report for review;
• it will receive at least 2 and likely 3 blind reviews,
• you will then get feedback along with additional editorial comments;
• you will revise it, and communicate with the editors until the revisions are finalized and approved.

The report will then be sent to production where it will be formatted like one of these.

You will be sent final page proofs to check for any errors, typos, etc. before the reports are published on the website.

Report contents

Check out the tech report section in this document: resources for presentations and reports

What to do with the bibliography and citations

We are flexible, but would be happy to have you help us format properly if that is possible.

Ultimately, we need your references in a bibtex file! If you’ve never heard of it, you can start with plain text and then obtain one online like this: copy and paste using the instructions on this site anystyle.io. For more information, please read this.

Note: in Markdown, your bibliography items will not appear in the formatted document unless you do the following things:

• save your bilbiography in a file called, for example, mybiblio.bib, formatted according to bibtex;
• add a line bibliography: mybiblio.bib at the preamble of this document; and
• actually cite the references in text;
• end your document with an empty ‘References’ section, as shown in this document. Markdown will then automatically format everything and place the bibliography at the right place, in the right order.

Luckily, citations in Markdown are super easy. For example, for a citation whose key is testCitation, which can be seen by looking at the bib file² which will say something like @article{testCitation,, you can cite it like this:

@testCitation says .... some quote. 
Also, for more information, see [@testCitation]. 
You can also say things like:  Dylan says [-@testCitation]...

The code above produces the following:

Peifer, Stillman, and Halpern-Leistner (2020) says …. some quote. Also, for more information, see (Peifer, Stillman, and Halpern-Leistner 2020). You can also say things like: Dylan says (2020)…

TIP: if you are having trouble or using an online editor, just include plain text bibliography manually within a References section. A production editor will do the final formatting.

Including figures

Figure 1: All figures must be numbered and have a caption stating what the figure is.

In order to include a figure, you should specify the path. You will need to submit all your figures figures with your report before publication! Save them in a folder, zip, and upload; or upload one by one, as supplementary files, on the site when you create your submission.

Note that the figure caption will not appear unless there is a blank line after the figure.

Requirement: you will need to submit all figures as separate .png, .jpg, or .pdf files. Please make sure to give filenames that are easy to call for an editor, for example, “Figure 1” file should be named something like “yourname.figure1.png” or “yourname.fig1.png” or simply “yourname.1.png” - no spaces please.

Including tables

Including code

Here is a code chunk. It does not specify what language the code is written in,
so it's not executed.

# here is an R code chunk
print("hello world")  

## [1] "hello world"