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入门学习小结


下一节:异常处理

相关文章推荐

windows下配置hexo+github,hexo设置,markdown语法

github,hexo,markdown

Hexo博客更换主题和Markdown使用

基于我的上一篇博客:http://blog.csdn.net/u014427391/article/details/53670744 的基础,本博客,介绍hexo博客主题更换和上传自己写的博客,使用...

markdown简明语法

摘要:*我做的馅饼 是全天下* 最好吃的 Q:怎样输入首行缩进  输入法切换到全角,双击空格键~这里开始使用markdown格式输入你的正文。一个人来到田纳西 毫无疑问> 引用:markdow...

MarkDown 语法示例

Markdown的语法简洁明了、学习容易,而且功能比纯文本更强,因此有很多人用它写博客。世界上最流行的博客平台WordPress和大型CMS如joomla、drupal都能很好的支持Markdown。...
  • brokge
  • brokge
  • 2014年08月05日 18:02
  • 7218

[前端]jekyll+markdown+github搭建个人博客

jekyll+markdown+github搭建个人博客
  • napoay
  • napoay
  • 2015年09月12日 20:14
  • 2396

hexo+github教程之Markdown工具-MarkdownPad

前面五个hexo+github教程,我们已经把hexo博客的搭建,主题优化,还有第三方插件的安装都撸过一遍了,相信看过教程的应该都能搭建出一个满意的hexo博客了。好了,言归正传,这一篇博文是介绍Ma...

打造专属自己的博客-使用Hexo、Github Pages、Markdown(风靡IT圈)

本文请看:打造专属自己的博客-使用Hexo、Github Pages、Markdown(风靡IT圈)我的博客效果...

hexo笔记--markdown

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

github与markdown使用总结

github markdown

原来Github上的README.md文件这么有意思——Markdown语言详解

转载请注明出处:http://blog.csdn.net/zhaokaiqiang1992    之前一直在使用github,也在上面分享了不少的项目和Demo,每次创建新项目的时候,使用的都是默认的...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Hexo在Github中搭建博客系统(5)Markdown语法
举报原因:
原因补充:

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