开始使用Markdown-前端技术|TaoBaoUED

Written with StackEdit

它是什么?

首先,什么是Markdown?我们可以直接看一下Wiki......不过Wiki很长,让人没有耐心读下去。那么,简单来说,Markdown其实是一种轻量级的标记语言;或者说,它规定了一些文本的书写格式中,就像这样:

写上你的标题
==========

开始书写正文吧

当然也可以用 *列表* 的形式:
*  列表项目
*  还是列表项目

上面这一段东西就是Markdown了,--它看上去和普通的文本没什么两样,只不过文字“被一些标记格式化”了,所以看上去会感觉比较漂亮,书面化一点形容词叫做具备更高的可读性

这一段Markdown给我们的直观感受是我们能够清楚地辨识出其中的“标题”、“段落”以及“列表”,对,就和我们熟知的html一样,用来格式化内容

为何使用?

接下来的问题自然是,我们为什么要使用markdown?

我们可以把这个问题进一步拆分为三个问题:

  • 使用markdown而不是html的好处在哪?
  • 在那些场景下使用?
  • 这个东西的普及度如何?(这意味着它的前景)

接下来一一回答:

  • 前文已说,markdown和html都是一路的标记语言,用来格式化内容。而内容之所以要显得格式化,是因为这样我们更容易阅读和理。被渲染后的html是很可读的,但是html代码读起来就很糟糕,因为它夹杂着大量的 < tag >;而markdown不管是读还是写,都很舒服。

有一点想要注意的是,Markdown并不是为了取代Html,因为根本取代不了。Markdown的理念是。能让文档更容易读、写和更改。HTML是一种发布的格式,Markdown是一种书写的格式

最后一点,Markdown可以被编译为Html,比如使用在线的Pandoc

  • 我个人认为,我们在txt上写的文档或随手记之类的东西,就完全可以使用Markdown,简单而且美观。

    另外,最重要的一点,我们可以在 支持把Markdown编译为Html的地方书写Markdown ,好处是显而易见的:书写简单、展现美观。典型的场景有:github仓库的README描述文件、github中的issue、评论框等。总而言之,把它用在要写文档的地方,妥妥的。

  • 我们知道,这世界上还有很多类似于Markdown的轻量级标记语言,比如形形色色的wiki语法。所以,我们凭什么使用Markdown而不是Markup或者Wikidown呢?

    答案很简单,因为它很流行。至少著名的程序员社区如github和stackoverflow都提供了对它的大力支持。

说了这么多,结论就是,学习并且使用Markdown,必须的!何况Markdown学起来非常简单。


语法简要介绍

接下来会非常简单的介绍一下语法,而详细的语法大全可以直接去作者的官网查看。
作者对语法的介绍富有条理且细致入微。

语法介绍之后会着重说一下几个比较给力的特性,这个部分是重点

部分语法如下:

  • 使用一个或多个空行分隔内容段来生成段落。
  • 标题(h1~h6)格式为使用相应个数的“#”作前缀,比如以下的代码表示h3:
   ### this is a level-3 header###
  • 使用“>”作为段落前缀来标识引用文字段落。这其实是Email中标记引用文字的标准方式:
   > 引用的内容 
   > 这个记号直接借鉴的邮件标准
  • 使用“*”“+”“-”来表示无序列表;使用数字加“.”表示有序列表。如:
   1. I am ordered list item 1...
   2. So I should be item 2?
  • 使用4个以上 空格 或一个以上的tab来标记代码段落,它们将被 < pre >和< code >包裹,这以为着代码段内的字体回事monospace家族的,并且特殊符号不会被转义。

  • 使用*或_包裹文字产生Strong效果


给力的特性

  • 普通换行并不产生新的段落或 < br >,但是产生空格。

    其实这个和html对line-break换行的处理方式是一致的。为了使文本良好地展示在视野内,我们会选择手动地将文字拆行,但是这并不意味这这两行在逻辑上不是一个段落。如:

   我
   其实
   是一首
   诗......

   楼上
   这一段
   说得漂亮!
  • 支持setext-style的header定义:

1.定义h1:

THIS IS THE MAIN TITLE
======================

2.定义h2:

THIS IS THE SUBTITLE
--------------------

更低级别的header就无法使用这种方式定义了。我们不用管setext-style是上面意思,只需要知道这种标记方式更能凸显文章标题。

  • 在blockquote (“>”标记的段落)只内可以嵌套使用其他的标签,甚至可以再嵌套blockquote--如效果:

上古神书《商古》写道:

今有一鼎,镌以奇文;

吾乃鼎,非杯具也。

  • 支持引用式的链接格式。什么叫“引用式”的链接呢,举例来说,
    对于本文中的一段文字,相应的mkd代码是:
   首先,什么是markdown?我们可以直接看一下[WIKI] [1]
   另外,markdown可以被编译为html,比如使用在线的[Pandoc] [2]

   [1]: http://en.wikipedia.org/wiki/Markdown
   [2]: http://johnmacfarlane.net/pandoc/try 

看上去就好像是“引用文献”的格式一样,好处显而易见:

  1. 正文中不会出现url链接这种读者不关心的信息,从而不影响读者的阅读

  2. 链接地址可以当作一个变量,进行复用


  • 支持快捷链接。一般来说,我们如果要显示一段url文本,最好也希望这个url本身能够被点击。比如
    http://ued.taobao.com

    如果使用html,则要写作

  <a href="http://ued.taobao.com">http://ued.taobao.com</a>

包含了冗杂的信息且可读性很差,而在mkd中,只要写:

  <http://ued.taobao.com>  

就OK了,非常方便。

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

推荐阅读更多精彩内容