Mirroring to GitHub

February 3, 2016

If you want to export or mirror your hosted microblog site, you can have it automatically publish to a GitHub repository every time you make a change. Both the generated HTML and the source Markdown and Jekyll files will be exported. This is useful as a way to migrate your content out of Micro.blog, or to use GitHub Pages as the primary host for your content.

To configure, you’ll need to create a new repository on GitHub. For compatibility with GitHub Pages, it should be in the format username/username.github.io (or organization/organization.github.io). You’ll also need to create an access token on GitHub (under Settings → “Personal access tokens”) to grant access to Micro.blog. Make sure the “repo” scope is checked when creating the access token on GitHub.

You can set the GitHub repository and access token in Micro.blog under Account → “Edit Domains & Design”. Remember the repository must include your username or organization name as well as the repository name.