logo头像
Snippet 博客主题

markdown语法使用

本文于1541天之前发表,文中内容可能已经过时。

概诉

  • Markdown是一种书写的格式,语法比较简单,用它编写的 纯文本可以转换成有效的XHTML文档,非常适合用来记录笔记、博客。熟练掌握它即可以让页面美观,也能大大提高编写效率。但在编写过程中需要注意大部分有符号的地方必需要空格才能生效。

段落和换行

  1. 段落的前后必须是空行,空行指的是行内什么都没有,或者只有空白符(空格或制表符),如果相邻2行文本中间没有空行就会被显示在一行内。
  2. 如果需要在段落内换行,可以在前一行的末尾加入2个空格,然后换行编写其他内容
  3. Markdown多数区块都需要在2个空行之间。

标题

  • Markdown支持2中形式的标题语法
  • 第一种:通过=(最高阶标题) -(第二阶标题)
1
2
3
4
this is an H1
=============
this is an H2
-------------
  • 效果如下:

this is an H1

this is an H2

  • 第二种:通过输入1-6个#,对应的就是H1-H6,在标题后面可以添加#,也可以不添加#
1
2
# this is an H1
## this is an H2
  • 效果如下

this is an H1

this is an H2

区块引用

  • 每行前面加上>,段落的第一行前面可以添加>,区块引用可以嵌套,也可以引用标题、列表、代码区块等。
1
2
> 这个是区块的测试
> ## 这是一个标题。
  • 效果如下

这个是区块的测试

这是一个标题。

列表

  • 支持无序列表和有序列表,无序列表前面加*或者+或者-,有序列表是一个数字加上一个英文句点,有序列表前面的数字随便添加都会输入相同的结果都是从1开始。
1
2
1 . 一级
* 二级
  • 效果

1 . 一级

  • 1.1

代码区块

  • 建立代码区块很简单,代码块前后至少有一个空行,并且每行前面缩紧4个空格或者1个tab就可以
1
2
3
<div>
<p>这是一个普通段落:</p>
</div>
  • 效果
<div>
  <p>这是一个普通段落:</p>
</div>

代码高亮显示

  • 多行代码需要用

    1
    2
    3
    window.addEventListener("load",function(){
    alert('1');
    })

  • 效果

    1
    2
    3
    window.addEventListener("load",function(){
    alert('1');
    })

分隔线

  • 可以写3个以上的* - _ 来建立一个分隔线,中间可以添加空格,但是不能添加其他内容
1
****
  • 效果

链接

  • 分为行内式和参考式2种形式,但是不管哪一种链接的文字都是用[]来标记的
1
2
3
这是行内式一个链接 [google](https://www.google.com "google")
这个是参考式一个链接 [Google]: http://www.google.com/ "Google"
使用<>包括的URI或者邮箱地址 <https://www.google.com>
  • 这是行内式一个链接 google

强调

用*或者_作为强调词字的符号,被包围的词字会被转换为标签包围

1
2
** 这个是被强调的内容 **
__ 这个是被强调的内容 __

这个是被强调的内容
这个是被强调的内容

图片

图片和链接很相似,就是在前面多了一个!

1
2
3
行内式 ![测试图片](http://yongjian.space/image/css-flex/flex-result.png)
参考式 ![测试图片]: http://yongjian.space/image/css-flex/flex-result.png
可以用img制定大小 <img src="http://yongjian.space/image/css-flex/flex-result.png" width="50" height=50 />

  • 效果

行内式 测试图片

参考式 ![测试图片]: http://yongjian.space/image/css-flex/flex-result.png

删除线

1
~~删除线~~
  • 删除线

表格

1
2
3
4
| name | age |
| :---: | :---: |
| lerarnShare | 12 |
| Mike | 32 |
  • 效果
name age
lerarnShare 12
Mike 32

参考链接

http://xianbai.me/learn-md/article/extension/table.html