美文网首页饥人谷技术博客
markdown 易学易用(So easy!)

markdown 易学易用(So easy!)

作者: 饥人谷_Mily | 来源:发表于2017-02-07 18:53 被阅读0次

Markdown 是一种轻量级标记语言,创始人为 John Gruber 。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML (或者 HTML )文档”。

1 标题

标题共六级,一级标题字号最大,字号随着级别的增加递减。leanote 最多支持五级标题,简书可支持六级。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

显示效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2 列表

2.1 无序列表

无序列表项前的标记符号可以使用*+-,标记符号后须加至少一个空格

+ 无序列表项1
- 无序列表项2
* 无序列表项3

显示效果如下:

  • 无序列表项1
  • 无序列表项2
  • 无序列表项3

2.2 有序列表

有序列表项前加上数字和一个英文句号,英文句号后须加至少一个空格。数字的大小排序不影响最终显示的效果。

1. 有序列表项 1
3. 有序列表项 2
8. 有序列表项 3

显示效果如下:

  1. 有序列表项1
  2. 有序列表项2
  3. 有序列表项3

注:leanote 的 markdown 编辑器,无序和有序列表前还需要添加一个空行,简书不需要。

3 注脚

在需要加注的文字后加上[^note],即可加上注脚,具体语法如下所示。注意,这里的脚注1, note2 和 footnote3 可以换成其他文字,只要前后保持一致即可。

使用 Markdown[^脚注1]可以效率地书写文档,直接转换成 HTML[^note2],你可以使用 Leanote[^footnote3] 编辑器进行书写。

(注:leanote 的 markdown 编辑器,以下各个注脚解释之间还需要用一个空行分隔,简书不需要)

[^脚注1]:Markdown 是一种纯文本标记语言

[^note2]:HyperText Markup Language 超文本标记语言

[^footnote3]:开源笔记平台,支持 Markdown 和笔记直接发为博文

显示效果如下:

使用 Markdown[1]可以效率地书写文档,直接转换成 HTML[2],你可以使用 Leanote[3] 编辑器进行书写。

4 插入链接

链接可指定 title 属性,也可省略。如定义了 title 属性,当鼠标悬停在链接文字上时会显示 title 属性的值。

[链接文字](链接地址 "title")

例如:[简书](http://www.jianshu.com/  "简书官网")

显示效果如下:

简书

<>将链接包围起来,即自动转换成链接。

<http://example.com/>
<address@example.com>

显示效果如下:

http://example.com/
address@example.com

5 插入图片

插入图片的语法为:![](图片链接 图片title)

  • 图片 alt 是当图片无法显示时,替代图片的文字信息,可省略。
  • 图片 title 是当鼠标悬停在图片上时显示的文字,可省略。
![宋民咕 鱼香肉丝里面没有肉](https://img.haomeiwen.com/i4558002/00c60a9b78e694da.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "宋民咕")

显示效果如下:

宋民咕 鱼香肉丝里面没有肉

6 区块引用

引用文本时,在文本前加>即可,> 与引用文本之间需保留一个空格。

> 假如生活欺骗了你
> 不要悲伤,不要心急
> 忧郁的日子里需要镇静
> 相信吧,快乐的日子将会来临
> 心儿永远向往着未来
> 现在却常是忧郁
> 一切都是瞬息,一切都将会过去
> 而那过去了的,就会成为亲切的怀恋

显示效果如下:

假如生活欺骗了你
不要悲伤,不要心急
忧郁的日子里需要镇静
相信吧,快乐的日子将会来临
心儿永远向往着未来
现在却常是忧郁
一切都是瞬息,一切都将会过去
而那过去了的,就会成为亲切的怀恋

区块引用可以嵌套(引用内的引用),还可以在引用内使用其他的 markdown 语法,例如:

> 宋代欧阳修则云:
> 最佳读书时间,乃为三上:即**枕上**、**马上**、**厕上**。
> —— *刘真《论读书》*

显示效果如下:

宋代欧阳修则云:
最佳读书时间,乃为三上:即枕上马上厕上
—— 刘真《论读书》

7 粗体、斜体、加粗斜体和删除线

具体语法如下:

1. **粗体**
2. *斜体*
3. ***加粗斜体***
4. ~~删除线~~

显示效果如下:

  1. 粗体
  2. 斜体
  3. 加粗斜体
  4. 删除线

8 输入代码

8.1 输入单行代码

输入单行代码的语法:`单行代码`。显示效果如下:

var a = 1

8.2 输入多行代码

输入多行代码的语法如下,在第一行的 ``` 后面加上代码语言,leanote 和简书都能实现语法高亮。
在每行代码前输入四个或四个以上的空格也能实现代码块的效果。

```python
class Employee:
empCount = 0

def init(self, name, salary):
self.name = name
self.salary = salary
Employee.empCount += 1
```

显示效果如下:

class Employee:
   empCount = 0
   def __init__(self, name, salary):
        self.name = name
        self.salary = salary
        Employee.empCount += 1

9 表格

表格第一行为表头,第二行分隔表头与表格主体部分,第三行开始为表格主体部分。
列与列之间以|分隔。
第二行还可为不同列指定对齐方式,|:------:|为居中对齐,|------:|为右对齐,|:------|为左对齐。

|table |table   |table  |
|:-----|:------:|------:|
|1     |2       |3      |
|4     |5       |6      |

显示效果如下:

table table table
1 2 3
4 5 6

10 分隔线

输入三个以上的*-_即可生成分隔线,*-_之间可插入空格。

***

---

___

显示效果如下:




11 定义

如果需要对某个名词的定义作出解释,可以选用以下语法格式,目前简书不支持这个功能,leanote 支持。

名词 1
:    定义 1(左侧有一个冒号和四个空格)

leanote 上的显示效果如下:

12 Html 标签

leanote 支持在 Markdown 语法中嵌套 Html 标签,简书不支持。譬如,你可以用 Html 写一个纵跨两行的表格:

<table>
    <tr>
        <th rowspan="2">值班人员</th>
        <th>星期一</th>
        <th>星期二</th>
        <th>星期三</th>
    </tr>
    <tr>
        <td>李强</td>
        <td>张明</td>
        <td>王平</td>
    </tr>
</table>

leanote 上的显示效果如下:

也可以通过 img 标签插入图片,利用 img 标签的 height 和 width 属性来设置图片的高度和宽度。

![](https://img.haomeiwen.com/i4558002/73942e9b78c2b21e.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

leanote 上的显示效果如下:

13 目录

通过 [TOC] 在文档中插入目录,简书暂不支持。leanote 上的显示效果如下:

14 其他

想更多地了解和学习 markdown,可参阅以下资料:


  1. Markdown 是一种纯文本标记语言

  2. HyperText Markup Language 超文本标记语言

  3. 开源笔记平台,支持 Markdown 和笔记直接发为博文

相关文章

网友评论

    本文标题:markdown 易学易用(So easy!)

    本文链接:https://www.haomeiwen.com/subject/ttyyittx.html