Connect a GitHub repo as a source for your articles

Hey everyone 👋

A few days back our community member Simon Høiberg created the following feature request:

It would be amazing if we could connect a GitHub repository with our articles in markdown files.

This allows us to:

Write our articles in our favorite editor, e.g. Visual Studio Code Update our articles when we push to master branch (or a branch of choice) Enables us to create branches, do PRs and reviews.

For example, I would love to use Hashnode to do release notes and articles on behalf of my Open-Source projects and my company. Since we are multiple people working on these, it would be nice for us to do PRs and code reviews, like we do anything else.

Additionally, this also enables us to do "batch" updates of articles. Sometimes we need to do a simple "search and replace" throughout multiple articles, and this feature would allow us to update a series of articles by virtue of updating the repository.

We thought it's really interesting and started working on it. Today I am happy to announce that you can now connect a GitHub repository as a source for your Hashnode articles. This means you can use your favorite editor to write your article and as soon as you commit it on your GitHub repo it gets published on Hashnode automatically! 🙌

This feature is in private beta and currently available to Hashnode Ambassadors.

Here is how you can enable this feature in two easy steps:

Step 1

Go to your dashboard and visit integrations tab. Click on "Connect Hashnode app on GitHub" button:

Screenshot 2020-10-09 at 10.05.39 PM.png

Once you click on it, you will be redirected to GitHub. You need to install our GitHub app on one of your repos which will house the articles.

Step 2

Now go to your repo where you have installed our GitHub app and create a new .md file. You can name it anything. The content of the file should be in the following format.

---
title: YOUR_TITLE_HERE
slug: CUSTOM_SLUG_HERE
tags: TAG_SLUG_1, TAG_SLUG_2
cover: COVER_IMAGE_URL
domain: YOUR_DOMAIN_NAME_HERE (e.g. sandeep.dev or sandeep.hashnode.dev)
---
Enter article body here

Once you commit, the article gets published on your Hashnode blog automatically.

Just note the following:

  • To use images in your posts, you will have to first upload them using Hashnode uploader. You can then copy the URL and use it in your article.

  • Posts sourced from GitHub can't be edited on Hashnode. You need to edit the files on GitHub and we sync automatically.


This feature is in private beta. We would love to have your feedback and improve further before releasing it to everyone. 🙌

Corey O'Donnell's photo

Awesome feature.

It can help make post automation so much easier.

Shubham Verma's photo

Hey Sandeep Panda, Will it be possible to add Series Name in the markdown front matter?

Pavel's photo

Awesome. As I read hashnode's article a few week ago about connecting with GraphQL, I though of this and how it can be done and now you implemented it.

Thanks Sandeep Panda, Simon Høiberg and Hashnode.

Abhas Bhattacharya's photo

Ok, how does it work with Github backup, if I have that set up currently? Can i directly connect to same repo? Or stop backup (because it won't make sense after this) first and then add same repo as source?