前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >HOW TO USE MARKDOWN

HOW TO USE MARKDOWN

作者头像
小飞侠xp
发布2018-08-29 15:14:16
6380
发布2018-08-29 15:14:16
举报
文章被收录于专栏:书山有路勤为径

由于最近打算写一些文章,鉴于Markdown对文章排版的便利,特此学习了一下如何使用。 在此,我们总结 Markdown 的优点如下:

  • 纯文本,所以兼容性极强,可以用所有文本编辑器打开。
  • 让你专注于文字而不是排版。
  • 格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。
  • Markdown 的标记语法有极好的可读性。

标题

而在 Markdown 中,你只需要在文本前面加上 # 即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加 # 即可,标题字号相应降低。例如:

代码语言:javascript
复制
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题 

注:# 和「一级标题」之间建议保留一个字符的空格,这是最标准的 Markdown 写法。

列表

列表格式也很常用,在 Markdown 中,你只需要在文字前面加上 - 就可以了,例如:

代码语言:javascript
复制
- 文本1
- 文本2
- 文本3

如果你希望有序列表,也可以在文字前面加上 1. 2. 3. 就可以了,例如:

代码语言:javascript
复制
1. 文本1
2. 文本2
3. 文本3

注:-、1.和文本之间要保留一个字符的空格。

image.png

插入链接/图片

在 Markdown 中,插入链接不需要其他按钮,你只需要使用 [显示文本](链接地址)这样的语法即可,例如:

代码语言:javascript
复制
[简书](http://www.jianshu.com)

在 Markdown 中,插入图片不需要其他按钮,你只需要使用[图片上传失败...(image-f085c0-1512915401065)]这样的语法即可,例如:

代码语言:javascript
复制
![helloword.gif](http://upload-images.jianshu.io/upload_images/8789591-3283ce98dc43231e.gif?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

注:插入图片的语法和链接的语法很像,只是前面多了一个 !。

引用

在我们写作的时候经常需要引用他人的文字,这个时候引用这个格式就很有必要了,在 Markdown 中,你只需要在你希望引用的文字前面加上 >就好了,例如:

代码语言:javascript
复制
> 一盏灯, 一片昏黄; 一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

注:> 和文本之间要保留一个字符的空格。 最终显示的就是:

一盏灯, 一片昏黄; 一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

粗体和斜体

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

代码语言:javascript
复制
*一盏灯*, 一片昏黄;**一简书**, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

最终显示的就是下文,其中「一盏灯」是斜体,「一简书」是粗体: 一盏灯, 一片昏黄;一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

代码引用

需要引用代码时,如果引用的语句只有一段,不分行,可以用 ` 将语句包起来。 如果引用的语句为多行,可以将```置于这段代码的首行和末行。 代码引用的案例截图:

表格

相关代码:

代码语言:javascript
复制
| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

显示效果:

Tables

Are

Cool

col 3 is

right-aligned

$1600

col 2 is

centered

$12

zebra stripes

are neat

$1

相关代码:

代码语言:javascript
复制
dog | bird |cat
----|------|----
foo| foo |foo
bar|bar| bar
baz | baz|baz

显示效果:

dog

bird

cat

foo

foo

foo

baz

baz

baz

bar

bar

bar

显示链接中带括号的图片

![][1] [1]: http://latex.codecogs.com/gif.latex?\prod%20(n_{i})+1 代码如下:

代码语言:javascript
复制
![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)+1

结语

以上几种格式是比较常用的格式,所以我们针对这些语法做了比较详细的说明。除这些之外,Markdown 还有其他语法,如想了解和学习更多,可以参考这篇『Markdown 语法说明』

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2017.12.10 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 标题
  • 列表
  • 插入链接/图片
  • 引用
  • 粗体和斜体
  • 代码引用
  • 表格
  • 显示链接中带括号的图片
  • 结语
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档