markdown语法小记

原文查看可点击《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. 茄子

- 黄瓜
  - 水果黄瓜
  - 小黄瓜
- 玉米
  - 紫玉米
  - 黄玉米
- 茄子

效果如下:

  • 黄瓜
  • 玉米
  • 茄子
  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

大致介绍就到这里啦,如果有什么新的发现,我会继续更新哒!

你可能感兴趣的:(markdown语法小记)