MarkDown详细入门笔记-LMLPHP

本帖整理了MarkDown的入门学习笔记~


一.介绍

Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。

诸如微信公众平台、CSDN博客、还有Typora中写文档的部分,均涉及到MD的功能~

支持 Markdown 语法的编辑器有很多,Markdown 从写作到完成,导出格式随心所欲,你可以导出 HTML 格式的文件用来网站发布,也可以十分方便的导出 PDF 格式

Markdown 旨在简洁、高效,也由于 Markdown 的易读易写,人们用不同的编程语言实现了多个版本的解析器和生成器。这就导致了目前不同的 Markdown 工具集成了不同的功能(基础功能大致相同),例如流程图与时序图,复杂表格与复杂公式的呈现,比如 GFM Markdown 就支持使用 Mermaid 生成图表和流程图。

二.段落及强调

在 Markdown 中,段落是由一个以上相连接的行句组成,而一个以上的空行则会切分出不同的段落,一般的段落不需要用空白或换行缩排。(空行的定义是显示上看起来像是空行,便会被视为空行。比如,若某一行只包含空白和 tab,则该行也会被视为空行)

三.标题

Markdown 支持两种标题的语法,Setext 和 atx 形式。

  • Setext 形式标题:Setext 形式是用底线的形式,利用 = (一级标题)和 - (二级标题)
  • Atx 形式标题:Atx 形式则是在行首插入 1 到 6 个 #(最多支持 6 级标题) ,对应到标题 1 到 6 级

四.链接

Markdown 支持两种形式的链接语法:行内和参考两种形式。不管是哪一种,链接的文字都是用 [方括号] 来标记。

  • 行内形式链接:行内形式的链接是在方块括号后面接括号并插入网址链接即可,如果你还想要加上链接的 alt 提示文字,只要在网址后面,用双引号把 alt 文字包起来即可,其格式为 [内容](http_url "alt 提示")
  • 参考形式链接:参考形式的链接使用另外一个方括号接在链接文字的括号后面,而在第二个方括号里面要填入用以辨识链接的标签

(注意:在MD可以使用Html的多数标签)

五.图片

Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内和参考

  • 行内形式图片:行内形式图片的语法格式为![Alt text](/path/to/img.jpg "Optional title")
  • 参考样式图片:的格式添加一个图片,其结构为 ![内容][1] + [1]: image_url "alt 提示" 的组合

六.列表

  • 无序列表:无序列表使用 * 、 + 或是 - 作为列表标记
  • 有序列表:有序列表则使用数字接着一个英文句号
  • 任务列表:任务列表的语法格式为 - [ ] todo,其中 [ ] (带空格的中括号)表示未完成的任务,[x](带字母x的中括号) 表示已经完成的任务

七.分隔线及引用

你可以在一行中用三个或以上的*-_来创建一个分隔线,行内不能有其他东西。你也可以在星号中间插入空白。

MarkDown详细入门笔记-LMLPHP

 

引用:Markdown 使用 email 形式的区块引用,我们在要引用内容每行的最前面加上 > ,就可以在 Markdown 文档中创建一个区块引用

MarkDown详细入门笔记-LMLPHP

八.代码块

行内代码的格式很简单,只需要使用两个 ` 将代码内容包裹起来即可,还有其他几种表达方式:

  • 用两个 ` 将代码内容包裹起来就是一个行内代码
  • 缩进 4 个空白或是 1 个 tab 可以创建一个缩进代码块
  • 在代码块的前后各使用三个反引号( ``` )把需要高亮显示的代码包裹起来,并在第一个 ``` 的末尾标识上语言类型就可以创建一个高亮代码块

九.表格 

在 Markdown 中创建表格的语法要求如下:

  1. 第一行包含表头,并用"竖线"( | )分隔
  2. 第二行将标题与单元格分开,并且必须包含三个或更多破折号
  3. 第三行以及随后的任何行均包含单元格值

需要注意的是:

  • 不能在 Markdown 中将单元格分隔成多行,它们必须保持为单行,如果需要,还可以使用 HTML <br>标记对内容进行强制换行
  • 第二行单元长短与标题不需要保持一致,但必须用竖线(|)分隔
  • 可以有空白的单元格

MarkDown详细入门笔记-LMLPHP

10-27 17:16