Hexo在Github中搭建博客系统(5)Markdown语法

转载 2016年08月29日 10:02:38

前面我们已经知道怎么搭博客系统、发布、创建文章,现在到了创建内容的时候,需要熟练掌握Markdown的语法

基本语法

(0) 特殊字符

之所以把特殊字符放到最前面,就是因为Markdown对特殊字符处理不是很友好,很容易出现很奇怪的异常,其实就是因为文章中包含了特殊字符无法编译通过导致Hexo无法渲染
在写博客时,一定注意不要写这些字符,如果要写,就进行转义
有些人可能说可以使用反斜杠 \ 来处理,我这里不建议,因为我使用的时候没有解决问题。
下面是比较常见的几个:

! ! — 惊叹号Exclamation mark 
” " " 双引号Quotation mark 
# # — 数字标志Number sign 
$ $ — 美元标志Dollar sign 
% % — 百分号Percent sign 
& & & Ampersand 
‘ ' — 单引号Apostrophe 
( ( — 小括号左边部分Left parenthesis 
) ) — 小括号右边部分Right parenthesis 
* * — 星号Asterisk 
+ + — 加号Plus sign 
< &#60; &lt; 小于号Less than 
= &#61; — 等于符号Equals sign 
> &#62; &gt; 大于号Greater than 
? &#63; — 问号Question mark 
@ &#64; — Commercial at 
[ &#91; --- 中括号左边部分Left square bracket 
\ &#92; --- 反斜杠Reverse solidus (backslash) 
] &#93; — 中括号右边部分Right square bracket 
{ &#123; — 大括号左边部分Left curly brace 
| &#124; — 竖线Vertical bar 
} &#125; — 大括号右边部分Right curly brace 

特别注意的是小括号 ( ) 大括号 { } ,如果不小心写了,你执行hexo s –debug可能报一些莫名其妙的错误!
这里还有更多关于特殊字符如何转义的内容

(1) 标题

在文字前加上#号

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

大标题
=
小标题
-

预览效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

大标题

小标题

(2) 粗体斜体

*斜体文本*    _斜体文本_
**粗体文本**    __粗体文本__
***粗斜体文本***    ___粗斜体文本___

预览效果:
斜体文本 斜体文本
粗体文本 粗体文本
粗斜体文本 粗斜体文本

(3) 链接

常用链接方法
文字链接 [链接名称](https://chwshuang.github.io)
网址链接 <https://chwshuang.github.io>


高级链接技巧
这个链接用 1 作为网址变量 [Google][1].
这个链接用 yahoo 作为网址变量 [Yahoo!][yahoo].
然后在文档的结尾为变量赋值(网址)

  [1]: http://www.google.com/
  [yahoo]: http://www.yahoo.com/

预览效果:
文字链接 链接名称
网址链接 http://hushuang.me

高级链接技巧
这个链接用 1 作为网址变量 Google.
这个链接用 yahoo 作为网址变量 Yahoo!.

(4) 列表

普通无序列表

- 列表文本前使用 [减号+空格]
+ 列表文本前使用 [加号+空格]
* 列表文本前使用 [星号+空格]

普通有序列表

1. 列表前使用 [数字+空格]
2. 我们会自动帮你添加数字
7. 不用担心数字不对,显示的时候我们会自动把这行的 7 纠正为 3

列表嵌套

1. 列出所有元素:
    - 无序列表元素 A
        1. 元素 A 的有序子列表
    - 前面加四个空格
2. 列表里的多段换行:
    前面必须加四个空格,
    这样换行,整体的格式不会乱
3. 列表里引用:

    > 前面空一行
    > 仍然需要在 >  前面加四个空格

(5) 引用

普通引用

> 引用文本前使用 [大于号+空格]
> 折行可以不加,新起一行都要加上哦

引用里嵌套引用

> 最外层引用
> > 多一个 > 嵌套一层引用
> > > 可以嵌套很多层

引用里嵌套列表

> - 这是引用里嵌套的一个列表
> - 还可以有子列表
>     * 子列表需要从 - 之后延后四个空格开始

(6) 图片

跟链接的方法区别在于前面加了个感叹号!,这样是不是觉得好记多了呢?

![图片名称](http: //图片地址)
当然,你也可以像网址那样对图片网址使用变量

这个链接用 1 作为网址变量 [ Google] [ 1].
然后在文档的结尾位变量赋值(网址)

[1]: http: //www.google.com/logo.png
也可以使用 HTML 的图片语法来自定义图片的宽高大小

<img src=”img/gxt.png” width=”240” height=”275”>

<img src="img/gxt.jpg" width="240" height="275">

(7) 换行

如果另起一行,只需在当前行结尾加 2 个空格

在当前行的结尾加 2 个空格  
这行就会新起一行
如果是要起一个新段落,只需要空出一行即可。

(8) 分隔符

如果你有写分割线的习惯,可以新起一行输入三个减号-。当前后都有段落时,请空出一行:

前面的段落

---

后面的段落

(9) 小型文本

Markdown语法:

<small>文本内容</small>

预览效果:
我是正常文字
我是小型文字

(10) 注释

用html的注释,好像只有这样?

<!-- 注释 -->

(11) 表格

Markdown的扩展语法,hexo已经支持

| 参数           | 说明                 |   默认值            |
| ------------- |:-------------------:|:------------------:|
| host          | 远程主机的地址         |                    |
| user          | 使用者名称            |                    |
| root          |  远程主机的根目录      |                    |
| port          | 端口                 |       22           |
| delete        | 删除远程主机上的旧文件   |  true              |
| verbose       | 显示调试信息           |   true             |
| ignore_errors | 忽略错误              |     false          |
参数 说明 默认值
host 远程主机的地址
user 使用者名称
root 远程主机的根目录
port 端口 22
delete 删除远程主机上的旧文件 true
verbose 显示调试信息 true
ignore_errors 忽略错误 false

最后:
还是要注意特殊字符的处理,其他的就是排版样式的问题,特殊字符没处理好,就是Hexo渲染报错

参考资料:
Markdown 编辑器语法指南
Markdown入门学习小结


下一节:异常处理

hexo笔记--markdown

什么是MarkdownMarkdown 是一种轻量级标记语言,创始人为约翰·格鲁伯和亚伦·斯沃茨。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML文档”。 ——维基百科先简单介...
  • lucas421634258
  • lucas421634258
  • 2015年11月07日 11:23
  • 545

Hexo博客更换主题和Markdown使用

基于我的上一篇博客:http://blog.csdn.net/u014427391/article/details/53670744 的基础,本博客,介绍hexo博客主题更换和上传自己写的博客,使用...
  • u014427391
  • u014427391
  • 2016年12月15日 16:00
  • 1855

Hexo静态博客搭建+个人定制

很早以前就想写这样一篇了,因为各种原因耽搁到现在(逃)...网上关于Hexo的教程其实已经有挺多了,但是很多都是一笔带过。这篇博客除了**Hexo**博客的搭建过程,还有一些我加进去的**个人定制**...
  • LemonXQ
  • LemonXQ
  • 2017年05月24日 14:22
  • 11750

用Hexo + github搭建自己的博客 --- 再也不用羡慕别人了!

每次Google自己不会的问题时,总会发现有很多的人都有自己的博客,不由自主的羡慕起来,于是按捺不住自己的躁动的心,说干就干。 前言每次写博客之前都喜欢做一些科普啊巴拉巴拉的,写之前还想分析一波Hex...
  • Hoshea_chx
  • Hoshea_chx
  • 2017年12月17日 18:27
  • 755

使用Hexo+Github一步步搭建属于自己的博客(基础)

使用Hexo+Github一步步搭建属于自己的博客(基础) 前言:电脑系统为window 10专业版,64位   相关步...
  • pyfysf
  • pyfysf
  • 2018年01月24日 16:17
  • 155

hexo高阶教程:想让你的博客被更多的人在搜索引擎中搜到吗?

本文首发在我的个人博客:http://cherryblog.site/,欢迎大家前去参观,顺便求fork,么么哒~ 上一次在掘金上发表的hexo高阶教程:hexo高阶教程next主题优化之加入网易云音...
  • sunshine940326
  • sunshine940326
  • 2017年04月28日 18:53
  • 4322

hexo的next主题个性化教程:打造炫酷网站

看到有些next主题的网站很炫酷,那么是怎么配置的呢?接下来我会讲一讲如何实现一些炫酷的效果 主要有以下32种: 在右上角或者左上角实现fork me on github 添加RSS 添加动态...
  • qq_33699981
  • qq_33699981
  • 2017年05月24日 22:10
  • 10837

hexo 首页文章只显示一部分

这个只要在文章中加上 标记 ,该标记以后部分就不在显示了,只有展开全部才显示,这是hexo定义的。 这样每次添加这个标记有点麻烦,也可以自定义添加,不过可能会导致排版错乱,自定义配置链接https:...
  • qq_32337109
  • qq_32337109
  • 2017年12月08日 21:28
  • 382

hexo入门(安装,配置,本地启动)

hexo是一个快速、简洁且高效的博客框架,本文介绍hexo的安装,配置,本地启动。...
  • wangnan9279
  • wangnan9279
  • 2015年03月22日 09:48
  • 4692

hexo+next主题优化之加入网易云音乐、网易云跟帖、炫酷动态背景

有强迫症的我要支持网易云跟帖,所以必须要更新一个NEXT主题,原来的主题版本有点旧,没有集成网易云跟帖,所以又来重新折腾了折腾~绑定域名绑定域名的思路如下: 在万网购买自己喜欢的域名(.com的会贵一...
  • sunshine940326
  • sunshine940326
  • 2017年04月09日 21:02
  • 6388
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Hexo在Github中搭建博客系统(5)Markdown语法
举报原因:
原因补充:

(最多只允许输入30个字)