【Day28】Git 版本控制 - GitBook 简介

今天来介绍一个酷东西:GitBook


图片取自 GitBook 官网

GitBook

GitBook 是一个可以用来写笔记、技术文件的平台,可以将笔记汇整成一本书(电子书的概念),免费而且没有使用上限,和 hackmd 的模式很像,但又多了一些 git 的概念。

GitBook 最基本发布的方式与 Git 没有太大的差异,而 GitBook 又是由 Node.js 所开发的,但是并不需要担心在使用上会不会太过困难,因为官方有提供线上或是电脑下载的版本,可以让你不用会 git 也可以操作,唯一需要学会的东西就是 Markdown 语法。

Markdown

什麽是 Markdown 语法?他是一种轻量级的标记式语言,使用易读易写的纯文字格式来编写文件,像是我们常使用的 Word 文件中的粗体、斜体、超连结、插入图片等等功能,都只要透过语法撰写就可以达到。

而且很多地方都有支援 Markdown 语法,像是 GitHub 在撰写 README.md、Reddit、HackMD 都有支援,所以当你撰写好一篇文章後,想要转移到其他平台上就不需要一段一段慢慢复制,只要 import 你的 Markdown 档案就可以了。

以下简单介绍一些 Markdown 的语法,以便我们下一篇文章可以更加了解!

标题

Markdown 支援两种写法:Setext 和 atx。

Setext 是用底线的形式,利用 =(最高阶标题)和 -(第二阶标题),任何数量的 =- 都可以达到一样效果。

This is an H1
===
This is an H2
---

Atx 则是在行首插入 1 到 6 个 # ,各对应到标题 1 到 6 阶,例如:

# This is an H1
## This is an H2
###### This is an H6

粗体、斜体、删除符号

这三种的写法如下:

**2021 iThome 铁人赛**
*2021 iThome 铁人赛*
~~2021 iThome 铁人赛~~

呈现的结果如下:

2021 iThome 铁人赛
2021 iThome 铁人赛
2021 iThome 铁人赛

插入程序码区块

要插入程序码区块只要使用 ``` 将文字的上下括起来就可以做到

    ```
    hi
    ```

引言

Markdown 中的引言是使用 > 来达成的,只要在要输入的文字前加上 > 就可以了

> 2021 iThome 铁人赛

2021 iThome 铁人赛

清单

没有顺序的清单可以使用 +、*、- 来达成

* 2021 iThome 铁人赛
+ 2021 iThome 铁人赛
- 2021 iThome 铁人赛
  • 2021 iThome 铁人赛
  • 2021 iThome 铁人赛
  • 2021 iThome 铁人赛

而有序清单的话,则是在文字前加上 1. 就可以了

1. 2021 iThome 铁人赛
2. 2021 iThome 铁人赛
3. 2021 iThome 铁人赛
  1. 2021 iThome 铁人赛
  2. 2021 iThome 铁人赛
  3. 2021 iThome 铁人赛

Todo list

Todo list 可以透过以下方式建立

- [x] Day 26 铁人文章
- [ ] Day 27 铁人文章
  • [x] Day 26 铁人文章
  • [ ] Day 27 铁人文章

超连结

[这里可以放一些文字](网址)

Markdown wiki


以上就是 Markdown 常使用到的一些语法,接下来就让我们实际透过这些语法来操作 GitBook 吧!

Reference

What is GitBook
Markdown wiki


<<:  you only look once - YOLO (2)

>>:  day28 等一下啦,会坏掉的/// Coroutine并发操作的重复请求

Day 15 K3S & Raspberry Pi

k3s 下载 安装 wget https://github.com/k3s-io/k3s/relea...

【Day16】TestBench 的撰写技巧

透过 Verilog 完成一个具有特定功能的电路後,并不代表你的工作已经完成了,TestBench...

[Day 8] 2D世界中的数学 (一)

今日目标 基本的数学函式库(向量与阵列) 要多少才够 从另一个角度看,我认为游戏中的从小小的让角色移...

打造你自己的 Hook ( Day19 )

在 Hook 概观 的文章中,曾经写过一个打造 Hook 的例子。复习一下,发现应该要修改命名为 u...

如何在 Angular 获取 URL 资讯

在实作里,很多时後我们会将一些必要资讯记录在网址上,直接在网址里就能得到我们要的讯息 不用再透过组件...