Markdown - RedFalsh/Wiki GitHub Wiki

#Markdown语法

#导语 Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑,Markdown 的语法十分简单。常用的标记符号也不超过十个,这种相对于更为复杂的 HTML 标记语言来说,Markdown 可谓是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。

##认识 Markdown

###Markdown 文档

1.语法示例

#2使用 Markdown 的优点

  • 专注你的文字内容而不是排版样式,安心写作。
  • 轻松的导出 HTML、PDF 和本身的 .md 文件。
  • 纯文本内容,兼容所有的文本编辑器与字处理软件。
  • 随时修改你的文章版本,不必像字处理软件生成若干文件版本导致混乱。
  • 可读、直观、学习成本低。
  • Markdown 旨在简洁、高效,也由于 Markdown 的易读易写,人们用不同的编程语言实现了多个版本的解析器和生成器,这就导致了目前不同的 Markdown 工具集成了不同的功能(基础功能大致相同),例如流程图与时序图,复杂表格与复杂公式的呈现,虽然功能的丰富并没有什么本质的缺点,但终归有些背离初衷,何况在编写的过程中很费神,不如使用专业的工具撰写来的更有效率,所以如果你需实现复杂功能,专业的图形界面工具会更加方便。当然,如果你对折腾这些不同客户端对 Markdown 的定制所带来高阶功能感到愉悦的话,那也是无可厚非的。

##二,Markdown 语法的简要规则

###标题 标题是每篇文章都需要也是最常用的格式,在 Markdown 中,如果一段文字被定义为标题,只要在这段文字前加 # 号即可。

# 一级标题

## 二级标题

### 三级标题

以此类推,总共六级标题,建议在井号后加一个空格,这是最标准的 Markdown 语法。 ###效果如下:

一级标题

二级标题

三级标题

###列表 熟悉 HTML 的同学肯定知道有序列表与无序列表的区别,在 Markdown 下,列表的显示只需要在文字前加上 - 或 * 即可变为无序列表,有序列表则直接在文字前加1. 2. 3. 符号要和文字之间加上一个字符的空格。

* 1

* 2

* 3

1.一

2.二

3.三

###效果如下:

  • 1
  • 2
  • 3

1.一

2.二

3.三

##引用 只需要在文本前加入 > 这种尖括号(大于号)即可

> 你闹啥子闹哦

###效果如下:

你闹啥子闹哦

##图片与链接

插入链接与插入图片的语法很像,区别在一个 !号

图片为:![](){ImgCap}{/ImgCap}

链接为:[]()

插入图片的地址需要图床,这里推荐围脖图床修复计划 与 CloudApp 的服务,生成URL地址即可。

##粗体与斜体

Markdown 的粗体和斜体也非常简单,用两个 * 包含一段文本就是粗体的语法,用一个 * 包含一段文本就是斜体的语法。

*这里是粗体*

*这里是斜体

###效果如下:

这里是粗体

这里是斜体

##表格

| Tables | Are | Cool |

| ------------- |:-------------:| -----:|

| col 3 is | right-aligned | 600 |

| col 2 is | centered | 2 |

| zebra stripes | are neat | |

###效果如下:

Tables Are Cool
col 3 is right-aligned 600
col 2 is centered 2
zebra stripes are neat

##代码框

如果你是个程序猿,需要在文章里优雅的引用代码框,在 Markdown下实现也非常简单,只需要用两个 ` 把中间的代码包裹起来。使用 tab 键即可缩进。

效果:

print('this is a test!')

##分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线: * * *

***

*****

- - -

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

⚠️ **GitHub.com Fallback** ⚠️