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 自动按照指定的语言进行语法着色。

转自: http://justcoding.iteye.com/blog/1954655

Markdown 的基本语法

时间: 2024-10-03 10:07:09

Markdown 的基本语法的相关文章

Cmd Markdown编辑器简明语法手册

1. 斜体和粗体 使用 * 和 ** 表示斜体和粗体. 示例: 这是 斜体,这是 粗体. 2. 分级标题 使用 === 表示一级标题,使用 --- 表示二级标题. 示例: ``` 这是一个一级标题 这是一个二级标题 这是一个三级标题 ``` 你也可以选择在行首加井号表示不同级别的标题 (H1-H6),例如:# H1, ## H2, ### H3,#### H4. 3. 外链接 使用 [描述](链接地址) 为文字增加外链接. 示例: 这是去往 本人博客 的链接. 4. 无序列表 使用 *,+,-

Markdown试用及语法

Markdown 是一个 Web 上使用的文本到HTML的转换工具,可以通过简单.易读易写的文本格式生成结构化的HTML文档. 昨天想找个简单好用的笔记工具,查了下发现这个看着不错,而且三星上的印象笔记之前并不怎么用,但MarkDown的其中一款编辑工具--马克飞象--提供对印象笔记的支持,所以试着用了一下,确实很不错,简单的编辑笔记类文档足够了. 因为想反正是试试功能,干脆就找了好多的MarkDown编辑器一一试了一下: 1.MaHua 在线markdown编辑器  --点击打开新窗口 Mar

5.markdown入门常用语法

原文地址:https://www.jianshu.com/p/q81RER/ 「简书」作为一款「写作软件」在诞生之初就支持了 Markdown,Markdown 是一种「电子邮件」风格的「标记语言」,我们强烈推荐所有写作者学习和掌握该语言.为什么?可以参考: 『为什么作家应该用 Markdown 保存自己的文稿』. 『Markdown写作浅谈』 在此,我们总结 Markdown 的优点如下: 纯文本,所以兼容性极强,可以用所有文本编辑器打开. 让你专注于文字而不是排版. 格式转换方便,Markd

Typora+markdown 最常用语法教程

Typora+markdown 最常用语法教程(by 程序员宝藏) Typora+markdown 最常用语法教程(by 程序员宝藏) 请先配置推荐配置(文件->偏好设置): 文章目录 Typora+markdown 最常用语法教程(by 程序员宝藏) 第一章 块元素 1.1 标题 1.2 引用 1.3 列表 1.4 任务列表 1.5 代码块 1.6 表格 1.7 横线 1.8 目录(Table of Contents -- TOC) 第二章 Span元素 2.1 链接 2.2 图片 2.3 高

一张图5分钟熟悉MarkDown的基本语法

看到zealer上面有介绍MarkDown的,以前在老罗的发布会也听说过,说锤子便签支持MarkDown,但是不知道有什么用,现在来看看,确实不错. MarkDown的好处是让你可以专注于写字本身,而不需要经常动鼠标或者动手指去排版. 我在网上找到了一个MarkDown简单语法的介绍文章,我花了半个小时学习了一下,然后将里面的核心内容总结成了一张图,这样更加清晰明了. 我相信你只需要花5分钟就能记住这些语言特性,因为它确实足够简单.如果怕忘了,可以存一下这张图. 参考资料: 认识与入门 Mark

[转]Haroopad Markdown 编辑器代码语法高亮支持

代码语法高亮 书写格式为: ` ` ` language_key if (condition){ return true } ` ` ` 在 ` ` ` (三个反引号)之间的是代码,其中language_key的值,请参考 支持的语言和缩写标记 例如,将language_key用JavaScript替换,效果如下: if (condition){ return true } 支持的语言和缩写标记 Language language_key 1C 1c ActionScript actionscr

【README.md】Markdown语言常用语法

转自:http://blog.csdn.net/zhaokaiqiang1992 这里只介绍最常用和最常见的功能,若想查看全部的语法,请移步http://wowubuntu.com/markdown/index.html (1)标题 标题使用不同数量的"#"来标识是什么层级,可以对应于HTML里面的H1-H6,下面是示例代码和效果 "========"风格的也可以,但是我不喜欢,赶不上"#"的好用 (2)图片 我们可以使用下面的语法,添加一个图片

GitHub中的Markdown MD文件 语法

GitHub中的README.MD文件编写语法 在线体验网站:https://www.zybuluo.com/mdeditor 出处信息 GitHub中的README文件,使用markdown格式的文件.这种文件语法比较简单,特别容易上手. Markdown的语法简洁明了.学习容易,而且功能比纯文本更强,因此有很多人用它写博客.世界上最流行的博客平台WordPress和大型CMS如joomla.drupal都能很好的支持Markdown. 下面简单介绍下相关语法: 大标题: ==========

Markdown的基本语法

本文转自:https://github.com/jiangsc93/Markdown-Introduce.git Markdown是一种纯文本格式的标记语言.通过简单的标记语法,它可以使普通文本内容具有一定的格式. 相比WYSIWYG编辑器 优点: 因为是纯文本,所以只要支持Markdown的地方都能获得一样的编辑效果,可以让作者摆脱排版的困扰,专心写作. 操作简单.比如:WYSIWYG编辑时标记个标题,先选中内容,再点击导航栏的标题按钮,选择几级标题.要三个步骤.而Markdown只需要在标题