gitbook使用指南-优雅的markdown

Gitbook的安装

node.js的安装

gitbook是一个基于Node.js的命令行工具,所以要先安装Node.js(下载地址:https://nodejs.org/en/,找到对应平台的版本安装即可)。

Node.js都会默认安装npm(node包管理工具),所以不需要单独安装npm,打开命令行,执行以下命令安装GitBook:

npm install -g gitbook-cli

如果提示npm不是内部会外部命令,可以cd到node.js的安装目录在执行或将npm的目录添加到系统变量path中。

编辑工具的安装

这里给大家介绍两个编辑工具:gitbook editer和typora

gitbook editor

这个编辑工具对新手来说是个不错的选择,它集成了gitbook,git,Markdown等功能,可以将书籍同步到gitbook.com网站和github。但是gitbook editor的注册和登录需要翻墙,而且这东西的官网进不去,所以还下不到。

这里给大家分享一下这个工具,会翻墙的可以尝试一下这个工具

https://pan.baidu.com/s/1LEf2b9QwIRNgsoXJVBV90g

提取码:vtpv

typora

这个工具是我目前在使用的,推荐这个也没有啥特别的原因,就是我自己感觉挺好用的

下载地址:https://www.typora.io/

直接进官网下载对应平台的版本就可以了

Gitbook的使用

创建笔记文件夹

在你想要的位置新建一个文件夹,然后打开命令行,cd到这个文件夹下。

接着执行以下命令

gitbook init

执行完后,文件夹里会多两个文件

image

README.md(书籍的介绍在这个文件里)

SUMMARY.md(书籍的目录结构在这里配置)

写目录

后面我介绍了一个生成目录的插件,所以不一定要自己弄目录,但这里还是说下怎么写

上面说到SUMMRAY.md文件就是整个文件夹的目录,写目录其实就是编辑这个文件,刚打开时这个文件里什么都没有,我先在给他编写一下:

image

在给大家看看源代码

# Summary

* [Introduction](README.md)
* [前言](readme.md)
* [第一章](part1/README.md)
    * [第一节](part1/1.md)
    * [第二节](part1/2.md)
    * [第三节](part1/3.md)
    * [第四节](part1/4.md)
* [第二章](part2/README.md)
* [第三章](part3/README.md)
* [第四章](part4/README.md)

大家可以复制源代码过去试一下

简单给大家说一下语法:中括号里是这个目录的名字,小括号里是路径。

写完目录后再次执行gitbook init Gitbook会查找SUMMARY.md中描述的目录和文件,如果没有则会创建。上面的目录运行后是这样的

image

写笔记

在这里给大家介绍一些typora比较常用的功能

各级标题

在typora中使用crtl + 1~6可以创建1-6级标题,1级最大,6级最小。同时typora的大纲会显示所有标题,如图:

image

表格

可以在段落--->表格中插入表格,或者按快捷键crtl+T

代码块

这个功能用的很频繁,可以在段落--->代码块中插入,也可以使用快捷键(```+空格)

专注模式和打字机模式

打字机模式就是让当前输入行保持在屏幕中间,专注模式就是输入行正常颜色,其他行变灰,可以在视图中打开

源代码模式

源代码模式就是展示Markdown的文件本来的样子,如图

这个模式会展示出Markdown文件的标识符

插入图片

这个不多说,在格式--->图像里,快捷键crtl+shift+i

插入链接

用两个尖括号括起来就行,如下:

<www.baidu.com>

更换主题

直接点主题就好,typora内置了6个主题,值得一提的是typora的主题是css格式,所以会css的小伙伴可以自己写主题,或者调整已有的主题

内容目录

就是你们在本文上面看到的那个目录,简单点说就是把大纲放到了文章里,在段落--->内容目录里可以找到(有标题时才能用)

常见的格式

就比如加粗,斜体,下划线什么的。在格式里有,快捷键如下:

我的使用方法

其实单个md文件可以存储很多笔记,我现在是把一块笔记存在一个md文件里,有一定规模后再装文件夹,然后放在gitbook中,再使用我介绍的插件生成目录。

插件的使用方法

在gitbook中有很多有用的插件,但是使用起来会有一点麻烦,这里给大家讲解一下怎么用。

gitbook的插件大部分都在npm上,可以访问npm官网查看搜索插件https://www.npmjs.com/

这里用一个自动生成目录的插件给大家介绍使用方法

名字叫:gitbook-plugin-summary

  1. 首先打开你笔记文件夹下的book.json文件,没有就自己创建一个

  2. 将以下代码复制进去

    {
      "plugins": ["summary"]
    }
    
    
  3. 打开命令行,在这个文件夹中执行命令gitbook install安装插件

  4. 执行命令gitbook serve然后在查看的时候就会发现,之前明明没有写目录,现在却有了目录

大家想要用别的插件可以直接去npm上找,都有使用方法的

生成电子书

写完后我们可以执行gitbook serve来预览这本书,执行后会把Markdown格式的文档转换为html格式,最后提示"Serving book on http://localhost:4000"此时用浏览器打开" http://localhost:4000"即可预览书本

如图:

image

执行完后你的笔记文件夹里会多一个_book文件夹,里面是转化后的html文件

笔记的同步

同步单个的md文件

对于单个的md文件,我建议同步到石墨文档,可以在网页版,桌面版,移动版三个版本上查看和编辑。操作方法就是打开然后带入就行了。当然,在博客上发布也不失为一种好的同步方法。

同步整个笔记文件

可以使用git同步到github,由于我对git不太熟悉,就不误导大家了,大家可以去网上找找

最后,这是我第一次写博客,而且我从接触gitbook到写完这篇博客只有短短三天,如果有哪里不对,请各位指正

作者:Broken故城
链接:https://www.jianshu.com/p/0388d8bb49a7
来源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容