Hexo官司网查看 这里
hexo的博文建议是用markdown语法来写,原因markdown简单通用,比如很多博客平台都会提供md编辑器,这样如果我们想把同一篇文章发到多个博客平台上(事实上很多人也是这样做的),md应该是最好的编写方法了,没有之一。
注意:
- md是个标准,但也允许扩展**,就这造成了各平台对同一份.md的解析有可能不一样,所以本文归纳了
通用的 Markdown语法
,可无障碍应用于Hexo博文创作和主流的博客平台(不包括资源图片和多媒体,这需要用图床的方式来解决);- 特殊的扩展语法笔者已标记且不可用于文章编写,解析后会格式错乱;
一点感受:
- 很多时候提倡百家齐放,但并不是所有事情都如此。比如markdown本身是一个标准,大家都按标准来解析就好了,非要搞什么定制化。定制化也可以用户感受度会更好,但是这类东西技术上没门槛,搞特殊化的公司没实力去统一其它家公司做成国标更别说做成国际标准了,典型的窝里斗,逼迫用户做选择,最后这些差异性还要用户来买单。既然这样那用户只用通用标准来写了,不用你那些所谓的高级功能,这坑我不跳。
- 上述感受的反例,大家可以了解下Amzon电商的商品页设计。同一个SKU只允许一个商品展示页且只允许一个商家来修改,其它商家只能在服务体验上做差异化展示。在运营过程中此SKU的归属是依靠商家运营的评分动态变化的。个人感觉就这非常不错,引导商家不要搞花里虎哨的宣传,多花些时间和精力在服务品质和服务质量上。
一点个人感受只代表个人,不要吐槽,我们还是回到技术上来。
本章目标:
掌握全部通用的markdown语法,因为在日后我们不能一边写文章一边查文档,笔者大概写了两篇文章后就基本熟记了这些语法内容,还是比较简单的。
此文我会分3块内容来重新组织md语言的通用语法,方便大家查找。
元素
1. 字体 index
- 斜体 :斜体文本,斜体文本
*斜体文本*,_斜体文本_
- 粗体 :加粗文本, 加粗文本
**加粗文本**, __加粗文本__
- 粗斜体:粗斜体文本, 粗斜体文本
***粗斜体文本***, ___粗斜体文本___
删除线, 带下划线文本~~删除线~~ , <u>带下划线文本</u>
- 字体字号:红色字体,红色字体
<font color="red">红色字体</font> <font size=4>4号,正常3号,取值1-7</font>
- 段落:# 标题,最多6级即6个#
2. 段落格式 index
- 换行方式 : 末尾添加两个空格 或 使用空行来换行
3.使用 HTML 元素 index
方法是直接书写,比如 这里换行→<br>blah, blah, blah
。解析后<br>
就起到了换行的作用。
1. 目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>等
2. 转义:使用反斜杠 \,比如\\
\ * _ {} [] () # + - . ! `
3. 公式:用$$,比如 $f(x) = sin(x) + 12$
4. 图片 index
- 简单格式:
![alt](https://www.baidu.com/img/aaa.png)
- 指定大小:
<img decodeing="async" src="https://www.baidu.com/img/aaa.png" width="50%">
(非标准)CSDN扩展的图片样式:
尺寸:aaa.png=60x60
等经缩放:宽度固定:aaa.png=60x, 高度固定 aaa.png=x60
居中:aaa…png#pic_center 或 pic_right 或 aaa.png#pic_center =60x60
5.分隔线 index
分隔线需要注意,有时分隔线不显示,那么在分隔线标识符上或下方多加一行空行就好了。
--- 或 ***
内容块
1.列表 index
- 列表:使用星号(*)、加号(+)或是减号(-)作为列表标记,这些标记后面要添加一个空格,然后再填写内容:
+ 序列表
- 序列表
* 序列表
1. 有序列表:数字+点
- [ ] 计划任务
- [x] 完成任务
- 列表嵌套:
+ 无序列表 : * + -
+ 列表嵌套 : 子列前添加4空格或制表符
- (非标准)自定义列表:自定义列表无列表符
: John
2.区块 index
一个 > 符号是最外层,两个 > 符号是第一层嵌套,以此类推,最好嵌套一层,如果多层的话很多解析器不支持。:
> 区块嵌套
> > 一层嵌套
> > > 二层嵌套
例1:区块嵌套
一层嵌套
3.代码块 index
- 行代码:用``,比如
printf()
函数 - 代码块:```包裹一段代码,并指定一种语言,最后以再三个```结尾,比如```java ```
$(document).ready(function(){
alert('')
})
4.表格 index
表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他;
| 表头 | 表头 |
| ---- | ---- | # 变换对齐方式 | ---: | :---: | :---|
| 单元格 | 单元格 |
| 单元格 | 单元格 |
表头 | 表头 |
---|---|
单元格 | 单元格 |
单元格 | 单元格 |
交互
1.页内跳转 index
- 方式一:
<a id="table1">详细说明文档</a> //要跳转的位置,id = 标识符
[go to detail](#table1) //在需要跳转的地方引用,点击即可实现跳转
- 方式二:
<a id="table1">详细说明文档</a> #要跳转的位置,id = 标识符
<a href="#table1">go to detail</a> #在需要跳转的地方引用,点击即可实现跳转
2. 超链接 index
- 方式1:korg8 ,
[korg8](http://www.korg8.com)
- 方式2:https://baidu.com ,
<https://baidu.com>
- 方式2 : korg8-index:跳转到korg8主页
[korg8-index]:跳转到korg8主页 # 下面一定要有一个空行
[korg8-index]: https://github.com/hexojs/hexo-fs
3.脚注(非标准) index
显示样式在页面最下面,用分隔线隔开,可看本教程文档最下面的样式。
一个具有注脚的文本。1一个具有注脚的文本2
一个具有注脚的文本。[^1]
[^1]: 注脚的解释
特殊网站的标签(非标准)
![master version](https://img.shields.io/github/package-json/v/jerryc127/hexo-theme-butterfly/master?color=%231ab1ad&label=master)
![master version](https://img.shields.io/github/package-json/v/jerryc127/hexo-theme-butterfly/dev?label=dev)
![https://img.shields.io/npm/v/hexo-theme-butterfly?color=%09%23bf00ff](https://img.shields.io/npm/v/hexo-theme-butterfly?color=%09%23bf00ff)
![hexo version](https://img.shields.io/badge/hexo-5.3.0+-0e83c)
![license](https://img.shields.io/github/license/jerryc127/hexo-theme-butterfly?color=FF5531)
上会代码会显示如下图所示:
注脚的解释2 ↩︎