Github+Hexo+Next博客搭建之Markdown

博客已经搭建好了,自然可以趁热打铁写一些博客搭建的经验.一是方便自己以后查看,免得忘记.二是如果有人想了解博客搭建的过程,也正好有个参考.(如果SEO做的好,就有可能看到这篇文章).本文仅记录怎么去搭建博客,而不会解释每一步原理,有些东西我自己都没有搞的太清楚.毕竟我只是想借助博客这个平台记录平时工作的经验而已,细究相关方面知识并不是我的最终目的.

现在回头看博客的搭建过程,可以总结归纳以下几点. markdown,git和GitHub, github和coding部署, Hexo和Next了解, SEO

Markdown
工欲善其事,必先利其器.作为程序员,平时的编辑语言首选是markdown,markdown的使用其实很简单.之前除了整理一下文档外,平时倒是用的不多,在此整理一下

段落和换行

一个Markdown段落前后要有一个以上空行,普通段落不该用空行或制表符来缩进.段落内强迫换行可在插入处键入两个以上空格然后回车.

标题

markdown支持两种标题,类Setext和Atx形式.
类Atx形式是在行首插入1到6个#,分别对应1到6级标题,示例:

1
2
3
# 一级标题
## 二级标题
### 三级标题

区块引用

Markdown中建立区块引用,需在行首最前面加上>:

1
> 这是一个区块引用

效果展示:

这是一个区块引用

区块引用可以嵌套,只要根据层次加上不同数量的>:

1
2
3
> 这是顶层的
>> 这是二级引用
>>> 这是三级引用

效果展示:

这是顶层的

这是二级引用

这是三级引用

引用区块内可以使用其他Markdown语法,包括标题、列表、代码区块等:

1
2
3
4
5
6
7
> 列表
> 1. item1
> 2. item2
>
> 代码区块
>
> 这是一个代码区块

效果展示:

列表

  1. item1
  2. item2

代码区块

这是一个代码区块

列表

Markdown支持有序列表和无序列表.列表项目标记通常放在最左边,也可以缩进,最多3个空格,项目标记后面一定要接着至少一个空格或制表符.

列表项目可以包含多个段落,每个项目下的段落都必须缩进四个空格或是一个制表符:

1
2
3
4
5
6
* 这是第一段落
(空行)
(四个空格一个制表符)这是第二段落

* 这是第一段落(两个空格)
(四个空格一个制表符)这是第二段落

效果展示:

  • 这是第一段落.

    这是第二段落

  • 这是第一段落
    这是第二段落

列表项目内放进引用,引用需缩进四个空格或一个制表符:

1
2
* 列表项目内放进引用
(四个空格或一个制表符)> 这是引用一

效果展示:

  • 列表项目内放进引用

    这是引用一

列表项目内放进代码区块,该区块需缩进两次,八个空格或两个制表符:

1
2
3
* 列表项目内放进代码区块
(空行)
(八个空格或两个制表符)这是一个代码区块

效果展示:

  • 列表项目内放进代码区块

    这是一个代码区块
    

无序列表

无序列表使用星号(*)、加号(+)、减号(-)作为列表标记:

1
2
3
* item    + item    - item
* item + item - item
* item + item - item

效果展示:

  • item
  • item
  • item

有序列表

有序列表则是数字接着英文句点( 数字 + . ):

1
2
3
1. item
2. item
3. item

效果展示:

  1. item1
  2. item2
  3. item3

代码区块

Markdown中建立代码区块,需缩进四个空格或一个制表符:

1
2
3
这是一个普通段落:
(空行)
(八个空格或两个制表符)这是一个代码区块

效果展示:
这是一个普通段落:

这是一个代码区块

分割线

Markdown中的分隔线需三个以上的星号(*)、减号(-)、底线(_).也可以在星号或减号或底线中间插入空格,不影响效果.

1
2
3
4
****
-----
_______
**** ***** **********

效果展示:





链接

Markdown支持两种形式的链接语法: 行内式和参考式.链接文字都是用[]标记.

行内式

行内式链接:

1
这是一个行内式链接[链接文字](链接URL "链接标题")

效果展示:
这是一个行内式链接链接文字

参考式

1
2
3
4
参考式链接:
这是一个参考式链接[链接文字][链接辨别标签]
(空行)
[链接辨别标签]: 链接URL "链接标题"

效果展示:
这是一个参考式链接链接文字

链接内容定义形式:

  • 方括号(前面可以选择性加上至多三个空格缩进),里面输入链接文字
  • 接着一个冒号
  • 接着一个以上的空格或制表符
  • 接着链接的网址, 可以用尖括号包起来
  • 选择性接着title内容,可以是单引号、双引号或括号,可以放到下一行,也可以加一些缩进

链接辨别标签不区分大小写.

隐式链接标记

隐式链接标记可以省略制定链接标记,此时链接标记等同于链接文字:

1
2
3
这是一个隐式链接标记功能[隐式链接][]

[隐式链接]: 链接URL "隐式链接标题"

效果展示:
这是一个隐式链接标记功能隐式链接

强调

Markdown中标记强调字词需使用星号(*)或底线(_),被单个*_包围的字词会被<em>标签包围,用两个*_包起来,则会被转成<strong>,示例:

1
2
3
*强调*
**强调**
__强调__

效果展示:

强调
强调
强调

如果*_两边都有空白,它们就只会被当成普通的符号.

代码

Markdown标记一小段行内代码,需用反引号包起来(`),支持语法高亮,包括:Apache, Bash, CoffeeScript, C++, C#, CSS, HTTP, Java, JavaScript, JSON, Markdown, Nginx, Objective-C, Perl, PHP, Properties, Python, Ruby, Shell Session, SQL, HTML, XML等.示例:

1
这是一个`行内代码标记`

效果展示:

这是一个行内代码标记

图片

Markdown中插入图片,有两种样式: 行内式和参考式.

行内式

1
![图片替代文字](图片链接URL "图片描述")
  • 一个感叹号!
  • 接着方括号[],里面是图片的替代文字
  • 接着括号,里面是图片的URL,最后还可以选择性加上文字描述.

参考式

1
2
![图片替代文字][图片参考标记]
[图片参考标记]: 图片链接URL "图片描述"

如果需对图片进行宽高,位置调整,可以使用普通的<img>标签

自动链接

Markdown支持比较短的自动链接形式来处理网址和电子信箱,需用尖括号<>

1
<网址的URL>

表格

Markdown中支持表格,:代表对其方式,:|之间不能有空格,否则对其会有不兼容.示例:

1
2
3
4
5
6
7
8
9
(空格)
|左侧|中间|右侧|
|:---:|:---:|:---:|
|描述一|描述二|描述三|

(空格)
左侧|中间|右侧
:---:|:---:|:---:
描述一|描述二|描述三

效果展示:

左侧中间右侧
描述一描述二描述三

小结

Markdown的简单应用到这也差不多写完了,当然还有好多的高级技巧可以自行百度或Google.语法本来就很简单,虽不说十分钟包教包会,但是只要尝试着在键盘上敲两下,看看效果,学会它还是挺容易的.

------------- The End -------------
显示评论