Markdown 语法入门

Markdown

Markdown作为一种使用普通文本编辑器编写的标记语言,通过简单的标记语法,设置文本不同的格式。以实现 [易读易写] 的目标。

Markdown为编写HTML提供了很好的实现,并避免了伴随的复杂性和丑陋难看。Markdown的语法全由一些符号组成,语法简单易上手。

本文介绍Markdown语法入门。

一、语法介绍

1.1 标题

1.1.1 Setext形式

类Setext形式是用底线的形式,利用 = (最高阶标题) 和 - (第二阶标题),例如:

This is H1
===========
This is H2
-------------------

This is H1

This is H2

注意:其中,任何数量的 =- 都是等效的。

1.1.2 Atx形式

类Atx形式是在行首插入 1 到 6个 #,对应分别为标题 16 阶,例如:

# H1 #
## H2 ##
### H3 ###
#### H4 ####
##### H5 #####
##### H6 #####

H1

H2

H3

H4

H5
H6

通常,若为了美观用,可以在行尾加上 #,行尾的 # 不强制要求和开头一样,只有行首的字符数确定标题对应的阶数。

1.2 区块引用Blockquotes

Markdown 标记区块引用类似email中用 > 的引用方式。在每行的前面加上 >
同样,Markdown允许只在整个段落的第一行最前加上 >
区块引用也可以嵌套,根据不同层次加上不同数量的 > 即可。
引用的区块内同样可以使用其他Markdown 语法,包括标题,列表,代码区块等

> 区块引用...
>
> 区块引用...

> 段落只需要要在第一行加上 
整个段落即引用在区块内。

> 区块间引用
>> 区块间引用

> ### 引用其他语法

区块引用...

区块引用...

段落只需要要在第一行加上
整个段落即引用在区块内。

区块间引用

区块间引用

引用其他语法

1.3 列表

Markdown支持有序列表和无序列表。

1.3.1 有序列表

有序列表使用1.数字接着一个英文句点;特别注意的是在标记上使用的数字并不会影响输出结果;列表项还可以包含多个段落,每个列表下段落都必须缩进4个空格或者1个制表符;如果需要在列表项目内引用的时候,使用 > 需要缩进。例如如下语法:

1.   item 1
3.   item 2(标记上使用的数字并不会影响输出结果)
2.   item 3(标记上使用的数字并不会影响输出结果)
4.   item 4
      多段文字1
      多段文字1
      >区块引用
5.  item 5
    1.列表项目内加列表
  1. item 1
  1. item 2(标记上使用的数字并不会影响输出结果)
  2. item 3(标记上使用的数字并不会影响输出结果)
  3. item 4
    多段文字1
    多段文字1

    区块引用

  4. item 5
    1.列表项目内加列表

1.3.2 无序列表

无序列表使用 *(星号)、+(加好) 以及 -(减号)作为列表标记:

- item 1
+ item 2
* item 3
  - item 3.1
    - item 3.1.1
  • item 1
  • item 2
  • item 3
    • item 3.1
      • item 3.1.1

1.4 代码区块

和程序相关的写作通常会用到代码区块,如果用区块引用排版就会和代码排版有差异,而我们更希望是按照原来的样子显示。Markdown 通过 <code>`</code> 和 <code>```</code> 标签来把代码区块包起来。

在代码区块里, &<>会自动转换成HTML试题,这样让诸如插入范例使用的HTML原始码更方便了。

 <div class="footer">
        © 2004 Foo Corporation
 </div>

在代码区块中,一般的Markdown语法不会被转换,因此可以很容易的用Markdown语法撰写相关语法文档。

1.5 分割线

在任意一行中用三个以上的 *-以及_来建立分割线,行内不能有除空格外的其他内容。

1.6 特殊格式

1.6.1 粗体

粗体文字设置使用 **将目标文字包含起来。

Bold

1.6.2 斜体

斜体文字设置使用 _将目标文字包含起来。

Italics

1.6.3 删除线

斜体文字设置使用 ~~ 将目标文字包含起来。

strikethrough

1.6.4 语法高亮

特定语法用如<code>```js</code>将设置超链接的文字包含起来。

grunt.initConfig({
  assemble: {
    options: {
      assets: 'docs/assets',
      data: 'src/data/*.{json,yml}',
      helpers: 'src/custom-helpers.js',
      partials: ['src/partials/**/*.{hbs,md}']
    },
    pages: {
      options: {
        layout: 'default.hbs'
      },
      files: {
        './': ['src/templates/pages/index.hbs']
      }
    }
  }
};

1.7 表格

1.7.1 普通表格

表格通过 |-表示。表头需要和表内容用 - 分割,各列内容用 | 分割。注意,不需要垂直对齐。

|table1|table2|
|--------|-------|
|content1|content2|
table1 table2
content1 content2

1.7.1 特殊格式表格

在表头内容分割线结束加上 : 即表示文字靠右对齐。

|table1|table2|
|--------:|-------:|
|content1|content2|
table1 table2
content1 content2

1.8 超链接

超链接通过 [ 超链接文字 ] 包含超链接文字内容,并在后紧跟 (URL) 超链接地址。

[Link](http://www.jianshu.com/u/7f8d85055cd1)

当需要为超链接添加hover效果的时候,在 (URL "hoverTitle") URL后用 "" 将提示文字包含起来。

[Link](http://www.jianshu.com/u/7f8d85055cd1 "Burjal")

1.9 Named Anchors

Named Anchors使能够在相同的页面上跳转到指定的锚点。最常用的就是跳转到每一个章节。

# Table of Contents
  * [Chapter 1](#chapter-1)
  * [Chapter 2](#chapter-2)
  * [Chapter 3](#chapter-3)

Table of Contents

上述会跳转到对应如下位置:

## Chapter 1 <a id="chapter-1"></a>
Content for chapter one.

## Chapter 2 <a id="chapter-2"></a>
Content for chapter one.

## Chapter 3 <a id="chapter-3"></a>
Content for chapter one.

1.20 图片

图片的语法和超链接的语法类似,在超链接语法前加了 !

![Markdown](http://upload-images.jianshu.io/upload_images/311578-26c2869134c4e359.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
Markdown

二、简书设置默认编辑器:

简书已经支持Markdown语法编辑。
设置步骤如下:

设置

在首页找到并进入设置。

设置常用编辑器

将常用编辑器设置为 Markdown

Markdown 语法入门分析到此就结束了~

附:

Grav SYNTAX

Markdown 语法说明 (简体中文版)

Markdown: Basics(快速入门)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,056评论 5 474
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,842评论 2 378
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 148,938评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,296评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,292评论 5 363
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,413评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,824评论 3 393
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,493评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,686评论 1 295
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,502评论 2 318
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,553评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,281评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,820评论 3 305
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,873评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,109评论 1 258
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,699评论 2 348
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,257评论 2 341

推荐阅读更多精彩内容

  • 标题 Markdown支持两种标题的语法,类Setext和类atx形式。 类Setext 使用底线的形式,利用 =...
    禾边的晓作坊阅读 705评论 0 5
  • MarkDown简介 Markdown是一种轻量级标记语言,创始人为John Gruber和Aaron Swart...
    叶子的翅膀阅读 1,277评论 0 1
  • 玉儿到食堂吃饭,一如往常的取了两个碗,到烧水区用开水烫一下碗,让自己觉得碗会变得干净点,吃着放心点,新来的同事小...
    菊小赵阅读 146评论 3 1
  • 简单书写,世界美丽
    也竹阅读 206评论 0 0
  • 北京夏日。伏天里的一场雨后。潮湿凉滑的清晨,又见一季金合欢树,盛开繁花。俏丽鲜艳的红伞向天盛开着。 不...
    鱼没没阅读 209评论 0 0