2023-04-02

Markdown 中文文档笔记

概述

设计理念

  • Markdown 视可读性为最高准则.

  • Markdown 完全由标点符号组成, 这些标点经过仔细挑选以使他们看上去和表达的含义相同.

内联 HTML

  • Markdown 是用于 创作 web 文档的.
  • Markdown 的目标是易于阅读, 创作和编辑文章. HTML 是一种 **发布 **格式; Markdown 是一种 创作 格式. 因此, Markdown 处理的都是纯文本.
  • Markdown可以直接使用HTML标签。例:添加HTML表格到Markdown文件
  • 唯一的限制就是对于 HTML 块级元素 -- 像 <div>, <table>, <pre>, <p>, 等等. -- 必须另起一行单独放 , 并且开始和结束标签前面不能有任何缩进.
  • 例:添加HTML表格到Markdown文件

This is a regular paragraph.

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

This is another regular paragraph.

  • Markdown语法在HTML里并不会生效.

  • HTML 内联元素 -- 例如 <span>, <cite>, 和 <del> -- 可以在 Markdown 段落, 列表项, 标题中任意使用. 甚至可以使用 HTML 标签替代 Markdown 格式; 例如可以用 HTML <a><img> 标签替代 Markdown 的链接和图片语法.

  • 不同于 HTML 块级元素, Markdown 语法可以 在内联元素中解析.

特殊字符自动转义

  • 在 HTML 中, 有两个字符需要特殊对待: <&. 左尖括号用于起始标签; 英镑符号用于表示 HTML 字符实体. 如果想将它们用作字面量, 则必须将它们转义为字符实体, 例如&lt;&amp;.

  • 对于&符号,使用它时,Markdown不会转义:

    • ©
  • 不使用&符号时,例如在URL中,或如下所示,&符号会自动转换为&amp;:

    • AT&T
  • 由于 Markdown 支持 内联 HTML, 如果使用尖括号作为 HTML 标签定界符, Markdown 将不会进行转义.

  • 是如果写:4 < 5,Markdown 会将其转义:4&lt;5.

  • 总而言之, Markdown 的块级元素和内联元素中, 尖括号和英镑符号总是被自动编码.

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容