Markdown 简洁入门

于 2012年06月4日 发布在 linux应用 跳到评论

最近折腾github比较多,在里面看到很多用Markdown的地方,比如wiki页面编辑,README.md文件,progit,感觉他是一个十分简单的标记语言,于是就打算学学。

Markdown的目标是实现“易读易写”,语法的目标是,“成为一种适用于网络的书写语言”。在写文档或者blog的时候可以避免一些排版上的苦恼。Markdown可以方便地转换为HTML,有对应关系,但他比HTML来的方便,因为不用考虑成对的标签。如果某些Markdown有某些标签没有实现,我们可以在文本中直接使用HTML语言。

在介绍语法之前,现在介绍一款chrome插件 – MaDe,此插件可以在页面右侧实时现实效果,很方便。如果对某些东西有疑惑,试验一下即可:)

标题

标题一般用在标题前用#来替代,几个#就代表<h*>,比如###代表<h3>,上面标题两个字就是用以下代码实现的(输到MaDe上试试~亲~):

### 标题

他转换为HTML就是:

<h3>标题</h3>


段落

段落一般是用空行分隔的。比如你输入以下代码:

This is first paragraph This is second paragraph

可以看出他俩在一行上面了,再中间加一个空行

This is first paragraph

This is second paragraph

这个时候就分开了。所以说如果两行文字不再同一个段落内,用一个空行隔开就行,清晰明了。


引用

在行前面加>就行,注意引用>和标题#后面最好跟个空格,以免出现不必要的解析错误,包括接下来的几个符号都要注意。


强调

就是<em><strong>标签,示例如下:

I like this *强调* _haha_

I like this __ 很强调 __ **hahahahah**

以上代码会得到如下效果

I like this 强调 haha

I like this 很强调 hahahahah

注意_和*都要紧贴这需要强调的词语和句子。


列表

对于无序列表,我们需要在每行前面加*+或者-,然后紧跟一个空格。他们效果都一样:

* dang

+ wen

- liang

生成

  • dang
  • wen
  • liang

对于有序列表,需要把’*’,’_’,’+’替换成序号+’.’,如下

1. dang

2. wen

3. liang

生成:

1. dang

2. wen

3. liang

记得.后面要加空格!~


链接

这里只介绍最简单的形式:[链接文字](链接地址 "title"),里面的“title”是可选的。

[fookwood](http://fookwood.com)

得到的形式为

fookwood

如果加上title,则可以得到:

[fookwood](http://fookwood.com "My Site")

得到的形式为(鼠标指向链接的时候会有标题)

fookwood


图片

图片类似于链接。形式为![alt text](/path/to/img.jpg "Title"),不再举例。


代码

`可以方便地标记出html代码,不用受转意的困扰,比如说 <h1> 是不能直接显示<h1>的,需要用`<h1>` 的形式

以上全部由WP-Markdown完成,着实有点蛋疼,他的解释方式还不是很明了(个人感觉空格空行会噪声很大误差)。不过习惯了应该就好多了吧。我感觉我会慢慢退化到用HTML去写blog。。(依稀记得社交网络里面Zuckerberg打下<p>的画面)。。

附参考资料:

Markdown: Basics (快速入门)
Markdown 语法说明 (简体中文版)

本文共有 6条评论 | 沙发:文章评论

  1. acmol说道:

    * 我下了个[1]库,下完之后发现里面介绍说能直接放到wp里当插件用..
    * 试验一下评论里能发markdown标记不
    * 呃,顺带试一下带个链接会不会跑到垃圾评论里..
    * 另,现在用linux用习惯了,在你上面写邮件地址,网站地址时,一看到有提示,下意识按了tab自动补全..

    [1]:http://michelf.com/projects/php-markdown/

  2. […] 在我设计并写了一点点代码之后,与fookwood聊天的过程中,被他提醒,有种语言叫markdown,可以很方便的生成html,并且写出的源码也是方便可读的。比如下面一段源码将会被转化成对应的我们想要的html […]

留下评论!

:wink: :twisted: :roll: :oops: :mrgreen: :lol: :idea: :evil: :cry: :arrow: :?: :-| :-x :-o :-P :-D :-? :) :( :!: 8-O 8)