Converting other document formats into github markdown (jennybc#82)

* Converting other document formats into github markdown

Suggested a couple of paragraphs. Tested "For simpler conversions between the different markdown flavours supported by Pandoc (mmd, php_extra and strict), you can convert these to Github using the Rstudio gui by simply renaming their extension to .Rmd" does appear to be true.

* Changes from email
Changed to standard formatting for Rstudio, Word etc and .md etc
Added link to YAML frontmatter in book.

* Update 32_workflow-make-github-repo-browsable.Rmd

* just some typos in my text

* typos corrected
apologies. Had tried to do so in Github browser, but must've made a mistake.

* Changed link to internal link.

32_workflow-make-github-repo-browsable.Rmd

@@ -163,6 +163,24 @@ Examples:
 
 Hopefully we are moving towards a world where you can have "web friendly" and "vector" at the same time, without undue headaches. As of [October 2014](https://github.com/blog/1902-svg-viewing-diffing), GitHub provides enhanced viewing and diffing of SVGs. So don't read this advice as discouraging SVGs. Make them! But consider keeping a PNG around as emergency back up for now.
 
+## Other document formats
+
+You may also have a document you want others to be able to browse and interact with, but it is not in the markdown format. Fortunately, the open-source Pandoc program, written by John MacFarlane, allows you to convert a range of formats into markdown, including the widely used `.docx` format.
+
+When you click the Knit button in RStudio it is actually Pandoc which performs the final conversion to HTML or Microsoft Word (`.docx`) formats. If you are willing to use the command-line, you can perform the opposite conversion (eg `.docx` to `.md`), commonly retaining features such as headings, tables, equations and even figures.
+
+As some boilerplate, running in Windows PowerShell `pandoc --extract-media .\media  -f docx .\example.docx -t markdown_github -o example_image.md` converts a word document called `example.docx` to markdown, and extracts the images into a directory which corresponds to a filepath in the newly created `example.md` document. A full list of supported formats and example code for conversions are available at https://pandoc.org/.
+
+You can also perform simple conversions to GitHub-flavored markdown from different markdown flavours (Pandoc supports `markdown_mmd`, `markdown_php_extra` and `markdown_strict`) from within RStudio. To do so you need to rename the file by changing the extension (eg from `foo.md` to `foo.Rmd`), then open the renamed file in RStudio and add the following text to the top of the document.
+
+``` yaml
+---
+output: github_document
+---
+```
+
+You can then click on "Knit" then "Knit to github document" to perform the conversion. See  [Output format](## Output format) for more details of controlling output formats with the YAML frontmatter.
+
 ## Linking to a ZIP archive of your repo
 
 The browsability of GitHub makes your work accessible to people who care about your content but who don't (yet) use Git themselves. What if such a person wants all the files? Yes, there is a clickable "Download ZIP" button offered by GitHub. But what if you want a link to include in an email or other document? If you add `/archive/master.zip` *to the end* of the URL for your repo, you construct a link that will download a ZIP archive of your repository. Click here to try this out on a very small repo: