Markdown语法简介

来源:互联网 发布:外汇模拟软件app 编辑:程序博客网 时间:2024/05/21 03:19

Markdown语法简介

让你的写作如行云流水


导语

  Markdown是一种轻量级的标记语言,类似HTML,但是要比HTML简单多得多,据说5分钟就可以完全掌握所有的语法,而我用了将近两天的时间整理这份文档,也许是到处找资料过于追求完美的缘故吧。文中包含了网上搜集到的包括官网和写作爱好者总结的所有关于Markdown的语法。格式是用了分门别类的方式,个人感觉这样比较容易理解和记忆,方便以后查阅和入门的小伙伴们的参考,如有误差的地方望指正。

1、标题

分类:
 1. 类setext
 2. 类atx

类setext

语法:
  以单下划线和双下划线的方式标记,双下划线就是一级标题,单下划线就是二级标题(单、双下划线的数量不限)。
  
示例:
  一级标题
   =======

  二级标题
  ———-

类atx

语法:
  以标题前面’#’号的个数区分标题的等级,从1个’#’到6个’#’分别代表1~6级标题,等级越高字体越小,为了美观也可以在标题的末尾加上同等数量的’#’号,但这纯粹是为了对称美观

示例:
  #一级标题#
  ##二级标题##
  ###三级标题###
  ####四级标题####
  #####五级标题#####
  ######六级标题######


2、区块引用

语法:
  每一行前面加上’>’符号,也可以以偷懒的方式,只在段落的第一行前面加上’>’

示例:
  >这是引用文字

特点:
1. 区块标记可以嵌套
 示例:
  >这是引用文字
  >>这是一层嵌套引用
  >>这是二层嵌套引用
2. 引用的区块内可以使用其他的Markdown语法
 示例:
  >引用文字*强调文字*


3、列表

分类:
 1. 有序列表
 2. 无序列表

无序列表

语法:
  在文本前加’*’或者’+’或者’-‘符号

示例:
  * 列表行一
  * 列表行二
  
  + 列表行一
  + 列表行二
  
  - 列表行一
  - 列表行二
  

有序列表

语法:
  数字后面紧跟着英文句号的方式生成有序列表
  
示例:
  1. 列表行一
  2. 列表行二


4、代码区块

语法:
  在行首添加一个制表符或者四个空格就可以生成代码区块的样式,代码区块其实就是编写的文本会被一个边线框包围

示例:

   (一个制表符或者四个空格符)代码区块

注意:
  代码区块内的Markdown的语法失效,会以普通字符输出,内部的代码样式不会改变,这也正是代码区块的特点所在


5、分割线

语法:
  三个以上的星号或者减号或者底线符号生成分割线  

示例:
  **** 或者 * * * *
  — 或者 - - -
  ___ 或者 _ _ _

注意:
  星号,减号和下划线中间可以穿插任意多个空格,但不能有其他字符


6、链接和图片

分类:
 1. 行内式
 2. 参考式

行内式

语法:
  [链接文字](链接 可选链接”Title”)

示例:
   [百度首页](http://www.baidu.com “百度首页”)

注意:
  如果是本机资源链接可以使相对路径

参考式

语法:
  [链接文字][链接标示],然后你就可以在文章的任意地方通过链接标示定义链接内容
  链接内容定义格式:
    [链接标示]: 链接网址 “链接标题”
示例:
  [百度首页][a]
  [a]: http://www.baidu.com “百度”

附:
  链接标示为空的链接标记成为隐式链接标记
  语法:
    [链接文字][]
    [链接文字]: 链接 “可选标题”
  示例:
    [百度首页][]
    [百度首页]: http://www.baidu.com “百度”

注意:
  链接标示方括号后面的冒号后面至少有一个空格,链接标题可有可无,链接标题可以用双引号,单引号或者小括号包围,效果相同。链接标示可以是字母,数字,空白和标点符号,但是不区分大小写。

7、图片

图片和链接十分类似,不同的是图片语法的前面多了个惊叹号,这里就不在浪费篇幅了,只列举两个例子

示例:
  行内式:![占位文字](图片连接 “标题”)
  参考式:![占位文字][图片标示id]
      [图片标示id]: 图片地址 “标题”


8、强调(斜体和粗体)

分类:
  1. 斜体
  2. 粗体

斜体

语法:
  文本被一对星号或者下划线符号包围

示例:
  *斜体强调文字*

粗体

语法:
  文本被两对星号或者下划线符号包围

示例:
  **粗体强调文字**

注意:强调文字可以在一句话内使用也可以单独使用


9、标记代码

语法:
  代码部分用反引号包围(反引号就是数字1前面的按键),如果代码中包含反引号,可以用双反引号包围代码

示例:

`[btn setTitle:str forState:UIControlStateNormal];`


10、其他语法

输入空格

简介:
   在Markdown中直接输入单个空格是可以的,但是连续输入多个空格就不行了,结果和输入一个空格是一个效果,那么怎么连续输入多个空格呢?语法如下

语法:
  切换输入法为全角输入模式
  

换行

简介:
  Markdown中想要换下一行输入文本,直接回车是不行的,效果和输入tab是一样的,需要用特殊的语法

语法:
  首先敲两个空格,然后再回车
  

输入空行

简介:
  在平常的写作中,为了格式的协调经常要输入空行,和输入空格一样,Markdown中单独输入单行空行可以用回车,但是要连续输入多行空行还需要特殊的语法

语法:
  \

注意:
  因为Markdown兼容HTML,所以这里其实用的是HTML的语法
  

输入小型文本

简介:
  这里所说的小型文本就是输入的文字比普通的文字要小

语法:
  用small标签包围文本

示例:
  \这是小型文本\

注意:
  小型文本语法其实是运用了HTML的语法
  

文本中间划线

语法:
  文本用三对’~’包围

示例:

~~~操作文本~~~

自动链接

简介:
  网址和邮箱可以点击自动跳转到浏览器打开

语法:
  <网址或邮箱>

示例:
  \http://www.baidu.com \address@163.com

反斜杠转意

简介:
  这个类似代码里面的转意字符,可以把语法字符转换成普通字符显示
示例:
  #这个不作为标题


11、插入表格(扩展语法)

语法:
  找了好久也没有找到表格语法的描述,就只有示例里面的两个示例,好纳闷,也许解释起来比较费劲吧,那就照葫芦画瓢凑合着用吧,毕竟我也是刚入门,等以后深入了解了再更新

示例:

| Tables        | Are           | Cool  |  | ------------- |:-------------:| -----:|  | col 3 is      | right-aligned | $1600 |  | col 2 is      | centered      |   $12 |  | zebra stripes | are neat      |    $1 |  dog | bird | cat----|------|----foo | foo  | foobar | bar  | barbaz | baz  | baz


12、其他相关资料

语法参考手册

  • Markdown语法说明(简体中文版)
  • Markdown语法说明(繁体中文版)
  • Markdown官方语法说明

工具

  这里推荐使用mac上非常好用的工具软件Mou,说好用其实是因为它完全免费,因为我知道收费的软件你肯定不会用_^ ^_,何况这只是一款用于写作的软件呢。你可以点击这里下载,点击这里进入Mou官方网站了解详情。

0 0
原创粉丝点击