Effortless export from github wiki (?)

Question

I am collecting quite a lot of material in a GitHub wiki. I really like to use the wiki to cooperate with other people and IMHO the platform is really nice, I like it!

S

Answer 1

I'm adding to this answer, in case it helps any new readers :) here's what I did:

I installed GitHub Desktop: https://desktop.github.com/

Then, on the wiki page in my repository, I clicked "Clone in Desktop"

This saved the wiki locally as a .md file (after following the steps on screen)

I then used http://www.markdowntopdf.com/ to convert it to pdf (Note: I renamed the files to remove characters that wouldn't work in a pdf file name before uploading to the website)

The end result was really nice.

Answer 2

But... the Github wiki of a GitHub repo is a git repo in itself (introduced in August 2010).

You can clone it, push to it or pull from it.

Each wiki is a Git repository, so you're able to push and pull them like anything else.
Each wiki respects the same permissions as the source repository.
Just add ".wiki" to any repository name in the URL, and you're ready to go.

That makes the "export" part of your question really trivial.

From there, you will find tons of script for converting markdown pages into pdf:

• a graddle task
• a makefile
• a python script
• ...

Answer 3

I've accomplished precisely this when creating the portable documentation for Barcode Writer in Pure PostScript:

GitHub Wiki + Makefile + pandoc → PDF

The process is described in this blog post.

Answer 4

I found really annoying having to convert each markdown document separately (links between markdown documents are lost), so I ended up writting a simple C# program for my own use that does this in a single step: a) Download the last version of the wiki from Github, b) Convert it all the markdown documents merged as one pdf

You can download the binaries (Windows or any platform supporting Mono) from: https://github.com/borjafdezgauna/CoderDocTools/releases/latest

If, for example, you want to convert to PDF the SimionZoo repository by user simionsoft, you can:

MarkdownToPDF.exe user=simionsoft project=SimionZoo output-file=SimionZoo.pdf

Answer 5

You can also try html_links_to_pdf!

It's a Python 3 script made just to convert a GitHub Wiki to pdf form, using the same styling that GitHub uses, but slightly cleaner.

Answer 6

Another option once you clone the wiki, especially if you are already using Atom is to use this Markdown to PDF package. Worked great for me.