原文查看可点击《markdown语法小记》哦!
基本语法
标题
h1~h6对应: #
数量决定标题等级。还可以用=
在文字下表示,但局限只有两级。
# h1
## h2
### h3
#### h4
##### h5
###### h6
一级标题
===
二级标题
---
显示如下:
引用
> 引用的文字
>> 引用的文字
大于号越多,引用的层级越多,上述代码显示效果如下:
引用的文字
引用的文字
链接或图片
[点击跳转至百度](http://www.baidu.com)
![图片](http://cassielala.top/images/logo.jpg)
显示效果如下:
点击跳转至百度
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. 茄子- 黄瓜- 水果黄瓜- 小黄瓜
- 玉米- 紫玉米- 黄玉米
- 茄子
效果如下:
- 黄瓜
- 玉米
- 茄子
- 黄瓜
- 玉米
- 茄子
- 黄瓜
- 水果黄瓜
- 小黄瓜
- 玉米
- 紫玉米
- 黄玉米
- 茄子
注:
- 如果在单一列表项中包含了多个段落,为了保证渲染正常,*与段落首字母之间必须保留四个空格。
- 如果在列表中加入了区块引用,区域引用标记符也需要缩进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 |
大致介绍就到这里啦,如果有什么新的发现,我会继续更新哒!