Markdown 语法文档

前言

Markdown 是一种轻量级标记语言,创始人为約翰・格魯伯(英语:John Gruber);

它允许人们 “使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者 HTML)文档”;

这种语言吸收了很多在 电子邮件中已有的纯文本标记的特性;

—— 维基百科

Markdown 的部分标记有几种不同的符号,但是实现的效果都是相同的,所以文章中每种实现的效果我只写一种符号,一般都是方便且较常用的标记符号;

标题

# H1
## H2
### H3
#### H4

# 的数量代表标题的级别;

段落与格式

段落

我是第一段

我是第二段

段落之间加入空行实现换行效果,如无空行,换行符会转换成空格;

我是第一段
我是第二段

在前一段落末尾加上至少两个空格,也可实现换行;

字体格式

*斜体字体*
**加粗字体**
***加粗斜体***

段落两端加上对应数量 *(星号),即可实现以上三种效果;

删除线

~~删除线~~

段落两端加上 ~~ 即可实现 删除线 效果;

下划线

<u>下划线</u>

Markdown 语言中没有 下划线 标记,但是 Markdown 支持 HTML 标记,所以可以通过 HTML 的 <u> 标记实现 下划线 效果;

引用内容

单行引用

>时间就是生命,我的朋友

时间就是生命,我的朋友

多行引用

>多行引用如果需要换行
>可在两行之间添加空行
>
>或在换行前的行末添加两个空格

多行引用如果需要换行

可在两行之间添加空行

或在换行前的行末添加两个空格

嵌套引用

>时间就是生命,我的朋友
>>Yes!

时间就是生命,我的朋友

Yes!

列表

有序列表

1. 列表一
2. 列表二
1. 子列表一
2. 子列表二
3. 列表三
  1. 列表一
  2. 列表二
    1. 子列表一
    2. 子列表二
  3. 列表三

无序列表

- 第一种实现符号
+ 第二种实现符号
+ 嵌套列表
+ 嵌套列表
* 第三种实现符号
  • 第一种实现符号
  • 第二种实现符号

    • 嵌套列表
    • 嵌套列表
  • 第三种实现符号

TODO 列表

- [ ] TODO 1
- [ ] TODO 2
- [ ] TODO 2.1
- [x] TODO 2.2
- [x] TODO 3

博客园暂不支持 TODO 列表;

代码

行内代码

全选:`Ctrl` + `A`

全选:Ctrl + A

代码块

​```
我是代码块
​```
我是代码块

注:1、3 行的 ``` 就是代码块的实现符号;

代码高亮

​```C#
using System; class Markdown{ }
​```
using System;

class Markdown{ }

注:在行首 ``` 后加上代码语言的名字,即可实现对应的代码高亮;

邮箱

<address@email.com>

address@email.com

链接

内联链接

[Light's Note](https://www.cnblogs.com/Light-/ "Light's Note(可选)")

Light's Note

<https://www.cnblogs.com/Light-/>

https://www.cnblogs.com/Light-/

外联链接

[Light's Note][blog_Url]

[blog_Url]:https://www.cnblogs.com/Light-/ "Light's Note(可选)"

Light's Note

图片

内联图片

![我的头像](https://pic.cnblogs.com/avatar/1645312/20190418233348.png "Ligth's Note(可选)")

外联图片

![我的头像][png_url]

[png_url]:https://pic.cnblogs.com/avatar/1645312/20190418233348.png "Light's Note(可选)"

表格

使用 | 分隔单元格,- 分隔表头和其他行;

表头 | 表头
----- | -----
单元格 | 单元格
单元格 | 单元格
表头 表头
单元格 单元格
单元格 单元格

单元格对齐

:- :左对齐

:-: :居中

-: :右对齐

表头 | 表头 | 表头
:---- | :-: | ----:
左对齐 | 居中 | 右对齐
左对齐 | 居中 | 右对齐
表头 表头 表头
左对齐 居中 右对齐
左对齐 居中 右对齐

高级技巧

HTML 标记

Markdown 是一种标记语言,且同时兼容另一种标记语言 HTML (博客园暂只支持部分简单标记),所以我们也可以直接在文档中使用相关标记,例如:

<u> 下划线

<u>下划线文本</u>

下划线文本

<kbd> 键盘框

全选:<kbd>Ctrl</kbd> + <kbd>A</kbd>

全选:Ctrl + A(博客园暂不支持)

<i> 内嵌图标

<i class="icon-weibo"></i>

更多的图标和玩法可以参看 font-awesome 官方网站;(博客园暂不支持)

转义字符

Markdown 的占用了很多常用符号,如:*-~

如果我们写文档时需要显示这些符号,可以使用转义字符:\标记符号 转义为 普通符号 显示出来;

*斜体文本*
\*斜体文本\*

斜体文本

*斜体文本*

**加粗文本**
\*\*加粗文本\*\*

加粗文本

**加粗文本**

分隔符

---


使用至少三个 - (减号),加上一个空行,实现分隔符;

脚注

Light's Note 里面的文章真棒![^脚注标题]

[^脚注标题]: 是的,我也这么觉得~

Light's Note 里面的文章真棒![1]


  1. 是的,我也这么觉得~ ↩︎

最新文章

  1. 学习Sass 的基本语法规则[Sass和compass学习笔记]
  2. js的reduce方法,改变头等函数
  3. IT运维外包甩不掉的包袱
  4. MVVM与Knockout
  5. JS组件系列——在ABP中封装BootstrapTable
  6. 读Zepto源码之Data模块
  7. PL/SQL简单实现数据库的连接
  8. python字符串编码理解(转载)
  9. mysql的sql执行计划
  10. nginx启动常遇到的问题
  11. python-多线程等概念
  12. sqlalchemy动态组合查询语句。
  13. day7--面向对象进阶(内含反射和item系列)
  14. TZOJ 3030 Courses(二分图匹配)
  15. 重复子串(string)
  16. InteliJ IDEA 简单使用:配置项目所需jdk
  17. BackgroundWorker使用方法
  18. Windows下如何正确下载并安装可视化的Redis数据库管理工具(redis-desktop-manager)(图文详解)
  19. csu 1552(米勒拉宾素数测试+二分图匹配)
  20. php array_push 与 $arr[]=$value 性能比较

热门文章

  1. tkinter属性(总结)
  2. Reading Code Is Hard
  3. Oracle的nvl
  4. Docker 新手入门
  5. 向combobox控件中添加元素
  6. BZOJ_2946_[Poi2000]公共串_后缀数组+二分答案
  7. nodejs-5.1 ejs模板引擎
  8. 从Java继承类的重名static函数浅谈解析调用与分派
  9. (2)STM32使用HAL库操作外部中断——理论讲解
  10. 实时监听input输入框value的变化: