Summary

Markdown语法笔记，随时翻翻看。

标题（Heading）

使用1 - 6个#来表示各级标题。

# h1(一级标题)
## h2(二级标题)
### h3(三级标题)
#### h4(四级标题)
##### h5(五级标题)
###### h6(六级标题)

段落（Paragraph）

使用空白行分隔文本就可以创建新段落，连续的多个空白行会被当成只有一个空白行处理。

换行（Line break）

如果是段落，直接用空白行分开就行。但是如果想人为创造空白行，就可以使用<br>。

这句话的末尾没有换行符。所以这句也会在同一行显示。

这句话的末尾有一个换行符。<br> 所以这句话会在下一行显示。

<br><br>
因为上边添加了两个换行符所以会创造两个空行。

效果如下：

这句话的末尾没有换行符。所以这句也会在同一行显示。

这句话的末尾有一个换行符。
所以这句话会在下一行显示。



因为上边添加了两个换行符所以会创造两个空行。

分隔线（Horizontal Rule）

使用三个连续的-或*或_，我一般就用---。

---

***

___

效果如下：

样式化文本（Styling text）

强调（Emphasize）

强调的表现形式有加粗和斜体两种：

  • 粗体（Bold）：使用两个*或_包裹内容。

  • 斜体（Italic）: 使用一个*或_包裹内容。

这个词是**粗体**。<br>
这个词是*斜体*。<br>
这个词***又粗又斜***。<br>
这个词是**粗体内嵌*斜体***。<br>
这个词是*斜体内嵌**粗体***。

效果如下：

这个词是粗体。
这个词是斜体。
这个词又粗又斜。
这个词是粗体内嵌斜体。
这个词是斜体内嵌粗体。

出于养成习惯培养一致性，应该只使用一种符号，比如就用*来表示强调。

删除线（strikethrough）

这个词会被~~删 除~~。

效果如下：

这个词会被删 除。

上标和下标（supscript subscript）

这是： X<sup>2</sup>.

这是： H<sub>2</sub>O.

效果如下：

这是： X2.

这是： H2O.

列表（List）

列表分有序和无序列表两种：

  • 有序列表（Ordered List）: 使用数字跟上英文.表示；
  • 无序列表（Unordered List）：使用 - 表示。

  1. 这是一个有序列表：

    1. first;
2. second;
    1. lever 2 first;
    2. lever 2 second;
3. third.

    效果如下：

    1. first;
    2. second;
      1. lever 2 first;
      2. lever 2 second;
    3. third.

  2. 这是一个无序列表：

    - first;
- second;
    - lever 2 first;
    - lever 2 second;
- third.

    效果如下：

    • first;
    • second;
      • lever 2 first;
      • lever 2 second;
    • third.

  3. 这是混合了有序和无序列表：

    1. First item
2. Second item
3. Third item
    - Indented item
    - Indented item
4. Fourth item

    效果如下：

    1. First item
    2. Second item
    3. Third item
      • Indented item
      • Indented item
    4. Fourth item

  4. 使用Tab或者4个空格来缩进以便衔接列表：

    1. first;
2. second;

    this is a para.

    and here is another para or something else like img etc.

3. third.

    效果如下：

    1. first;

    2. second;

      this is a para.

      and here is another para or something else like img etc.

    3. third.

  5. 列表中的代码块需要2个Tab或者8个空格的缩进来衔接列表：

    1. first;
2. second;

        code here

3. third.

    效果如下：

    1. first;

    2. second;

       code here

    3. third.

任务列表（Task list）

语法如下：

- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media

效果如下：

  • Write the press release
  • Update the website
  • Contact the media

定义列表（Description list）

语法：

列表标题
: 列表定义1
: 列表定义2
: 列表定义...

效果如下：

列表标题
列表定义1
列表定义2
列表定义…

引用（Quote）

使用>符号表示引用。

**单句引用**:

> 天生我材必有用。

**多句连续引用**:

> 天生我材必有用；
>
> 千金散尽还复来。

**嵌套引用**:

> 天生我材必有用；
>> 五花马，千金裘。

效果如下：

单句引用:

天生我材必有用。

多句连续引用:

天生我材必有用；

千金散尽还复来。

嵌套引用:

天生我材必有用；

五花马，千金裘。

脚注（Footnote）

这里是一个简单的脚注；[^1]

这是一个比较长的脚注。[^longnote]

[^1]: 这是第一个脚注，你书写的时候把脚注写在哪都行(除了列表，块引号和表)，markdown渲染的时候会自己把它放到文末。

[^longnote]: 这个一个很长的脚注，会跨越多行，每行你都在开头缩进以让内容都包含在脚注之内；

    比如说这里。

    还有这里。

效果如下：

这里是一个简单的脚注；1

这是一个比较长的脚注。2

代码（Code）

单词或者短语就用`（反引号）包裹表示，代码块用```包裹表示。

  1. 单个code:

    - 这里引用一下`<br>`这个符号。
- 使用双`` ` ``来转义单个`` ` ``，比如：``Use `code` in your file.``.

    效果如下：

    • 这里引用一下<br>这个符号。
    • 使用双`来转义单个`，比如：Use `code` in your file..

  2. 代码块：

    ```
This is code block. 原样显示你输入的内容。

- 这不会成为列表。

**这也不会成为粗体**。

just code here.
```

    效果如下：

    This is code block. 原样显示你输入的内容。

- 这不会成为列表。

**这也不会成为粗体**。

just code here.

这里有两点值得注意：

  1. 为了表示`，我的写法是两个` + 空格 + ` + 空格 + 两个`，这点也适用于```。
  2. 为了表示代码块中的```，我在它之前和之后都写了````。

表格（Tabel）

语法：

  • | 分隔列;
  • - 用来分隔标题和下边的内容;
  • : 用来对齐;
| 标题1 | 标题2 | 列3|
|:---|:---:|---:|
|这一列左对齐|这一列居中对齐|这一列右对齐|
|单元格的宽度会影响整列|居中| 右对齐|

效果如下：

标题1 标题2 列3
这一列左对齐 这一列居中对齐 这一列右对齐
单元格的宽度会影响整列 居中 右对齐

  1. 基础用法

    语法是：[链接文字](链接地址 "链接标题").

     ```
 这会在新标签页打开[首页](https://ciwunami.com)。
 ```

    效果如下：

    这会在新标签页打开 首页 。

  2. 使用<>直接链接

     ```
 <https://example.com>

 <[email protected]>
 ```

    效果如下：

    https://example.com

    [email protected]

  3. 使用#链接至文本中的某一段落，前提是各个标题有自己的ID，比如这篇文章的每个标题就有自己的ID，当然也可以自己人为设定标题的ID：

     ```
 我在写段落的时候是这样写的：

 ## 段落（Paragraph）{#para}

 所以：

 这会链接到本文的[段落](#para)。

 这也会链接到本文的[段落](https://ciwunami.com/post/makrdown语法#para)。
 ```

    效果如下：

    我在写段落的时候是这样写的：

    ## 段落（Paragraph）{#para}

    所以：

    这会链接到本文的 段落 。

    这也会链接到本文的 段落 。

  4. 使用两个[]。

    ```
This is a [link to example][1].

This will [link to 段落][2].

以下内容可以放在文章的任何地方，但实际**在页面上不会看到这两条内容**。

[1]: https://example.com
[2]: #para

```

    效果如下：

    This is a link to example .

    This will link to 段落 .

    以下内容可以放在文章的任何地方，但实际在页面上不会看到这两条内容。

图片（Image）

插入图片的语法是：![alt](图片链接 "图片title")。

让图片本身也成为链接的语法是：[![alt](图片链接 "图片title")](link source)。


这里插入一张图片 ![markdown](/post/img/HbBVDtNjoX/001.webp#half-width)

这里插入一张可链接到首页的图片[![markdown](/apple-touch-icon.webp#half-width)](/)

效果如下：

这里插入一张图片 markdown

这里插入一张可链接到首页的图片 markdown

折叠（Collapsed Section）

用户点击才会显示更多内容。

<details><summary>查看更多</summary>

这部分内容显示/隐藏。

`<summary>`包裹的内容是标题。
</details>

效果如下：

查看更多

这部分内容显示/隐藏。

<summary>包裹的内容是标题。

HTML

  1. 行内标签

     ```
 这个单词会被**加粗**，也可以用<em>标签</em>来表示强调。
 ```

    效果如下：

    这个单词会被加粗，也可以用标签来表示强调。

  2. 块级标签

     ```
 这是一个正常段落，后边会换行。

 <p style="font-weight: bold;">你好啊，这是一段粗体。</p>

 这也是一个正常段落。
 ```

    效果如下：

    这是一个正常段落，后边会换行。

    你好啊，这是一段粗体。

    这也是一个正常段落。

转义字符

在要转义的字符前边加上\。

这个 \`code` 不会被格式化。

这个`code`会被格式化。

效果如下：

这个 `code` 不会被格式化。

这个code会被格式化。

  1. 这是第一个脚注，你书写的时候把脚注写在哪都行(除了列表，块引号和表)，markdown渲染的时候会自己把它放到文末。 ↩︎

  2. 这个一个很长的脚注，会跨越多行，每行你都在开头缩进以让内容都包含在脚注之内；

    比如说这里。

    还有这里。 ↩︎