JSRUN 用代码说话

Markdown简介

编辑教程

Markdown简介

Markdown 是一种简单的标记语言,它可以被编译成 Html 页面,或者也可以单独以纯文本的形式呈现。
Markdown 的目标是实现“易读易写”
对于 Markdown 文档来说,可读性是最重要的。
一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成。

Markdown 语法受到一些既有 text-to-HTML 格式的影响,包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText,而最大灵感来源其实是纯文本电子邮件的格式。

总之, Markdown 的语法全由一些符号所组成,这些符号经过精挑细选,其作用一目了然。

比如:在文字两旁加上星号,看起来就像强调。Markdown 的列表看起来就是列表。Markdown 的区块引用看起来就真的像是引用一段文字,就像你曾在电子邮件中见过的那样。

兼容 HTML

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

Markdown 的设计初衷不是想取代 HTML的地位。Markdown 的语法种类很少,只对应 HTML 标记的一小部分。

有些开发者认为 Markdown 的意义并不是使 HTML 文档更容易书写。他们认为 HTML 已经很容易写了。但实际上对于一个新手,要写 Html 仍然是个很困难的事情。而且,在学懂 Html 和 CSS 之前,也没办法用 Emmet 这样快速书写 Html 和 CSS 的神器。

正是由于 Html 其实足够复杂,所以Markdown 的让文档更容易读、写和随意改的理念就更有价值了。

HTML 是一种发布的格式,Markdown 是侧重于是一种书写的格式。

所以,Markdown 的格式语法只涵盖纯文本可以涵盖的范围,它也不追求写特别复杂的页面。

在 Markdown 中使用 Html 标签

Markdown 没有定义的 Html 标签,都可以直接在 Markdown 文档中书写。

但是一些 HTML 区块元素――比如 <div>、<table>、<pre>、<p> 等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。

因为以四个空格或以一个制表符开头的行会被当作代码块——而代码块会原样输出到 Html 中。

例子如下,在 Markdown 文件里加上一段 HTML 表格:

这是一个普通段落。

<table>
    <caption>表格示例标题</caption>
    <tr>
        <th>表头01</th>
        <th>表头02</th>
    </tr>
    <tr>
        <td>单元格01</td>
        <td>单元格02</td>
    </tr>
    <tr>
        <td>单元格03</td>
        <td>单元格04</td>
    </tr>
</table>

这是另一个普通段落。

编译成 Html 网页,会显示成这样:

表格示例标题
表头01    表头02
单元格01    单元格02
单元格03    单元格04

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

HTML 的区段(行内)标签如 <span>、<cite>、<del> 可以在 Markdown 的段落、列表或是标题里随意使用。依照个人习惯,甚至可以不用 Markdown 格式,而直接采用 HTML 标签来格式化。举例说明:如果比较喜欢 HTML 的 <a> 或 <img> 标签,可以直接使用这些标签,而不用 Markdown 提供的链接或是图像标签语法。

和处在 HTML 区块标签间不同,Markdown 语法在 HTML 区段标签间是有效的。

例如:

这是带<span style="color:red;">色彩并**加粗**</span>文本。

编译为 Html 会呈现为这样:

这是带色彩并加粗文本。

如果是简单的二维文字表,可以不使用 Html 标签,而是简单地写成下面这样:

    |   表格示例标题   |
    | 表头01 | 表头02 |
    |:------|:-------|
    |单元格01|单元格02|
    |单元格03|单元格04|

编译成 Html 后的效果会是这样:

表头01 表头02
单元格01 单元格02
单元格03 单元格04
JSRUN闪电教程系统是国内最先开创的教程维护系统, 所有工程师都可以参与共同维护的闪电教程,让知识的积累变得统一完整、自成体系。 大家可以一起参与进共编,让零散的知识点帮助更多的人。
X
支付宝
9.99
无法付款,请点击这里
如遇到支付问题请联系QQ:565830900
正在生成二维码, 此过程可能需要15秒钟
谢谢支持,我一定会更加努力的