Markdown

原创
2018/10/11 10:06
阅读数 333

1.认识Markdown


Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑,Markdown 的语法十分简单。常用的标记符号也不超过十个,这种相对于更为复杂的 HTML 标记语言来说,Markdown 可谓是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。 创始人:John Gruber

2.使用Markdown的优缺点

2.1.优点


  • 专注于内容的而不是排版和样式;
  • 纯文本编辑,兼容所有的文本编辑器和文字处理软件;
  • 可轻松转换为HTML、PDF、MD文件;
  • 语法简单、学习成本低;

2.2.缺点


  • 部分平台不支持Markdown写作;
  • 需要熟悉语法(虽然很简单,能在几分钟内学会)

3.Markdown语法简介


这里针对常用的Markdown语法进行举例说明,读者可通过下方的例子快速掌握Markdown的基本语法,以达到快速熟悉使用Markdown写作的目的,详细可查看官方网站:https://daringfireball.net/projects/markdown/syntax#link

3.1.标题(Title)


Markdown支持两种标题的样式,Setext和Atx。

  • Setext-style:标题使用等号(对于第一级标题)和破折号(对于第二级标题)“加下划线”,语法如下所示:

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

    显示效果如下:

    This is an H1

    This is an H2

  • Atx-style:在行前面增加1~6个#号来表示标题,#号的个数也表示标题的等级;

      # This is an H1
      ## This is an H2
      ###### This is an H6
    

    显示效果:

    This is an H1

    This is an H2

    This is an H6

显然的,大多数人都会选择Atx风格的标题,因为Atx风格的语法更简单,且能能表示多级层次关系。

3.2. 引用(BLOCKQUOTES)


Markdown使用邮件风格>符号来表示引用,如果您熟悉在电子邮件中引用文本段落,那么你就能快速掌握如何在Markdown的引用语法,举例:

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> 
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.

显示效果:

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

使用技巧:

  • 只在第一行文本中添加引用符号 > This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

      > Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
      id sem consectetuer libero luctus adipiscing.
    
  • 多级嵌套引用,两个引用符号

      > This is the first level of quoting.
      >
      > > This is nested blockquote.
      >
      > Back to the first level.
    
  • 在引用中包含其他Markdown元素,包括:标题、列表和代码块

      > ## This is a header.
      > 
      > 1.   This is the first list item.
      > 2.   This is the second list item.
      > 
      > Here's some example code:
      > 
      >     return shell_exec("echo $input | $markdown_script");
    

3.3.列表(List)


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

  • 无序列表:在行前面添加+/*/-来表示,举例:

      *   Red
      *   Green
      *   Blue
      +   Big
      +   Middle
      +   Small
      -   Tall
      -   Short
    
  • 有序列表:在行前面添加1./2./3.(说明:添加的数字序号对实际显示的无影响,Markdown显示的时候会重新按照行的顺序编排)

      3. X
      2. X
      1. X
      4. X
    

3.4.代码块(Code Blocks)


与格式的代码块用于编写程序或者代码片断,在Markdown显示时不是正文段落,而是代码块的格式显示,Markdown语法中使用2个<pre>和<code>标签包装代码块。 要在Markdown中编写代码块示例,只需在块的每一行缩进4个字符或一个制表符,例如:

This is a normal paragraph:

This is a code block.

Here is an example of AppleScript:

tell application "Foo"
    beep
end tell

代码块一直持续到它没有缩进的行(或文章的结尾),在代码块中&符合、<符合、>符合都会自动转义,这使得利用Markdown来显示Html源代码变得非常容易,省去作者人工处理Html相关便签的问题,举例:

<div class="footer">
    &copy; 2004 Foo Corporation
</div>

3.5.水平线(Line)


在Markdown中可以使用联系3个或以上的字符来表示,包括-号、*号,如下写法将生成水平分界线;

***
---
----------------------

3.6.超链接(Link)


Markdown支持2种类型的超链接方式,内嵌和引用。在这两种超链接的语法中,均采用显示内容来表示,举例:

显式方式:[name](url "tip")
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
  
引用方式:[name][id]
[id]: http://example.com/  "Optional Title Here"
This is [an example][id] reference-style link.

显示效果:

This is an example inline link.

This link has no title attribute.

This is an example reference-style link.

3.7关键字(Keyword)


Markdown将*和_作为重点文字的标记符号,例如:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

显示效果:

single asterisks

single underscores

double asterisks

double underscores

3.8.图片(Photo)


不可否认,设计一种“自然”语言来将图片插入到文本文档是相当困难的,Markdown使用图片插入的语法类似于超链接的语法,同样地支持两种方式插入图片:内联和引用;

内联插入图片的语法:

![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")

显示效果:

系统拓扑图

4.总结

到此为止,我也已经掌握了Markdown的基本语法,来开始你们的创造吧;

展开阅读全文
打赏
0
0 收藏
分享
加载中
更多评论
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部