原文查看可点击《markdown语法小记》哦!
基本语法
标题
h1~h6对应: #数量决定标题等级。还可以用=在文字下表示,但局限只有两级。
# h1
## h2
### h3
#### h4
##### h5
###### h6
一级标题
===
二级标题
---
显示如下:

引用
> 引用的文字
>> 引用的文字
大于号越多,引用的层级越多,上述代码显示效果如下:
引用的文字
引用的文字
链接或图片
[点击跳转至百度](http://www.baidu.com)

显示效果如下:
点击跳转至百度

hexo插入本地图片
使用hexo的时候因为要插入本地图片遇到了问题,特此写来记录,希望能够帮助到大家。
- 首先将hexo把主页的配置文件
_config.yml里的post_asset_folder:这个选项设置为true - hexo目录下执行
npm install hexo-asset-image --save - 完成后再new新的md文件的时候就能在
/source/_posts下找到同名文件夹,将要放的图片丢进去对应的文件夹。 - md文件中引入的时候使用
[图片上传失败...(image-3c7d69-1548813573167)]即可
本来到这里应该就万事大吉了,但是嘞,我的图片依旧无法显示,后来经过我一系列的搜索,终于找到了问题的解决方案。
问题:
图片依然无法显示的原因是hexo3版本更新后对很多插件支持有问题,hexo-asset-image插件在处理data.permalink链接时出现路径错误,把年月去掉了,导致最后生成的路径为%d/xxx/xxx。
做法:
- 找到插件
hexo-asset-image,通过判断当前版本是否等于3的版本做不同的路径分割,一般插件在/node_modules/目录下。 - 修改代码如下:
//可在方法上添加该变量
var version = String(hexo.version).split('.');
//修改“data.permalink”
var link = data.permalink;
if(version.length > 0 && Number(version[0]) == 3)
var beginPos = getPosition(link, '/', 1) + 1;
else
var beginPos = getPosition(link, '/', 3) + 1;
- md文件使用时直接写照片名即可。
- 修改完成保存,重新生成静态文件即可:
[图片上传失败...(image-8401ef-1548813573167)]。
列表
- 无序列表使用
*、+、-标识 - 有序列表使用数字加
.标识,例如:1. - 可嵌套使用,
回车+tab即可
* 黄瓜
* 玉米
* 茄子
+ 黄瓜
+ 玉米
+ 茄子
- 黄瓜
- 玉米
- 茄子
1. 黄瓜
2. 玉米
3. 茄子
- 黄瓜
- 水果黄瓜
- 小黄瓜
- 玉米
- 紫玉米
- 黄玉米
- 茄子
效果如下:
- 黄瓜
- 玉米
- 茄子
- 黄瓜
- 玉米
- 茄子
- 黄瓜
- 水果黄瓜
- 小黄瓜
- 玉米
- 紫玉米
- 黄玉米
- 茄子
<font color="#a00">注:</font>
- 如果在单一列表项中包含了多个段落,为了保证渲染正常,*与段落首字母之间必须保留四个空格。
- 如果在列表中加入了区块引用,区域引用标记符也需要缩进4个空格
反正记住一个原则,如果在和列表配合使用的时候出现了问题,就缩进一次,四个空格或者一个制表符代表一次缩进。如果一次缩进没有解决问题,那就两次。
分割线
使用*或-即可
***
---
效果如下:
强调
*这里是斜体*
_这里是斜体_
**这里是加粗**
__这里是加粗__
效果如下:
这里是斜体
这里是斜体
这里是加粗
这里是加粗
插入代码块
使用两排的“```”包裹就好了。如果需要定于语言高亮,在第一排的三个“`”后面加上名称即可。markdown支持的高亮语言可见下文。
\```java
XXXXXX
```\
插入表格
其中第一行表头,第二行定义排列方式,:居--坐边即左对齐,居右则右对齐,两边都有则居中。
表头|条目一|条目二
:---:|:---:|:---:
项目|项目一|项目二
效果如下:
| 表头 | 条目一 | 条目二 |
|---|---|---|
| 项目 | 项目一 | 项目二 |
符号处理
转译多加一个/
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
支持高亮语言
| 名称 | 关键字 | 名称 | 关键字 |
|---|---|---|---|
| AppleScript | applescript | ActionScript 3.0 | actionscript3, as3 |
| Shell | bash , shell | ColdFusion | coldfusion,cf |
| C | cpp , c | C# | c# , c-sharp , csharp |
| CSS | css | Delphi | delphi , pascal , pas |
| diff&patch | diff patch | Erlang | erl , erlang |
| Groovy | groovy | Java | java |
| JavaFX | jfx , javafx | JavaScript | js , jscript , javascript |
| Perl | perl , pl , Perl | PHP | php |
| text | text , plain | Python | py , python |
| Ruby | ruby , rails , ror , rb | SASS&SCSS | sass , scss |
| Scala | scala | SQL | sql |
| Visual Basic | vb , vbnet | XML | xml , xhtml , xslt , html |
| Objective C | objc , obj-c | F# | f# f-sharp , fsharp |
| xpp , dynamics-xpp | R | r , s , splus | |
| matlab | matlab | swift | swift |
| GO | go , golang |
大致介绍就到这里啦,如果有什么新的发现,我会继续更新哒!