Markdown学习(一)概述

宗旨

Markdown的目标:实现「易读易写」

兼容HTML

Markdown 语法的目标是:成为一种适用于网络的书写语言

不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。

要制约的只有一些 HTML 区块元素――比如 <div><table><pre><p> 等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。Markdown 的生成器有足够智能,不会在 HTML 区块标签外加上不必要的 <p> 标签。例如:

  
<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

上述代码展示如下:

Foo

请注意,在 HTML 区块标签间的 Markdown 格式语法将不会被处理。比如,你在 HTML 区块内使用 Markdown 样式的*强调*会没有效果。

这解释了为什么需要对一些块级元素进行制约,是为了防止Markdown无法判断HTML的结束位置。

同时,因为这项规定,依照个人习惯,甚至可以不用 Markdown 格式,而直接采用 HTML区块标签来格式化。

这是注意上述讲的都是HTML区块标签,而Markdown 语法在 HTML 区段标签间是有效的。

特殊字符自动转换

Markdown 让你可以自然地书写字符,需要转换的由它来处理好了。

你如果要在文档中插入一个符号&,你可以这样写:&amp;
你如果要在文档中插入一个版权符号 ©,你可以这样写:&copy;
你如果要在文档中插入一个符号<,你可以这样写:&lt;

还有其他特殊字符也会被转换,这里不一一讲解。

简明语法介绍

标题

在Markdown中,标题总共有六级,在文本前面加上n个#(1<=n<=6),就生成几级标签。

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

预览效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

锚点

Coding 会针对每个标题,在解析时都会添加锚点id,如

 # 锚点

会被解析成

<h1 id="user-content-锚点">锚点</h1>

注意我们添加了一个user-content-的前缀所以如果要自己添加跳转链接要使用markdown的形式,且链接要加一个’user-content-‘前缀,如:

[问内链接](#user-content-锚点);

页面会出现一个“问内连接”的跳转链接,如果点击改链接,会跳到id为user-content-锚点的位置。

发布了2 篇原创文章 · 获赞 0 · 访问量 20

猜你喜欢

转载自blog.csdn.net/qq_39944594/article/details/105421408