# 上手HackMD

[TOC]

## 1 Markdown技巧

### 1.1 `页面内跳转链接`和`自定义锚`

我们在写文档时，常常需要**在知识点之间进行跳转**。因此，在同一页面中，就需要我们设置`锚点`、建立`跳转链接`，完成**知识点的关联**。

那么在Markdown中，我们有两种方法可以实现这一需求：

1. 利用Markdown为`h1~h6`标题自动生成的锚，来设置跳转链接；
2. 利用`HTML`语法来自定义锚并设置跳转链接。

#### 第一种方法的适用情形

当我们需要推荐读者去阅读或者参考某一小节的内容时，我们就可以利用`h1~h6`设置锚点。例如：请参考[1.1 `页面内跳转链接`和`自定义锚`](#11-页面内跳转链接和自定义锚)、[常用书签名简称](#常用书签名简称)

跳转链接设置为：[1.1 `页面内跳转链接`和`自定义锚`](#11-页面内跳转链接和自定义锚)
跳转链接设置为：[常用书签名简称](#常用书签名简称)

:::warning
**注意：** 不同的编辑器会将`h1~h6`翻译成不同的形式，需要自行判断并做修改。
:::

#### 第二种方法的适用情形

当我们对表格、公式进行引用时，我们可以利用`HTML`语法来自定义锚点，达到跳转的作用。例如：请参考[公式1](#eq1)

跳转链接设置为：[公式1](#eq1)
锚点设置为：<span id="eq1"> </span>

:::warning
**注意：** 很不幸的是部分编辑器并不支持这种方法，可以尝试复制到[Typora](https://typora.io/)中测试。
:::

:::info
**建议：** 将自定义锚点设置在**跳转内容的上方**，以保证内容可以直接显示出来，而不需要上下翻页。
:::

## 附录

### 常用书签名简称

| 缩写 | 全称 | 缩写 | 全称 |
| :-----------: | :---------------------: | :------: | :---------------: |
| `part` | 部分(part) | `fig` | 图(figure) |
| `chap` | 章(chapter) | `tab` | 表(table) |
| `sec` | 节(section) | `eq` | 公式(equation) |
| `subsec` | 小节(subsection) | `fn` | 脚注(footnote) |
| `subsubsec` | 小小节(subsubsection) | `item` | 项目(item) |
| `para` | 段(paragraph) | `thm` | 定理 |
| `subpara` | 小段(subparagraph) | `algo` | 算法(algorithm) |

### Latex公式编号

<span id="eq1"> </span>

$$a^2+b^2=c^2 \tag {1}$$