Markdown快速入门

tsl0922 发布于 2012/10/18 19:55
阅读 14K+
收藏 70

Markdown 是一种轻量级标记语言,创始人为 John Gruber 和 Aaron Swartz。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML/HTML 文档”

OSC 博客已支持使用Markdown书写,可以在发表博文的时候点编辑器右上方的切换按钮一键切换编辑器或者到 空间管理-博客管理-博客设置 处设置默认编辑器。

本文简单介绍下 Markdown 的基本语法,让初学者可以快速入门并使用这种标记语言。

标题

标题(h1~h6)可使用相应个数的#来生成,如下面的代码将会生成h3:

### this is a level-3 header ###

或者使用底线形式,利用=(最高阶标题)和-(第二阶标题):

This is an H1
=============

This is an H2
-------------

段落和换行

使用一个或多个 空行 分隔内容段来生成段落 (<p>)
在行末输入2个或以上 空格 再回车来生成换行(<br>)

强调

1个*或_包围起来的文字将会被<em>标签包围:

*single asterisks*

_single underscores_

2个*或_包围起来的文字将会被<strong>标签包围:

**double asterisks**

__double underscores__

注:如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号。

分隔线

在一行内使用3个以上的*-或_来建立 分隔线 (<hr>),行内除此之外不能有其它内容:

* * *

***

*****

- - -

---------------------------------------

区块引用

使用>作为段落前缀来标识引用文字段落。这其实是 email 中标记引用文字的标准方式:

> 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.

列表

使用*+-来表示无序列表<ul>:

* Red
* Green
* Blue

使用数字紧跟一个 英文句点 .来表示有序列表ol:

1. Bird
2. McHale
3. Parish

代码

使用 反引号 (`)(在键盘上位于1的左边)把文字括起来来表示行内代码,这段文字将会被<code>标签包围:

Use the `printf()` function.

使用4个 空格1个 制表符 (Tab)缩进来表示代码区块,它们将被<pre>和<code>标签包裹起来,在代码区块里面的&<和>会自动转成 HTML 实体:

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

链接

行内式语法:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

参考式语法:

This is [an example][id] reference-style link.

  [id]: http://example.com/  "Optional Title Here"

注:下面的链接定义,你可以把它放到文章的任意位置。

自动链接:

<http://example.com/>

隐式链接标记:

I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][].

  [google]: http://google.com/        "Google"
  [yahoo]:  http://search.yahoo.com/  "Yahoo Search"
  [msn]:    http://search.msn.com/    "MSN Search"

图片

图片的语法和链接比较相似,也有 行内式参考式 两种。
行内式语法:

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

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

参考式语法:

![Alt text][id]

  [id]: url/to/image  "Optional title attribute"

注:到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的<img>标签。

转义字符

可以利用反斜杠来插入一些在语法中有其它意义的符号:

\*literal asterisks\*

Markdown支持的转义字符列表:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

其它

书写表格: Markdown 并没有提供表格语法,但你可以像写 HTML 那样使用标签来书写表格,但要注意 HTML 标签内的 Markdown 表达式将不会被解析。
代码高亮: 这不在Markdown支持的范围之内,OSC 的 Markdown 编辑器支持代码高亮,你可以在代码上方使用<!--lang: java-->或lang: java的形式来指定编程语言,这样文章在显示的时候会使用 SyntaxHighlighter 自动按照指定的语言进行语法着色。

Markdown资源

  1. Markdown 项目主页
  2. Markdown 语法说明(中文版)
  3. Markdown 工具:

暂时就这么多吧,欢迎大家继续补充!

加载中
0
FoxHu
FoxHu


OSC 博客已支持使用Markdown书写,可以在发表博文的时候点编辑器右上方的切换按钮一键切换编辑器或者到 空间管理-博客管理-博客设置 处设置默认编辑器。


@tsl0922  怎么没有找到啊?
FoxHu
FoxHu
回复 @tsl0922 : 哦,支持osc,期待...
tsl0922
tsl0922
服务器还没更新,稍等一晚,明天就有了,亲!
0
xyz555
xyz555
这个和n年前的ubb代码类似,ubb是n年前还没有所见即所得的在线编辑器时最流行的东西。
0
向上的丁子
向上的丁子

能讲讲在Markdown中这个

OSC 的 Markdown 编辑器支持代码高亮,你可以在代码上方使用 <!--lang: java--> 或 lang: java 的形式来指定编程语言,这样文章在显示的时候会使用 SyntaxHighlighter 自动按照指定的语言进行语法着色。
或者这个

怎么实现的吗?

0
rkikbs
rkikbs
有没有一篇文章内的链接?相当于html的锚,或者类似word中的目录,点击目录直接进入本文对应的位置。
0
harttle
harttle

希望能自定义CSS,或者提供几个主流的CSS,比如github上的或者markdownpad的,默认的太丑了,最主要的是层次不分明

0
arniu
arniu
补充一下,windows下的工具还有 EverEdit ,无意中发现的,很强悍,私以为比楼主提供的两个要好一点~
0
苗哥
苗哥
我想问下,那個无序列表的写法中,星号和后面的字符之间是两個空格嘛,还是壹個Tab键啊,为什么我写的无序列表在博客编辑器的预览窗口里没有正常显示出来呢,全部都是没有格式的纯文本,连成壹片?
苗哥
苗哥
回复 @tsl0922 我已经把星号和后面的字符串之间修改为只有壹個空格了,但是博客里面 Markdown 编辑器的预览视图仍然显示为没有格式的乱序文字,而 Markdown 在线工具编辑器里的预览视图却是有格式的,为什么同样的代码预览的效果还不壹样呢,能否把博客编辑器里的那個预览功能修改下?
tsl0922
tsl0922
一个空格
0
苗哥
苗哥
终于知道怎么用无序列表了,必须把无序列表中的星号与字符串说明之间放壹個英文半角空格,然后在第壹個列表节点开始之前和最后壹個列表节点之后都需要加壹個空行,这样才能正常显示出来。费了很大力气才尝试出来。
0
Skyoojaa懒猴
Skyoojaa懒猴
虽然我不知道该在这里留言,不过还是想问一句。啥时候可以在写博客的页面加入自动保存啊!已经吃了不止一次亏了。
0
TerranYiu
TerranYiu

引用来自“冯春侯”的答案

虽然我不知道该在这里留言,不过还是想问一句。啥时候可以在写博客的页面加入自动保存啊!已经吃了不止一次亏了。

最好不要直接在线写,如果非要在线写markdown,推荐这个:http://www.zybuluo.com/mdeditor

有自动保存,还支持github风格markdown语法。

Skyoojaa懒猴
Skyoojaa懒猴
很有用,谢谢
返回顶部
顶部