zoukankan      html  css  js  c++  java
  • Markdown简单语法介绍

    http://runtool.blog.163.com/blog/static/18314444520130622058448/

    MARKDOWN简介

    Markdown是一种轻量级的标记语言,由John Gruber和Aaron Swartz创建。它的灵感来自于带标记的电子邮件文本。Markdown允许HTML语法,所以在markdown文件里面直接使用html表示也是可以的。

    MARKDOWN的优点

    Markdown能让文档更容易读、写和修改。HTML是一种发布式的格式,Markdown是一种书写的格式。Markdown只涵盖纯文本的范围。在博客中使用Markdown可以更多的关注于文章的内容,少量的地方来控制排版(Markdown的排版符号)。

    MARKDOWN编辑工具

    工具:

    1. Windows: MarkdownPad,需要安装.Net 4;Meditor
    2. Linux: ReText
    3. Mac: Mou或者Sublime Text 2
    4. 网页版: Dillinger
    5. Chrome扩展: Made,支持左右分屏,即时预览。
    6. Vim插件: Vim+vimviki

    区块元素

    段落和换行

    一个Markdown段落由一个或多个连续的文本行组成。它的前后要有一行以上的空行。这里的空行是 指不包含除了制表符和空格外的字符。 如果想强制换行,那么可以在插入的地方连续输入2个以上的 空格即可。

    标题

    Markdown支持两种标题语法:类Setext和类atx形式。 前者使用=来表示最高阶标题,-表示第二阶标题。注意这些符号是在标题的下方,个数是任意的(大于一个) 例如:

    This is h1.  ===========    This is h2.  -----------  

    显示结果:

    THIS IS H1.

    THIS IS H2.

    类atx形式则是平常见到比较多的使用1到6个#来不同的标题阶数。数量越多,字体越小。

    # This is h1  ## This is h2  

    显示结果:

    THIS IS H1.

    THIS IS H2.

    区块引用

    Markdown标记区块引用是使用类似email中用>的引用方式。使用区块引用只需要在行首使用>即可。如果只是在每个段落的第一行加上>也是可以的。

    例如:

    >Do you know that you are so special. but in some way,     I think you are a little too special.    > What do you think?  

    这样都是可以的。

    显示结果:

    Do you know that you are so special. but in some way, I think you are a little too special.

    What do you think?

    如果想要在引用中继续嵌套使用也是可以的,需要做的就是,继续使用>就可以了。 另外,引用中的markdown语法是可以正常使用的。

    例如:

    > ## this is a title.  > > this is a nested markdown sentence.  > 1. item1  > 1. item2  

    显示结果:

    THIS IS A TITLE.

    this is a nested markdown sentence.

    1. item1
    2. item2

    列表

    在上面的例子中,我们用到了列表。在markdown中,可以使用*+-来作为标记。另外,也可以使用数字+.的方式来作列表,这里的数字不一定要按照顺序来,只要是符合上述规则即可,markdown的最终显示会从1开始逐个显示。

    例如:

    >1.I Love China.  >3. I Love Ruby.  >1. Item1.  >3. Item2.  >10. Item3.  

    显示效果:

    1. I Love China.
    2. I Love Ruby.
    3. Item1.
    4. Item2.
    5. Item3.

      这里需要注意下:如果在显示列表的时候,使用了数字+.和上面3种的混合形式。那么最终的显示效果,以第一行的列表为准。数字+.显示的为数字列表,而前三种显示的为实心点的列表形式。

    如果想要在列表中使用引用,那么>需要缩进。如果要放入代码区块的话,需要缩进2次,即8个空格或2个TAB。 如果在段落中含有2012. what a fatancy year.,在为了避免被“翻译”成列表,那么需要使用\转义数字后面的那个.

    代码区块

    作为程序猿经常要使用代码贴在文章中,而这些代码,我们都要保持它的格式不被修改。在Markdown中,markdown会将代码块使用<pre><code>标签将之包起来。 那么我们如何使用代码块呢?4个空格或者一个TAB。嗯,就是这样简单。 例如:

    def say(gf)     puts "Hello, #{gf}."  end  

    显示效果:如上。

    代码块会一直持续到没有缩进的行或者文件结束。

    分割线

    什么?想使用分割线?嗯,这个也很简单:使用3个以上的星号、减号、底线就可以。不过这里的要求是:行内只能有以上3中,但不能包含除空格外的其它字符。

    例如:

    * * *  ----  -   -   -  ____      __________        ___________  

    显示效果:





    区段元素

    链接

    Markdown支持两种形式的链接语法:行内式和参考式。它们的共同点是:都是使用[]来标记的。

    行内式:在方括号后面使用圆括号,并在圆括号中写上链接地址和标题即可(可选),title字段需要使用双引号包起来。

    例如:

    This is a [Link](http://snails.github.com,"My Blog") to my site.  

    显示结果:

    This is a Link to my site.

    这里的链接地址不局限于http这种链接,也可以使用相对链接地址。

    参考式: 这种方式指的是在第一个方括号后面要继续使用一个方括号,在后者中要输入链接的目标。这里的方括号不用跟得太”亲密“。XD

    This is the link to the [Top] [top] Link.  

    我在文章上部定义了:

    [top]: # "Top of the post."  

    显示效果:

    This is the link to the Top Link.

    链接的网址也可以使用方括号<>包起来,定义ID的地方,后面在跟一个冒号后,需要加一个空格或制表符,Title可选,使用逗号隔开。

    链接的标识标签可以使用字母、数字、空白和标点符号,不区分大小写。

    隐式链接能够让我们省略制定的标记。在原来的方括号后面,添加一个空的方括号,默认会跳转到http:标识.com的链接上去。

    例如:

    [Google][]  [Goole]: http://google.com  

    结果:

    Google 链接的定义位置任意。下面我们就将本文的参考代码写在下面:

    本文参考的链接包括[wowubuntu][1]和[appinn][2]    [1]: http://wowubuntu.com   "WowUbuntu.com"  [2]: http://www.appinn.com  "Appinn.com"  

    显示效果:

    本文参考的链接包括wowubuntuappinn

    强调

    我们可以使用*_来强调某个词,单个的字符使用的标签为<em>,使用2个则为<strong>。不过在使用的时候,这两个标记在使用的时候不要都有空白,否则它就是普通”群众“了。

    代码

    行内的一小段代码,可以使用反引号(在TAB上面的那位)来将其包起来

    ``There is a back door here`.``  

    There is a back door here`.

    图片

    最后我们说下图片。图片在一个文章中必不可少,有助于帮助读者更好的理解作者的意图。那么在Markdown中如何使用图片链接呢?

    ![Alt Text](path of the picture "Option title")  

    不过Markdown没有办法来指定图片的宽高,所以如果图片太BIG,请选择<img>标签,因为Markdown是兼容这些标签滴。

    下面我们贴一个指向ruby china社区Logo的图片:

    ![ruby-china logo](http://ruby-china.org/assets/big_logo.png  "logo")  

    显示结果:

    ruby-china logo

    OTHERS

    另外如果使用尖括号将网址、邮箱放在里面,你会发现,Markdown 已经为了做了很多事。

    <http://snail.github.com>    Contact Me: <godhuyang@gmail.com>  

    显示结果:

    http://snail.github.com

    Contact Me: godhuyang@gmail.com

     

  • 相关阅读:
    Git基操
    阿里云Centos7安装mysql5.7
    Centos安装jdk8
    BD-rate/BD-BitRate/BDBR/BD-PSNR
    应用统计作业(1)——概率统计知识求解以定积分的近似值
    标量对向量、标量对矩阵、向量对向量、矩阵对矩阵的求导和微分计算
    JM8.6(H.264编码器)源码注释——码率控制部分主要推导
    二、全国大学生电子设计竞赛测控(无人机)方向___赛题分析
    C#-WebForm-Request、Response、QueryString
    webform 页面传值的方法总结
  • 原文地址:https://www.cnblogs.com/shiningrise/p/2983911.html
Copyright © 2011-2022 走看看