Markdown简易入门

Markdown简介

Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容 本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia等网站,如各大博客平台:WordPress、Drupal、简书等。

Markdown基础语法

标题

Atx形式(注意#号后面有个空格)

# 一级标题  //对应html中<h1>,以此类推
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

Setext形式

一级标题
======    //符号个数任意,主要为了美观
二级标题
------

效果如图所示

列表

列表分为无序列表和有序列表
无序列表在每行开头使用*、+、-三种符号表示,可以混用(注意符号后的空格)

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

演示效果:

有序列表在每行开头使用数字跟上小数点表示,允许无序的数字(注意符号后的空格)

1. 列表项1
2. 列表项2
3. 列表项3

演示效果:

粗体与斜体

粗体使用**或__包裹

**粗体**
__粗体__

斜体使用*或_包裹

*斜体*

_斜体_

效果如图

块注释

通过在文字开头添加>表示块注释。(在>后添加5个空格后样式会有变化,允许多个>嵌套,最好不要省略>后的空格)

> 普通注释块
>     5个空格的注释块
>> 两个>
>>> 三个>

效果演示:

普通注释块

5个空格的注释块

两个>

三个>

段落与换行

换行有多种写法
第一种,敲两个回车键:

第一段

第二段

第二种,两个空格+回车:

第一段  //此处两个空格
第二段

第三种,使用html中的<br/>标签:

第一段<br/>
第二段

演示效果:

分割线

分割线可以使用三个以上的*、-、_三种符号来创建,由于Markdown支持HTML标签,所以<hr/>也是可以的,行内除空格外不能有其他字符(注意:为与标题中-、=的使用区分开,上一行需为空行)

---
***
___
<hr/>

实际效果:





代码块

代码块分为代码区段和代码区块
代码区段一般用于类似printf()这种在文字段落中插入少量代码的情况,使用`(反引号)将其包裹起来,若代码中包含反引号,可使用多个反引号开启和关闭代码区段。
代码区块一般用于插入一个代码段落,要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以实现。(代码区块第一行的上一行需为空行)

和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块,通常这些区块我们并不希望它以一般段落文件的方式去排版,而是照原来的样子显示,Markdown 会用 <pre> 和 <code> 标签来把代码区块包起来。 ————Markdown 语法说明 (简体中文版)

`普通代码段`
``带反引号`的代码段``

    代码区块
<pre><code>使用<pre><code>的代码段</code></pre>

演示效果:
普通代码段
带反引号`的代码段

代码区块
使用HTML标签<pre><code>包裹的代码区块

超链接和图片

超链接和图片有两种形式:行内式、参考式。
插入超链接与插入图片的语法很像,区别在一个!号
行内式:

// 插入图片
![图片名称](图片url)

// 插入链接
[显示内容](链接地址)

参考式:

// 插入图片
![图片名称][关联名称]

//插入链接
![显示内容][关联名称]

[关联名称]:url "alt名称"[可省略,亦可写作'alt名称',(alt名称)]

//隐式标记(省略关联名称)
![图片名称][]
[显示内容][]

[图片名称/显示内容]:url "alt名称"[同上]

参考

  1. Markdown 简易入门教程
  2. 5分钟快速入门Markdown
  3. 官方文档
  4. Markdown 语法说明 (简体中文版)
  5. HTML 转义字符