markdown-study

在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. 列表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

引用链接

两个中括号[ ][ ]
This is [an example] [id] reference-style link.

[id]: http://example.com/ “鼠标悬浮在id上显示的文字”

默认链接

google

强调

上面比较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加粗,与&lt;b>标签相似

### 加斜体

<span id="span">span用处,组合行内元素,添加id class等属性</span>
    <br/>
\*text\* md语法,表示斜体,与&lt;cite&gt;和&lt;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的时候有提到**
用单\*或单\_表示斜体,与&lt;em>标签类似
用双\*或双\_表示粗体,与&lt;strong>标签类似

## 代码
用 单\`或三\`,三`可以指定代码语言,如下
1
echo "hello bash";
1
echo "hello php";
## 图片 ### 内联图片 语法:!\[文件名](路径 "可选项:表示鼠标悬停显示信息")如: ![米兔](../images/markdown-study/米兔.jpg "米兔") ### 引用图片 语法:!\[文件名]\[id] ![米兔][miracle] [miracle]: ../images/markdown-study/米兔.jpg "可选项:鼠标悬停显示信息" # 其他 ## 自动链接 语法:&lt;url&gt; <http://miracle778.github.com> ## 反斜杠转义 **常识,不写了**

总结

markdown还是容易学的,几个小时就能搞懂。但在把文章部署到hexo上时,出现了点问题。原因是VScode的Markdown Preview Enhanced插件预览的效果跟实际发布的效果有点不同。vscode里加div这种标签预览可以正常显示,而发布后不能,搞得我微调了好久,还有就是引用资源的路径,插入图片需要配置一下。

还好,都是一些小问题,以后多写写,养成习惯就好。

ヾノ≧∀≦)o 来呀!快活呀!~
-------- 本文结束 --------