如何用 Github Issues 写技术博客？

> 本文由 [简悦 SimpRead](http://ksria.com/simpread/) 转码， 原文地址 [www.jianshu.com](https://www.jianshu.com/p/7c2cce028d29)

### 写在前头的话

记得还在大学的那会儿，第一次听见可以用 Github 搭建个人的博客（Jekyll + Github Page），花了好几天搭建起来一个博客。再后来，改用 Hexo + Github Page 搭建博客，发现自己很喜欢玩这些东西，但是却止于玩弄搭建好看功能齐全的博客，却很难用于技术沉淀的记录（这个应该和个人心态有关）。

我觉得，写技术博客，出发点无非是：

*   梳理自己的知识体系
*   通过博客与外界交流

发现在搭建自己博客的时候，经常会想着怎样提高阅读量，博客怎样才能有更强大的功能、好看的 UI ... 却无法集中精力进行技术总结.

有一天注意到，直接用 Github ，可以让我更加专心， ：）

### Github 上写博客

Github 提供了下面的功能：

*   Issues
*   Projects

我是这样做的：先在 Github 上创建一个博客专用的项目

![](http://upload-images.jianshu.io/upload_images/595838-4d31ce84b16b1389.png) QQ20170708-093151@2x.png

**步骤 1: 创建 Projects**

可以使用 Projects，建立个人的知识点类别

![](http://upload-images.jianshu.io/upload_images/595838-0a80c2af69446f28.png) project.png

进入创建好的分类，创建栏目

![](http://upload-images.jianshu.io/upload_images/595838-40bfa204c974bc1d.png) project-column.png

**步骤 2: 编写 Issues**

Issues 里面可以自己定义 Lables 标签，对编写的文章进行分类。支持 Markdown 语法。

![](http://upload-images.jianshu.io/upload_images/595838-c585c0d6f015d0d8.png) labels.png

![](http://upload-images.jianshu.io/upload_images/595838-c1237496c6e5e8f6.png) new lables.png

新建 Issues，并且选择对应的标签 Lables，分类 Projects

![](http://upload-images.jianshu.io/upload_images/595838-58cfff21b1170db5.png) Issues.png

**步骤 3：添加到 Projects 卡片**

打开对应的 projects，往专栏中添加新建的 Issues（点击 Add cards，直接拖拽）

![](http://upload-images.jianshu.io/upload_images/595838-6638d6f99d5f4435.png) add cards.png

**步骤 4: 项目的 README.md**

可以在 README.md 里面写一些简介，链接到具体的 Project 目录。

![](http://upload-images.jianshu.io/upload_images/595838-2fa4344e8ab9a818.png) homepage

### 我是这样整理知识体系

Evernote： 知识收集的仓库（使用浏览器剪辑的插件）  
Github Issues： 对遇到问题的整体解决思路进行梳理

发现，如果没有把 Evernote 的知识碎片整理成文，以后遇到同一个问题，就可能需要再次耗费精力在知识碎片中找。

现在 Github Issues 上会记录比较具体的解决问题过程，然后在 Github 上写的文章，我平时一般也会同步到简书上。

最后，附上我的 Github 博客地址，有兴趣的可以进去看下～  
[https://github.com/johnnian/Blog](https://link.jianshu.com?t=https://github.com/johnnian/Blog)