开始使用 Markdown

(Xee:我最近感觉nyfedit打开有点慢,数据库有点大,试想着用一些其他的方式记录一下学习的过程,才想起了遗忘了很长时间的Markdown,将其分类在HTML下,也是我原本意愿的...)

本文面向不了解 markdown 或刚准备上手的同学。

它是什么

首先,什么是 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 学起来非常简单

语法简要介绍

接下来会非常简单地介绍一下语法,而详细的语法大全可以直接去 作者的官网 查看。

作者对语法的介绍富有条理且细致入微。

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

部分语法如下:

  • 使用一个或多个空行分隔内容段来生成段落 <p>
  • 标题(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 个以上 空格或 1 个以上 的 tab 来标记代码段落,它们将被

    <pre><code> 包裹,这意味着代码段内的字体会是 monospace

    家族的,并且特殊符号不会被转义。

    1. 使用 [test](http://example.net "optional title") 来标记普通链接。
    2. 使用 ![img](http://example.net/img.png "optional title") 来标记图片。

    引号内的 title 文字是可选的,链接也可以使用相对路径。

  • 使用 * 或 _ 包裹文本产生 strong 效果:
    _语气很重的文本_ 以及 **语气更重的文本**
    

给力的特性

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

    其实这个和 html 对 line-break 换行 的处理方式是一致的。为了使文本良好地展示在视野内,

    我们会选择 手动地 将文字折行,但是并不意味着这两行在逻辑上不是一个段落。

    我们也可以插入真正的手动换行符 <br>,如果要问 <br> 在什么时候有用,下面是一个例子:

    其实

    是一首

    诗……

    楼上

    这一段

    说得漂亮!

  • 支持 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   "wiki_markdown"
    [2]:    http://johnmacfarlane.net/pandoc/try    "pandoc online"
    

    看上去就好像是“引用文献”的格式一样。好处非常易见:

    • 正文文本中不会出现 url 链接这种读者不关心的信息,从而不影响读者的阅读;
    • 链接地址可以当做一个变量,进行复用 ;
  • 支持快捷链接。一般来说,我们如果要显示一段 url 文本,最好也希望这个 url本身能够点击。比如 http://ued.taobao.org

    如果使用 html,则要写作

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

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

    <http://ued.taobao.org>
    

    就 OK 了,非常方便。

结尾

以上便是对 markdown 的一个简要介绍了,需要了解进一步内容的,请移步

<参考:http://ued.taobao.org/blog/2012/07/getting-started-with-markdown/>

时间: 2024-08-26 06:49:55

开始使用 Markdown的相关文章

转 - markdown简明语法

Markdown是一种极简的『标记语言』,将文本转为HTML,通常为我大码农所用.其不追求大而全,简洁至上,正所谓不求最贵,只求最好! 本文介绍Markdown基本语法,内容很少,一行语法一行示例,学会后可轻松写出高大上的文档,再也不需要各种编辑器去调文章格式.另外,网上有各平台下的Markdown工具可用,也有在线的,我直接使用sublime搞定,Markdown本来就是为了追求简洁,弄个工具岂不多此一举. 强调 星号与下划线都可以,单是斜体,双是粗体,符号可跨行,符号可加空格 **一个人来到

markdown常用语法总结

markdown是一种清亮型的标记型语言.它允许人们"使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档",Markdown也已经被其他人用Perl和别的编程语言重新实现.      Markdown的语法简洁明了.学习容易,而且功能比纯文本更强,因此有很多人用它写博客.世界上最流行的博客平台WordPress和大型CMS如joomla.drupal都能很好的支持Markdown.       以上两句是分别从维基百科和百度百科down下来的对于markd

MarkDown案例

Welcome to MarkdownPad 2 MarkdownPad is a full-featured Markdown editor for Windows. Built exclusively for Markdown Enjoy first-class Markdown support with easy access to Markdown syntax and convenient keyboard shortcuts. Give them a try: Bold (Ctrl+

markdown 书写代码

最近基于github + hexo 搭建了自己的博客,开始用markdown写博客,推荐 mac 平台用 mou 这个软件或者 vim. 介绍下markdown语法插入代码的规则: 有一种方法是所有代码之前空四个格就自动识别为代码了,但是这样没有行号,可以自己写个程序处理,但是比较麻烦,而且强行插入行号可能会出现显示问题. 还有一种方法比较好.比如添加以下代码: ``` c #include <stdio.h> int main(void) { printf("hello markd

Markdown(editormd)语法解析成html

我们在一些网站中可以见到一款网页编辑器--markdown: 这是一款功能强大的富文本编辑器,之前自己在网页上使用的时候遇到了一点点的问题,现在跟大家分享下 在我们写了文章之后是需要将内容保存到数据库的,如果保存到数据库中要方便以后需改的话,那么需要保存成markdown语言,如果保存成html语言通过反向解析成markdown这个可能效果不是很好 如果保存成markdown就涉及到将数据库中的数据取出后要解析成html,以下便是我的解决过程(我使用的是editormd): 首先需要初始化从ma

Markdown简单使用

Markdown 是一种轻量级的标记语言,由John Gruber和Aaron Swartz创建,兼容HTML.它可以快速构建一个具有一个格式的文本文件,其易读易写的特性吸引很多人使用它. 目前普遍使用文本编辑器来书写一个Markdown文件,关于编辑器的选择每个人有自己的使用习惯,本人使用的是Typora这个简洁的跨平台的随写随看的Markdown编辑器. Markdown简单使用: 标题 在内容前加#, #的个数代表标题的级数(当然也可以在标题内容的前后加上等数量的#) 引用 内容前加 >

[转]有道云笔记markdown

作为半个文字工作者,一天当中,一半时间用在遣词造句,一半时间则在死磕排版.当听说"前所未有的极简语法"Markdown,不仅能简化排版.大大提高书写效率,而且上手零门槛.好奇宝宝怎么忍得住一颗蠢蠢欲动的心? 从未接触过代码的门外汉,初次听说Markdown,脑子是空的.但如果愿意抽5分钟,看下这篇文章--了解Markdown是什么.能干什么.对码字的你有什么益处:再打开有道云笔记,抽出10分钟对照Markdown简明教程加以练习. 15分钟,你就能掌握一门极客圈最流行的文本编辑语言~

Markdown 语法说明

NOTE: This is Simplelified Chinese Edition Document of Markdown Syntax. If you are seeking for English Edition Document. Please refer to Markdown: Syntax. 声明: 这份文档派生(fork)于繁体中文版,在此基础上进行了繁体转简体工作,并进行了适当的润色.此文档用 Markdown 语法编写,你可以到这里查看它的源文件.「繁体中文版的原始文件可以

如何流利的使用markdown编辑器项目,

最近在学习如何使用markdown来写文章,目前自己选用的是 chrome 浏览器中的 马克飞象(不过没有购买付费版),在网上寻找markdown语法的时候注意到csdn博客的markdown编辑器还不错 http://blog.csdn.net/xiongjiamu/article/details/68933692 他们的编辑器是editor.md,一个开源的项目,github地址如下: http://pandao.github.io/editor.md/

markdown常用语法

markdown是一种text-to-html标记语言,使用它可以突出内容,凸现可读性,而抛掉html 不易读的特点.markdown文件后缀名为.md 特性 标题 markdown 支持六级标题,一级标题用#表示,二级标题用##表示,依次类推逐渐变小.如:#Foo : Foo ###Foo : Foo 斜体 斜体即强调,用*文字*表示,如文字 加粗 用**文字**表示,如文字 删除线 用~~文字~~表示,如文字 列表 有序列表,顾名思义可以自动标明顺序.用1. 2. 表示序号紧跟英文句号.然后