首页 » 信息技术 »

应知应会的Markdown知识点

2019年4月28日 / 12次阅读

  • 打开支付宝,搜索“ 529018372 ”,领取专属红包!每日支付每日领。

Markdown 的目标是实现「易读易写」。不管是看markdown源码,还是看经过渲染后的markdown文件,都要非常容易理解。容易理解的另外一个方面,就是容易写出来。

首先,需要了解,markdown兼容html。

在markdown文件里,除了使用markdown自有的语法外,还可以直接使用html元素,比如<table><img><div>等。markdown语法,集中在编写标题,段落,代码块,引用块,有序列表,无序列表等这些更文字的内容。

标题

# 标题1
## 标题2

.......一直到标题6

段落

在html中,段落使用<p>;在markdown中,用一个空白行来区分段落。也就是说,在编写文字的时候,一个回车换行并不是区分段落的标志,必须要有一个空白行来区分。

很多同学不理解为什么要这样设计?

我的理解是,这是一个国外程序员的习惯。有一条变成规则,是保持每一行的宽度不超过80个字符,因为这样可以很方便地实现多窗口阅读,Python的PEP8就有这一条。貌似这一条规则,还适用于邮件讨论组,有一些markdown规则,就是来自编写EMAIL的规则。

所以,要单独用一个空行来区分段落。要保持每一行不超过80个字符,一定会换行,而换行不等于开始一个新的段落。

代码块

前面输入4个空格,就会被渲染成代码块。

引用块

在句首使用>这个符号,就是引用块。

有序列表

直接用数字加英文句号,就是有序列表

1. Bird
2. McHale
3. Parish

无序列表

无序列表使用星号、加号或是减号作为列表标记:

* Red
* Green
* Blue

+ Red
+ Green
+ Blue

- Red
- Green
- Blue

列表中的段落,句首需要4个空格。

分割线

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

* * *

***

*****

- - -

强调

*强调的内容*,相当于在内容前后加<em>

**强调的内容**,相当于在内容前后加<strong>

也可以使用下划线_来带起星号。

自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用尖括号包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:

<http://www.maixj.net>会被转化成:

<a href="http://www.maixj.net">http://www.maixj.net</a>

<address@example.com>会被转化成:

<a href="mailto:address@example.com">address@example.com</a>

反斜杠

跟写代码一样,反斜杠用来支持特殊字符的输入:

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号

图片

其实,我觉得直接使用<img>元素来插入图片也挺方便的,还可以指定图片的宽和高。markdown也有自己的插入图片的语法.

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

 

掌握的以上Markdown知识点,基本上就可以满足编写md文档的要求了,很简单,对吧。我自己学习这个知识,只是为了编写Github上的README.md文件。记住:markdown兼容html,有写内容如果无法用markdown来表达,就直接使用html。

本文链接:http://www.maixj.net/ict/markdown-21074

相关文章

留言区

《应知应会的Markdown知识点》有1条留言

电子邮件地址不会被公开。 必填项已用*标注

  • 麦新杰

    补充一个查询markdown语法的网站:https://commonmark.org/help/ [回复]


前一篇:
后一篇:
推一篇:可靠正规,长期稳定,网络兼职项目!!

栏目精选

云上小悟,麦新杰的独立博客

Ctrl+D 收藏本页

栏目


©Copyright 麦新杰 Since 2014 云上小悟独立博客版权所有 备案号:苏ICP备14045477号-1。云上小悟网站部分内容来源于网络,转载目的是为了整合信息,收藏学习,服务大家,有些转载内容也难以判断是否有侵权问题,如果侵犯了您的权益,请及时联系站长,我会立即删除。

网站二维码
go to top