markdown极简快速上手教程

浏览:7037次阅读
没有评论

共计 1567 个字符,预计需要花费 4 分钟才能阅读完成。

简单的 markdown 快速教程, 整理下; 供参考...

  • Markdown 是什么?
  • 怎么使用 Markdown?

Markdown 是什么?

Markdown是一种轻量级 标记语言 ,它以纯文本形式( 易读、易写、易更改 ) 编写文档,并最终以 HTML 格式发布。

Markdown也可以理解为将以 MARKDOWN 语法编写的语言转换成 HTML 内容的工具

为什么 要使用它?

  • 它是易读(看起来舒服)、易写(语法简单)、易更改 纯文本 。处处体现着 极简主义 的影子。
  • 兼容 HTML,可以转换为 HTML 格式发布。
  • 跨平台使用。
  • 越来越多的网站支持 Markdown。
  • 更方便清晰地组织你的电子邮件。(Markdown-here, Airmail)
  • 摆脱 Word。

如果不算 扩展 ,Markdown 的语法绝对 简单 到让你爱不释手。

Markdown 语法

Markdown 语法主要分为如下几大部分:

标题 段落 区块引用 代码区块 强调 列表 分割线 链接 图片 反斜杠 \符号 '`'

3.1 标题

两种形式:

1)使用 =-标记一级和二级标题。

一级标题
=========
二级标题
---------

效果:

二级标题

2)使用#,可表示 1 - 6 级标题。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果:

二级标题

三级标题

四级标题

五级标题
六级标题

3.2 段落

段落的前后要有空行,所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用 两个以上 空格加上回车(引用中换行省略回车)。

3.3 区块引用

在段落的每行或者只在第一行使用符号>, 还可使用多个嵌套引用,如:

> 区块引用
>> 嵌套引用

效果:

区块引用

嵌套引用

3.4 代码区块

代码区块的建立是在每行加上 4 个空格或者一个制表符(如同写代码一样)。如
普通段落:

void main()
{
printf("Hello, Markdown.");
}

代码区块:

void main()
{printf("Hello, Markdown.");
}

下面是 Python 代码举例:

# 这里打印 Python 之禅
import this
print(this)

注意: 需要和普通段落之间存在空行。

3.5 强调

在强调内容两侧分别加上 * 或者_,如:

* 斜体 *,_斜体_
** 粗体 **,__粗体__

效果:

斜体 斜体
粗体 粗体

3.6 列表

使用 ·+、或- 标记无序列表,如:

-(+*)第一项
-(+*)第二项
-(+*)第三项

注意 :标记后面最少有一个 空格 制表符。若不在引用区块中,必须和前方段落之间存在空行。

效果:

  • 第一项
  • 第二项
  • 第三项

有序列表的标记方式是将上述的符号换成数字, 并辅以.,如:

1 . 第一项
2 . 第二项
3 . 第三项

效果:

  1. 第一项
  2. 第二项
  3. 第三项

3.7 分割线

分割线最常使用就是三个或以上 *,还可以使用-_

3.8 链接

链接可以由两种形式生成:行内式 参考式
行内式

[www.forvs.com 地址](https:://www.forvs.com "IT 小工匠")。

效果:

IT 小工匠 地址

参考式

[IT 小工匠 1][1]
[IT 小工匠 2][2]
[1]:https://www.forvs.com "IT 小工匠"
[2]:https://www.forvs.com "IT 小工匠"

效果:

IT 小工匠地址 1
IT 小工匠地址 2

注意 :上述的https://www.forvs.com "IT 小工匠" 不出现在区块中。

4.9 图片

添加图片的形式和链接相似,只需在链接的基础上前方加一个

4.10 反斜杠\

相当于 反转义 作用。使符号成为普通符号。

4.11 符号 '`'

起到标记作用。如:

`ctrl+a`

效果:

ctrl+a

谁在用?

Markdown 的使用者:
* 微信公众号
* GitHub
* 简书
* Stack Overflow
* Apollo
* Moodle
* Reddit
* 博客园
* 等等

建议大家可以花点时间学习下基础的 Markdown 语法, 对于后期的文档编写便捷性很有帮助;

正文完
 0
(未见秋)
版权声明:本站原创文章,由 (未见秋) 于2021-12-02发表,共计1567字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。