Markdown使用

Markdown使用
Markdown指南

本质上，类似于html，markdown也是一种标记型语言，ie，用某些字符（不像html用字符串）标示某种格式，只是标记格式不同罢了。
比如：###Hello Word，标示出helloword是三级标题，markdown进行渲染后就成了对应大小、加粗的格式。
介绍markdown的教程太多了，我不打算做无用的重复，给出我认为必读的几个供大家参考。

1.      鲁塔弗：markdown 简明语法

2.     图灵社区：怎样使用Markdown

3.     简书：献给写作者的 Markdown 新手指南

4.     官方文档(中文版)：Markdown 语法说明

5.      用Markdown来书写你的博客

1markdown 简明语法

基本符号

·        *,-,+ 3个符号效果都一样，这3个符号被称为 Markdown符号

·        空白行表示另起一个段落

·        `是表示inline代码，tab是用来标记代码段，分别对应html的code，pre标签

换行

·        单一段落( <p>) 用一个空白行

·        连续两个空格会变成一个<br>

·        连续3个符号，然后是空行，表示 hr横线

标题

·        生成h1--h6,在文字前面加上 1--6个# 来实现

·        文字加粗是通过文字左右各两个符号

引用

·        在第一行加上 “>”和一个空格，表示代码引用，还可以嵌套

列表

这个是markdown文件的主要表示方式，主题要点化

·        使用*,+,-加上一个空格来表示

·        可以支持嵌套

·        有序列表用数字+英文点+空格来表示

·        列表内容很长，不需要手工输入换行符，css控制段落的宽度，会自动的缩放的

链接

·        直接写 [锚文本](url "可选的title")

·        引用先定义[ref_name]:url，然后在需要写入url的地方，这样使用[锚文本][ref_name]，通常的ref_name一般用数字表示，这样显得专业

·        简写url：用尖括号包裹url
这样生成的url锚文本就是url本身

插入图片

·        一行表示: ![alt_text](url "可选的title")

·        引用表示法: ![alt_text][id],预先定义 [id]:url "可选title"

·        直接使用<img>标签，这样可以指定图片的大小尺寸

特殊符号

·        用来转义，表示文本中的markdown符号

·        可以在文本种直接使用html标签，但是要注意在使用的时候，前后加上空行

·        文本前后各加一个符号，表示斜体

2怎样使用Markdown

图灵社区发帖采用的是流行的Markdown语法，本文可供快速入门。
```
 
```
```
 
```
代码1
```
单个回车
```
```
视为空格。
```
```
 
```
```
连续回车
```
```
 
```
```
才能分段。
```
```
 
```
```
行尾加两个空格，这里->  
```
```
即可段内换行。
```
```
 
```
```
*这些文字显示为斜体*
```
```
 
```
```
**这些文字显示为粗体**
```
效果1

单个回车视为空格。

连续回车

才能分段。

行尾加两个空格，这里->
即可段内换行。

这些文字显示为斜体

这些文字显示为粗体

代码2
```
>表示引用文字内容。
```
```
 
```
```
#表示这是一级标题
```
```
##表示这是二级标题
```
```
###表示这是三级标题
```
```
……
```
```
###### 最小是六级标题
```
```
 
```
```
也可以这样表示大标题
```
```
=
```
```
 
```
```
这样表示小标题
```
```
-
```
效果2

表示引用文字内容。

表示这是一级标题

表示这是二级标题

表示这是三级标题

……

最小是六级标题

也可以这样表示大标题

这样表示小标题

代码3
```
---
```
```
上面是一条分隔线
```
```
 
```
```
 
```
```
- 这是无序列表项目
```
```
- 这是无序列表项目
```
```
- 这是无序列表项目
```
```
 
```
```
两个列表之间不能相邻，否则会解释为嵌套的列表
```
```
 
```
```
1. 这是有序列表项目
```
```
2. 这是有序列表项目
```
```
3. 这是有序列表项目
```
```
 
```
```
下面这个是嵌套的列表
```
```
 
```
```
- 外层列表项目
```
```
 + 内层列表项目
```
```
 + 内层无序列表项目
```
```
 + 内层列表项目
```
```
- 外层列表项目
```
效果

上面是一条分隔线

·        这是无序列表项目

·        这是无序列表项目

·        这是无序列表项目

两个列表之间不能相邻，否则会解释为嵌套的列表

1.    这是有序列表项目

2.    这是有序列表项目

3.    这是有序列表项目

下面这个是嵌套的列表

·        外层列表项目

·        内层列表项目

·        内层无序列表项目

·        内层列表项目

·        外层列表项目

代码4
```
直接把一个URL显示为超级连接：
```
```
 
```
```
也可以这样：[图灵社区](http://www.ituring.com.cn)
```
```
 
```
```
图像和链接非常类似，区别在开头加一个惊叹号： ![这是一个Logo图像](http://www.turingbook.com/Content/img/Turing.Gif)
```
```
 
```
```
此外，还可以以索引方式把url都列在文章的最后，例如这样：
```
```
 
```
```
[图灵社区][1]
```
```
![图灵社区Logo][2]
```
```
 
```
```
[1]:http://www.ituring.com.cn
```
```
[2]:http://www.ituring.com.cn/Content/img/Turing.Gif
```
效果4

直接把一个URL显示为超级连接：

也可以这样：图灵社区

图像和链接非常类似，区别在开头加一个惊叹号：

此外，还可以以索引方式把url都列在文章的最后，例如这样：

图灵社区

说明一下，上述1-3是并列关系，不同人总结的教程，建议都看。4比较繁琐，可以暂时不看，以后需要时再查询即可。
还有，markdown就这么点东西，学会了就一劳永逸了，性价比很高！

下面给出几个编辑器，大家边学边练。

·        简书用微博登录，开始记笔记吧！

·        MaDe(Chrome插件)

·        dillinger

·        StackEdit 由TangPro推荐。

·        Cmd - 在线 Markdown 编辑阅读器

好了，开始你的markdown之旅吧！

5 使用Markdown

5.1 简介

Markdown 的宗旨是实现「易读易写」。可读性，无论如何，都是最重要的。

Markdown 的语法全由一些符号所组成，这些符号经过精挑细选，其作用一目了然。格式撰写的文件可以直接以纯文本发布，并且看起来不会像是由许多标签或是格式指令所构成。

资料：[搭建环境]

5.2 基本语法

·        使用一个或多个空行分隔内容段来生成段落 <p>。

·        标题（h1~h6）格式为使用相应个数的“#”作前缀，比如以下代码表示 h3：

### this is a level-3 header ###

·        使用“>”作为段落前缀来标识引用文字段落。这其实是 email 中标记引用文字的标准方式：

> 引用的内容

> 这个记号直接借鉴的邮件标准

·        使用“*”“+”“-”来表示无序列表；使用数字加“.”表示有序列表。如：

1. I am ordered list item 1...

2. So I should be item 2!?

·        使用 4 个以上空格或 1 个以上的 tab 来标记代码段落，它们将被<pre> 和 <code> 包裹，这意味着代码段内的字体会是 monospace家族的，并且特殊符号不会被转义。

·        使用 [test](http://example.net"optional title") 来标记普通链接。

·        使用 ![img](http://example.net/img.png"optional title") 来标记图片。

引号内的 title 文字是可选的，链接也可以使用相对路径。

·        使用 * 或 _ 包裹文本产生 strong 效果：

_语气很重的文本_ 以及 **语气更重的文本**

让Markdown成为日常文本记录语言

习惯

日常记事中，用普遍文本的情况不在少数，但是文本本身的并没有特殊的格式含义，要表示一些特殊的含义也会在头或尾加一些*号，下划线，分割线等，来隔断文本块，区分内容信息等。那现在Markdown变得非常合适，只要稍微记住几个语法字符，就可以轻松的标记出来标题、段落、列表，长久使用形成习惯，能够带来很多方便。

所以可以把Markdown作为日常文档记录语言。

简单

markdown是一种轻量级的标记语言。语法简单，书写简单，只需要像写普通文本一样，在行首加上特殊的字符，就可以标记成标题，段落，列表，就是markdown。markdowng格式的文本，更容易阅读和理解，而且可以轻松转化成html，pdf等。详细标签说明见下面链接。

工具

使用Notepad,EditPlus,UltraEdit等等，只要可以写文本的编辑器都可以。让Notepad支持Markdonw语法高亮

1.   下载userDefineLang.xml

2.   将userDefineLang.xml 放置到此目录：C:UsersAdministratorAppDataRoamingNotepad++

3.   重启 Notepad++，在语言菜单下可以看到自定义的 Markdown 高亮规则

也可以使用现成的工具MarkdownPad，可以自动生成Markdown标签。
相关阅读:
Paperfolding HDU
I
2020年8月11日第一次组队训练
 2018ICPC南京I. Magic Potion
【贪心】纪念品分组
 【贪心】删数问题
 【排序】排名
 小X与队列
 B.T.B.F.
2018浙江理工大学迎新赛——决赛
原文地址：https://www.cnblogs.com/peterYong/p/6556714.html

Markdown指南

1markdown 简明语法

基本符号

换行

标题

引用

列表

链接

插入图片

特殊符号

2怎样使用Markdown

代码1

效果1

代码2

效果2

表示这是一级标题

表示这是二级标题

表示这是三级标题

最小是六级标题

也可以这样表示大标题

这样表示小标题

代码3

效果

代码4

效果4

让Markdown成为日常文本记录语言

习惯

简单

工具