MarkDown语法

学习markdown语法,记录一下备用。

标题语法

标题就是在词语前加#,# 的数量代表标题的级别。

正文应该从二级标题开始。因为页面为一级标题,建立目录的时候就会清晰一些。

还可以采用可选语法:在文本下边添加任意数量的“==”识别一级标题,“–”识别二级标题。

可以在标题之后添加一对大括号{#id}来自定义标题的ID用于CSS使用。

段落语法

段落就是用一个空行将多行文本进行分隔。

换行语法

在一行的末尾添加两个或多个空格,再按回车。

强调语法

有加粗、斜体和删除线。

词语前后各添加两个*或_则对词语进行加粗,添加一个则为斜体,添加三个则为加粗并斜体。

词语前后添加两个波浪线(~~)对词语添加删除线。

引用语法

段落前加>创建块引用,段落间的空行也加>则创建多个段落的块引用。

段落前加两个>表示嵌套引用。

列表语法

列表项前添加数字和英文句号可创建有序列表,数字应当从1开始。

列表项前加-、*、+可创建无序列表,缩进列表项可创建嵌套列表。

在列表中嵌套其它元素时,需将其它元素缩进四个空格或一个制表符。

  • 事项1
  • 事项2

    这里加个东西,还是引用的

  • 事项3

列表项前添加破折号、空格和方括号- []可创建带复选框的列表

代码语法

放在反引号`中间的短语为代码,两个反引号中间的代码可以使用反引号。

需创建代码块时,请将代码块每行缩进至少四个空格或一个制表符。

在代码块的前一行和后一行分别添加三个反引号(```)或三个波浪号(~~~),则表示围栏代码块,无需对代码块进行缩进,其后紧跟词语指定代码的语言则可进行语法高亮。

分割线语法

单独一行使用不少于三个的*、-、_表示分隔符。

链接语法

链接文本放[ ]内,链接地址放随后的括号中。

超链接语法:[超链接显示名](超链接地址 "title")

网址或Email地址语法:<网址或Email地址>

图片语法

使用!后[]内增加替代文本,()内为图片链接。

插入图片语法:![图片alt](图片链接 "title")

表格语法

使用管道(|)分隔列,标题行的下一行使用超过三个连字符(-)来区分其为标题。

标题行的连字符左侧、右侧或两侧添加冒号可实现列中文本左对齐、右对齐或中心对齐。

表格中文本可设置格式:超链接、代码(仅单反引号)、强调(加粗或斜体)。

脚注语法

在需要插入脚注的地方插入[^1],方括号内添加插入符号和标识符,标识符可以是数字或单词,脚注按顺序编号。

脚注部分的写法:[^1]:脚注内容。脚注不必写在文档末尾,可以随时添加。

Emoji表情语法

可使用表情符号短代码来插入表情符号,以冒号开头和结尾并包含表情符号的名称。

特殊用法

  • 支持HTML的解释器可以用<ins>下划线</ins>实现下划线效果
  • &nbsp;&nbsp;&nbsp;&nbsp;实现段落的缩进
  • <p style="text-align:center">文字居中</p>实现文字居中
  • <font color="red">这段文字是红色的!</font>实现更改文字颜色
  • > :warning: **警告:** 使用引用块+Emoji+加粗实现警告功能
  • <img src="rocks.jpg" width="200" height="100">用html语法设定图片大小
  • <figcaption>描述图片</figcaption>html语法设置图片标题
学教程弄了一个
使用 Hugo 构建
主题 StackJimmy 设计