Markdown 语法入门

作者: Burjal | 来源:发表于2017-03-15 10:23 被阅读556次
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](https://img.haomeiwen.com/i311578/26c2869134c4e359.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
Markdown

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

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

设置

在首页找到并进入设置。

设置常用编辑器

将常用编辑器设置为 Markdown

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

附:

Grav SYNTAX

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

Markdown: Basics(快速入门)

相关文章

  • Markdown 入门指南

    Markdown 入门指南 目录Markdown 语法的起源Markdown 语法的种类Markdown trad...

  • Markdown语法

    参考:Markdown语法入门

  • markdown的语法

    markdown的语法示例,具体看图Markdown——入门指南

  • Markdown学习指南

    献给写作者的 Markdown 新手指南 Markdown: Basics (快速入门) Markdown 语法说...

  • MarkDown - 入门语法

    MarkDown - 入门语法 前言 这里是MarkDown百度百科,MarkDown的语法简洁明了、学习容易,而...

  • Markdown语法

    1. Markdown 新手指南2. Markdown 快速入门3. Markdown 完整语法

  • 标准md语法教程- Markdown从入门到精通(上)

    标准md语法教程- Markdown从入门到精通 (送晴编写) tags: 送晴 Markdown 语法教程 写...

  • Markdown的使用

    Markdown——入门指南Markdown入门学习小结 PS:语法和文字之间最好加空格,说好的支持HTML呢! ...

  • 新的开始

    个人博客搬迁 部署方式与markdown语法格式 *简单部署方式 *markdown入门指南

  • Markdown 入门指南

    Markdown基本语法入门指南 Markdown的目标是实现【易读易写】。它兼容HTML ,它的语法目标是:成为...

网友评论

    本文标题:Markdown 语法入门

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