一文快速入门Markdown文档-建站技术-A8云站长
A8云站长 - 助力个人站长低成本网络创业!

一文快速入门Markdown文档

内容提要:#

Markdown

1. Markdown 是什么?

Markdown 是一种轻量级的标记语言,可用于在纯文本文档中添加格式化元素。Markdown 由 John Gruber 于 2004 年创建,如今已成为世界上最受欢迎的标记语言之一。

  1. Markdown 处处可用。人们使用它来创建 网站、文档、便签、书籍、演示文稿、邮件 和 技术文档。
  2. Markdown 是可移植的。几乎可以使用任何应用程序打开包含 Markdown 格式的文本文件。如果你不喜欢当前使用的 Markdown 应用程序了,则可以将 Markdown 文件导入另一个 Markdown 应用程序中。这与 Microsoft Word 等文字处理应用程序形成了鲜明的对比,Microsoft Word 将你的内容锁定在专有文件格式中。
  3. Markdown 是独立于平台的。你可以在运行任何操作系统的任何设备上创建 Markdown 格式的文本。

基本语法

2. 标题(Headings)

要创建标题,请在单词或短语前面添加井号 (#) 。井号的数量代表了标题的级别。
例如,添加三个井号即创建一个三级标题 (h3) (例如:### My Header)。
h1-h6对应着一个#至6个#,例如#,## ,###,####,#####,######,在所有的标记后面要用空格隔开才可以激活。
还可以在文本下方添加任意数量的 == 号来标识一级标题,或者 -- 号来标识二级标题。 例如:

Heading level 1

渲染结果:

Heading level 1

Heading level 2

3. 段落(Paragraphs)

要创建段落,请使用空白行将一行或多行文本进行分隔。

这是一段话。

这又是另外的一段话。

除非 段落在列表中,否则不要用空格(spaces)或制表符( tabs)缩进段落。(也就是说一般情况是不需要首行空格,需要顶格书写)

4. 换行(Line Breaks)

在一行的末尾添加两个或多个空格,然后按回车键(return),即可创建一个换行(line break)或新行 (br)。
几乎每个 Markdown 应用程序都支持两个或多个空格进行换行 (称为 “结尾空格(trailing whitespace)”) 的方式,但这是有争议的,因为很难在编辑器中直接看到空格,并且很多人在每个句子后面都会有意或无意地添加两个空格。
由于这个原因,你可能需要使用除结尾空格以外的其它方式来进行换行。如果你所使用的 Markdown 应用程序 支持 HTML 的话,你可以使用 HTML 的 br 标签来实现换行。为了兼容性,请在行尾添加“结尾空格”或 HTML 的 br 标签来实现换行。

5. 强调(Emphasis)

通过将文本设置为粗体或斜体来强调其重要性。

粗体(Bold)
要加粗文本,请在单词或短语的前后各添加两个星号(asterisks) 或下划线 _ _(underscores)。

如需加粗一个单词或短语的中间部分用以表示强调的话,请在要加粗部分的两侧各添加两个星号(asterisks)。

例如:双星号加粗 | 双下划线加粗

为兼容考虑,在单词或短语中间部分加粗的话(一句话中的局部加粗),请使用星号

斜体(Italic)
要用斜体显示文本,请在单词或短语前后添加一个星号(asterisk)或下划线(underscore)。要斜体突出单词的中间部分,请在字母前后各添加一个星号,中间不要带空格。

例如:单星号倾斜文字

为了兼容起见,请用星号标注单词中间的斜体来表示着重。

粗体(Bold)和斜体(Italic)
要同时用粗体和斜体突出显示文本,请在单词或短语的前后各添加三个星号或下划线。要加粗并用斜体显示单词或短语的中间部分,请在要突出显示的部分前后各添加三个星号,中间不要带空格。

所有的为了兼容,请使用*处理,不要用下划线。

6. 块引用(Blockquotes)

要创建块引用,请在段落前添加一个 > 符号

例如:

引用一段文字放在这里

多个段落的块引用(Blockquotes)
块引用可以包含多个段落。为段落之间的空白行各添加一个 > 符号

Dorothy followed her through many of the beautiful rooms in her castle.

The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

嵌套块引用(Nested Blockquotes)
块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号。以此类推

最外面一层

中间一层

最里面一层

带有其它元素的块引用(Blockquotes with Other Elements)
块引用可以包含其他 Markdown 格式的元素。并非所有元素都可以使用,你需要进行实验以查看哪些元素有效。

这里就是与标题元素组合使用

-这是与项目符号组合-

-Profits were higher than ever.-

这里 就是与强调元素组合使用

好文章,需要你的鼓励
赞一个(0

标签:
原文链接:本站
转载请保留链接:一文快速入门Markdown文档站长联系QQ:9029855,邮箱为QQ邮箱。
评论
评论列表
共有 0 条评论