在Hexo上写文章肯定要回markdown,于是对着官方文档过了一遍,用的是VS code加Markdown Preview Enhanced插件,源码会放在最后。
中文文档地址 : https://markdown-zh.readthedocs.io/en/latest/
标题
现在听的歌
王菲 - 我也不想这样
段落
This is a regular paragraph
html里块级跟非块级标签不同用法,块级标签里面不能用md语法
Foo | bar | #块级元素里用md语法 无效 |
This is another regular paragraph
html跟md语法的一些比较
加粗体
**text** 将text加粗,与<b>标签相似
加斜体
span用处,组合行内元素,添加id class等属性
*text* md语法,表示斜体,与<cite>和<em>标签类似
cite标签表示对文献的引用,为斜体一般和a标签一起用,链接到所参考位置
加删除线
表示删除文本,html del标签md语法里用两条波浪线~表示
行尾加两个空格以上回车表示换行
标题两种表示方法
第一种=、-
文本下面加=表示一级标题,下面加-表示二级标题
第二种#
#的数量代表级数
## 二级
### 三级
#### 四级
块级元素
块引用
块引用,通过 >text声明
这是第一层
这是第二层
回到第一层
可以嵌套md语法
- 列表1
- 列表2
- 列表3
列表
- 无序列表
- 可用*、+、-
- 有序列表
- 使用数字加点如:1.
- Bird
- Magic
注释块
- A list item with a blockquote:
This is a blockquote
inside a list item.
代码块
A list item with a codeblock:
def func(): print("hello Python!")
水平线
用三个连着的字符(字符中间有空格不要紧,-,*,_)
内联元素
内联链接
中括号加括号[]()
如:[miracle778’s Blog](https://miracle778.github.io) 显示如下
miracle778’s Blog
引用链接
两个中括号[ ][ ]
This is [an example] [id] reference-style link.
[id]: http://example.com/ “鼠标悬浮在id上显示的文字”
默认链接
强调
上面比较html跟md的时候有提到
用单*或单_表示斜体,与<em>标签类似
用双*或双_表示粗体,与<strong>标签类似
代码
用 单`或三`,三`可以指定代码语言,如下1
echo "hello bash";
1 | echo "hello php"; |
图片
内联图片
语法:![文件名](路径 “可选项:表示鼠标悬停显示信息”)如:
引用图片
语法:![文件名][id]
其他
自动链接
语法:<url>
http://miracle778.github.com
反斜杠转义
常识,不写了
代码
#标题
## 现在听的歌
### 王菲 - 我也不想这样
# 段落
This is a regular paragraph
## html里块级跟非块级标签不同用法,块级标签里面不能用md语法
<table>
<tr>
<td>Foo</td>
<td>bar</td>
<td>#块级元素里用md语法 无效</td>
</tr>
</table>
This is another regular paragraph
<br /><br />
## html跟md语法的一些比较
### 加粗体
\*\*text** 将text加粗,与<b>标签相似
### 加斜体
<span id="span">span用处,组合行内元素,添加id class等属性</span>
<br/>
\*text\* md语法,表示斜体,与<cite>和<em>标签类似<br/>
<cite>
<a>cite标签表示对文献的引用,为斜体一般和a标签一起用,链接到所参考位置</a>
</cite>
### 加删除线
<del>表示删除文本,html del标签</del>
~~md语法里用两条波浪线\~表示~~
**行尾加两个空格以上回车表示换行**
# 标题两种表示方法
*第一种=、-*
文本下面加=表示一级标题,下面加-表示二级标题
一级标题
==========
二级标题
---------
*第二种#*
\#的数量代表级数
## 二级
### 三级
#### 四级
# 块级元素
## 块引用
> 块引用,通过 \>text声明
> >
> 这是第一层
> >
> > 这是第二层
> >
> **回到第一层**
> # 可以嵌套md语法
> 1. 列表1
> 2. 列表2
> 3. 列表3
## 列表
- 无序列表
+ 可用*、+、-
* 有序列表
+ 使用数字加点1.
1. Bird
2. Magic
## 注释块
* A list item with a blockquote:
> This is a blockquote
> inside a list item.
## 代码块
* A list item with a codeblock:
def func():
print("hello Python!")
## 水平线
用三个连着的字符(字符中间有空格不要紧,-,*,_)
- - -
_ _ ___
* * *
# 内联元素
## 内联链接
**中括号加括号\[]()**
如:\[miracle778's Blog](https://miracle778.github.io) 显示如下
[miracle778's Blog](https://miracle778.github.io)
## 引用链接
**两个中括号[ ][ ]**
This is [an example] [id] reference-style link.
<!-- 引用链接时,声明需隔开一行 -->
[id]: http://example.com/ "鼠标悬浮在id上显示的文字"
## 默认链接
[google][]
[google]:http://google.com
## 强调
**上面比较html跟md的时候有提到**
用单\*或单\_表示斜体,与<em>标签类似
用双\*或双\_表示粗体,与<strong>标签类似
## 代码
用 单\`或三\`,三`可以指定代码语言,如下
1
echo "hello bash";
1
echo "hello php";
## 图片
### 内联图片
语法:!\[文件名](路径 "可选项:表示鼠标悬停显示信息")如:
![米兔](../images/markdown-study/米兔.jpg "米兔")
### 引用图片
语法:!\[文件名]\[id]
![米兔][miracle]
[miracle]: ../images/markdown-study/米兔.jpg "可选项:鼠标悬停显示信息"
# 其他
## 自动链接
语法:<url>
<http://miracle778.github.com>
## 反斜杠转义
**常识,不写了**
总结
markdown还是容易学的,几个小时就能搞懂。但在把文章部署到hexo上时,出现了点问题。原因是VScode的Markdown Preview Enhanced插件预览的效果跟实际发布的效果有点不同。vscode里加div这种标签预览可以正常显示,而发布后不能,搞得我微调了好久,还有就是引用资源的路径,插入图片需要配置一下。
还好,都是一些小问题,以后多写写,养成习惯就好。