Markdown语言概述

发布于 2021-05-05  415 次阅读


《网安杂项》目录

语法:

一、块级元素:

1.标题

Markdown 支持两种形式的标题, [Setext] [1] 和 [atx] [2].     

  • Setext 样式的标题使用的等号来表示一级标题, 使用连字符表示二级标题.
  • Atx 样式的标题每行开头使用 1-6 井号, 对应 1-6 级标题.

2.块引用

(1)可以在 Markdown 中创建块引用. 最好对引用文本采取强制换行并在每一行行首放一个 >       

(2)可以简便地只在每一个需要强制换行的段落的首行前面加上一个 >       

(3)块引用可以嵌套 (例如, 块引用中包含块引用) , 只需添加额外层级的 >       

(4)块引用可以包含 Markdown 元素, 包括标题, 列表和代码块

3.列表

  • 无序列表使用星号, 加号, 和连字符
  • 有序列表使用数字加句号

4.代码块

(1)Markdown 会用 <pre> 和 <code> 标签包围代码块.        

(2)代码块自动扩展直到碰到未使用缩进的文本 (或者文章结尾).

5.水平线

如果一行中只有三个以上的连字符, 星号, 或者下划线则会在该位置生成一个 <hr /> 标签.

二、内联元素:

1.链接

Markdown 支持两种链接形式: 内联引用.       

(1)要创建内联链接, 只需在链接文本的右括号后面紧接一对圆括号. 圆括号里面放所需的 URL 链接, 还可以放一个 可选 的链接标题, 标题要用引号包围.       

(2)引用链接

  • 方括号中包含链接标识符 (可以用三个以上的空白符来添加缩进);
  • 跟着是冒号;
  • 跟着是一个以上的空白符和水平制表符;
  • 跟着是链接的 URL;
  • 跟着是可选的标题属性, 可以用单引号, 双引号, 或者圆括号包围.

2.强调

Markdown 将星号 (*) 和下划线 (_) 作为强调标记.        

用 * 或者 _ 包裹的文本将会用 HTML <em> 标签包裹; 双 * 或者 _ 将会用 HTML <strong> 标签包裹.

3.代码

(1)要输出一个代码片段, 需要使用重音符号 (`).         

(2)不同于预格式的代码块, 代码片段只是在普通段落中标识出代码.         

(3)要在代码片段中包含字面量的重音符号, 可以使用多个重音符号作为起始和结束标记

4.图片

Markdown 使用了类似链接的语法来插入图片, 包含两种形式: 内联引用.        

Markdown 没有语法指定图片尺寸; 如果需要指定图片尺寸, 可以使用 HTML <img> 标签.       

(1)内联图片语法如下:

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

![Alt text](/path/to/img.jpg "Optional title")
  • 一个感叹号: !
  • 紧跟着一对方括号, 包含了图片的 alt 属性
  • 紧跟着一对圆括号, 包含了图片的 URL 或者路径, 以及一个可选的用单引号或双引号包裹的 title 属性

(2)引用图片语法如下:

![Alt text][id]

三、其他:

1.自动链接

<http://example.com/>        

Markdown 将把它转化为:        

<a href="http://example.com/">http://example.com/</a>

2.反斜杠转义

Markdown 为下面字符提供反斜杠转义:

\   backslash
`   backtick
*   asterisk
_   underscore
{}  curly braces
[]  square brackets
()  parentheses
#   hash mark+   plus sign
-   minus sign (hyphen)
.   dot
!   exclamation mark

注意事项:

1.在 HTML 中, 有两个字符需要特殊对待: < 和 &.     ( Markdown 的块级元素和内联元素中, 尖括号和英镑符号 总是 被自动编码. )        

左尖括号用于起始标签; 英镑符号用于表示 HTML 字符实体.         

如果你想将它们用作字面量, 你必须将它们转义为字符实体, 例如 &lt; 和 &amp;。       

例: 想得到 'AT&T', 你得这样写 'AT&amp;T'

2."换行即 <br />" 的规则并不适用于 Markdown.

当你 确实需要 在 Markdown 中输入 <br /> 标签, 只需要在行尾加上两个及以上的空格, 然后换行.


本文摘自博主笔记,某些知识点可能会不够详细,仅供参考

参考自Markdown 中文文档


人生就像赛跑,不在乎你是否第一个到达终点,而在乎你是否跑完全程。