add backticks to fix build issues

best-practices/haproxy-best-practices.md

@@ -115,15 +115,15 @@ haproxy --help
 | `-dM [<byte>]` | 执行分配内存。|
 | `-V` | 启动过程显示配置和轮询信息。 |
 | `-D` | 开启守护进程模式。 |
-| `-C <dir>` | 在加载配置文件之前更改目录位置至 \<dir>。 |
+| `-C <dir>` | 在加载配置文件之前更改目录位置至 `<dir>`。 |
 | `-W` | 主从模式。 |
 | `-q` | 静默模式，不输出信息。 |
 | `-c` | 只检查配置文件并在尝试绑定之前退出。 |
-| `-n <limit>` | 设置每个进程的最大总连接数为 \<limit>。 |
-| `-m <limit>` | 设置所有进程的最大可用内存为 \<limit>（单位：MB）。 |
-| `-N <limit>` | 设置单点最大连接数为 \<limit>，默认为 2000。 |
-| `-L <name>` | 将本地实例对等名称改为 \<name>，默认为本地主机名。 |
-| `-p <file>` | 将 HAProxy 所有子进程的 PID 信息写入 \<file>。 |
+| `-n <limit>` | 设置每个进程的最大总连接数为 `<limit>`。 |
+| `-m <limit>` | 设置所有进程的最大可用内存为 `<limit>`（单位：MB）。 |
+| `-N <limit>` | 设置单点最大连接数为 `<limit>`，默认为 2000。 |
+| `-L <name>` | 将本地实例对等名称改为 `<name>`，默认为本地主机名。 |
+| `-p <file>` | 将 HAProxy 所有子进程的 PID 信息写入 `<file>`。 |
 | `-de` | 禁止使用 epoll(7)，epoll(7) 仅在 Linux 2.6 和某些定制的 Linux 2.4 系统上可用。 |
 | `-dp` | 禁止使用 epoll(2)，可改用 select(2)。 |
 | `-dS` | 禁止使用 splice(2)，splice(2) 在一些旧版 Linux 内核上不可用。 |

functions-and-operators/expressions-pushed-down.md

@@ -14,7 +14,7 @@ aliases: ['/docs-cn/dev/reference/sql/functions-and-operators/expressions-pushed
 | 表达式分类 | 具体操作 |
 | :-------------- | :------------------------------------- |
 | [逻辑运算](/functions-and-operators/operators.md#逻辑操作符) | AND (&&), OR (||), NOT (!) |
-| [比较运算](/functions-and-operators/operators.md#比较方法和操作符) | <, <=, =, != (<>), >, >=, [`<=>`](https://dev.mysql.com/doc/refman/5.7/en/comparison-operators.html#operator_equal-to), [`IN()`](https://dev.mysql.com/doc/refman/5.7/en/comparison-operators.html#function_in), IS NULL, LIKE, IS TRUE, IS FALSE, [`COALESCE()`](https://dev.mysql.com/doc/refman/5.7/en/comparison-operators.html#function_coalesce) |
+| [比较运算](/functions-and-operators/operators.md#比较方法和操作符) | <, <=, =, != (`<>`), >, >=, [`<=>`](https://dev.mysql.com/doc/refman/5.7/en/comparison-operators.html#operator_equal-to), [`IN()`](https://dev.mysql.com/doc/refman/5.7/en/comparison-operators.html#function_in), IS NULL, LIKE, IS TRUE, IS FALSE, [`COALESCE()`](https://dev.mysql.com/doc/refman/5.7/en/comparison-operators.html#function_coalesce) |
 | [数值运算](/functions-and-operators/numeric-functions-and-operators.md) | +, -, *, /, [`ABS()`](https://dev.mysql.com/doc/refman/5.7/en/mathematical-functions.html#function_abs), [`CEIL()`](https://dev.mysql.com/doc/refman/5.7/en/mathematical-functions.html#function_ceil), [`CEILING()`](https://dev.mysql.com/doc/refman/5.7/en/mathematical-functions.html#function_ceiling), [`FLOOR()`](https://dev.mysql.com/doc/refman/5.7/en/mathematical-functions.html#function_floor) |
 | [控制流运算](/functions-and-operators/control-flow-functions.md) | [`CASE`](https://dev.mysql.com/doc/refman/5.7/en/control-flow-functions.html#operator_case), [`IF()`](https://dev.mysql.com/doc/refman/5.7/en/control-flow-functions.html#function_if), [`IFNULL()`](https://dev.mysql.com/doc/refman/5.7/en/control-flow-functions.html#function_ifnull) |
 | [JSON运算](/functions-and-operators/json-functions.md) | [JSON_TYPE(json_val)][json_type],<br/> [JSON_EXTRACT(json_doc, path[, path] ...)][json_extract],<br/> [JSON_UNQUOTE(json_val)][json_unquote],<br/> [JSON_OBJECT(key, val[, key, val] ...)][json_object],<br/> [JSON_ARRAY([val[, val] ...])][json_array],<br/> [JSON_MERGE(json_doc, json_doc[, json_doc] ...)][json_merge],<br/> [JSON_SET(json_doc, path, val[, path, val] ...)][json_set],<br/> [JSON_INSERT(json_doc, path, val[, path, val] ...)][json_insert],<br/> [JSON_REPLACE(json_doc, path, val[, path, val] ...)][json_replace],<br/> [JSON_REMOVE(json_doc, path[, path] ...)][json_remove] |
@@ -134,7 +134,7 @@ tidb> explain select * from t where a < 2 and a > 2;
 | >= | ge |
 | = | eq |
 | != | ne |
-| <> | ne |
+| `<>` | ne |
 | <=> | nulleq |
 | &#124; | bitor |
 | && | bitand|

pd-control.md

@@ -107,7 +107,7 @@ export PD_ADDR=http://127.0.0.1:2379 &&
 - 打印版本信息并退出
 - 默认值: false
 
-## 命令(command)
+## 命令 (command)
 
 ### cluster
 
@@ -128,7 +128,7 @@ export PD_ADDR=http://127.0.0.1:2379 &&
 }
 ```
 
-### config [show | set \<option> \<value> | placement-rules]
+### `config [show | set <option> <value> | placement-rules]`
 
 用于显示或调整配置信息。示例如下。
 
@@ -437,7 +437,7 @@ config set cluster-version 1.0.8
 
 `enable-placement-rules` 用于开启 placement rules。
 
-### config placement-rules [disable | enable | load | save | show]
+### `config placement-rules [disable | enable | load | save | show]`
 
 用于配置 Placement Rules。 具体使用说明可参考[Placement Rules 使用文档](/configure-placement-rules.md)。
 
@@ -468,7 +468,7 @@ config set cluster-version 1.0.8
 ]
 ```
 
-### hot [read | write | store]
+### `hot [read | write | store]`
 
 用于显示集群热点信息。示例如下。
 
@@ -496,7 +496,7 @@ config set cluster-version 1.0.8
 >> hot store
 ```
 
-### label [store \<name> \<value>]
+### `label [store <name> <value>]`
 
 用于显示集群标签信息。示例如下。
 
@@ -516,7 +516,7 @@ config set cluster-version 1.0.8
 >> label store zone cn
 ```
 
-### member [delete | leader_priority | leader [show | resign | transfer <member_name>]]
+### `member [delete | leader_priority | leader [show | resign | transfer <member_name>]]`
 
 用于显示 PD 成员信息，删除指定成员，设置成员的 leader 优先级。示例如下。
 
@@ -602,7 +602,7 @@ Success!
 ......
 ```
 
-### operator [check | show | add | remove]
+### `operator [check | show | add | remove]`
 
 用于显示和控制调度操作，或者对 Region 进行分裂或合并。
 
@@ -629,7 +629,7 @@ Success!
 
 其中，Region 的分裂都是尽可能地从靠近中间的位置开始。对这个位置的选择支持两种策略，即 scan 和 approximate。它们之间的区别是，前者通过扫描这个 Region 的方式来确定中间的 key，而后者是通过查看 SST 文件中记录的统计信息，来得到近似的位置。一般来说，前者更加精确，而后者消耗更少的 I/O，可以更快地完成。
 
-### ping
+### `ping`
 
 用于显示`ping` PD 所需要花费的时间
 
@@ -645,7 +645,7 @@ Success!
 time: 43.12698ms
 ```
 
-### region <region_id> [--jq="\<query string>"]
+### `region <region_id> [--jq="<query string>"]`
 
 用于显示 Region 信息。使用 jq 格式化输出请参考 [jq-格式化-json-输出示例](#jq-格式化-json-输出示例)。示例如下。
 
@@ -700,7 +700,7 @@ time: 43.12698ms
 }
 ```
 
-### region key [--format=raw|encode] \<key>
+### `region key [--format=raw|encode] <key>`
 
 用于查询某个 key 在哪个 Region 上，支持 raw 和 encoding 格式。使用 encoding 格式时，key 需要使用单引号。
 
@@ -738,7 +738,7 @@ Encoding 格式示例：
 }
 ```
 
-### region scan
+### `region scan`
 
 用于获取所有 Region。
 
@@ -757,7 +757,7 @@ Encoding 格式示例：
 }
 ```
 
-### region sibling <region_id>
+### `region sibling <region_id>`
 
 用于查询某个 Region 相邻的 Region。
 
@@ -776,7 +776,7 @@ Encoding 格式示例：
 }
 ```
 
-### region startkey [--format=raw|encode|hex] <key> <limit>
+### `region startkey [--format=raw|encode|hex] <key> <limit>`
 
 用于查询从某个 key 开始的所有 Region。
 
@@ -909,7 +909,7 @@ Encoding 格式示例：
 }
 ```
 
-### region check [miss-peer | extra-peer | down-peer | pending-peer]
+### `region check [miss-peer | extra-peer | down-peer | pending-peer]`
 
 用于查询处于异常状态的 Region，各类型的意义如下
 
@@ -933,7 +933,7 @@ Encoding 格式示例：
 }
 ```
 
-### scheduler [show | add | remove | pause | resume | config]
+### `scheduler [show | add | remove | pause | resume | config]`
 
 用于显示和控制调度策略。
 
@@ -955,7 +955,7 @@ Encoding 格式示例：
 >> scheduler config balance-hot-region-scheduler  // 显示 balance-hot-region 调度器的配置
 ```
 
-### store [delete | label | weight | remove-tombstone | limit | limit-scene] <store_id> [--jq="\<query string>"]
+### `store [delete | label | weight | remove-tombstone | limit | limit-scene] <store_id> [--jq="<query string>"]`
 
 用于显示 store 信息或者删除指定 store。使用 jq 格式化输出请参考 [jq-格式化-json-输出示例](#jq-格式化-json-输出示例)。示例如下。
 
@@ -1041,7 +1041,7 @@ Encoding 格式示例：
 >
 > store limit 的生效情况和执行命令的先后顺序有关。如先执行 `store limit 1 5 region-add` 会将 store 1 添加 peer 的速度上限设置为每分钟 5 个，然后执行 `store limit 1 10 region-add`。此时 store 1 添加 peer 的速度上限会被修改为每分钟 10 个；反之，如先执行 `store limit 1 10 region-add`，会将全部 store 添加 peer 的速度上限设置为为每分钟 10 个，然后执行 `store limit 1 5 region-add`。此时只有 store 1 添加 peer 的速度上限被修改为每分钟 5 个。
 
-### log [fatal | error | warn | info | debug]
+### `log [fatal | error | warn | info | debug]`
 
 用于设置 PD leader 的日志级别。
 
@@ -1051,7 +1051,7 @@ Encoding 格式示例：
 >> log warn
 ```
 
-### tso
+### `tso`
 
 用于解析 TSO 到物理时间和逻辑时间。示例如下。
 

sql-statements/sql-statement-flush-privileges.md

@@ -41,6 +41,6 @@ Query OK, 0 rows affected (0.01 sec)
 
 ## 另请参阅
 
-* [GRANT](/sql-statements/sql-statement-grant-privileges.md)
-* [REVOKE <privileges>](/sql-statements/sql-statement-revoke-privileges.md)
+* [`GRANT <privileges>`](/sql-statements/sql-statement-grant-privileges.md)
+* [`REVOKE <privileges>`](/sql-statements/sql-statement-revoke-privileges.md)
 * [Privilege Management](/privilege-management.md)

sql-statements/sql-statement-grant-privileges.md

@@ -5,7 +5,7 @@ category: reference
 aliases: ['/docs-cn/dev/reference/sql/statements/grant-privileges/']
 ---
 
-# GRANT <privileges>
+# `GRANT <privileges>`
 
 `GRANT <privileges>` 语句用于为 TiDB 中已存在的用户分配权限。TiDB 中的权限系统同 MySQL 一样，都基于数据库/表模式来分配凭据。
 执行 `GRANT <privileges>` 语句需要拥有分配的权限，并且拥有 `GRANT OPTION` 权限。
@@ -86,6 +86,6 @@ SHOW GRANTS FOR 'newuser';
 
 ## 另请参阅
 
-* [REVOKE <privileges>](/sql-statements/sql-statement-revoke-privileges.md)
+* [`REVOKE <privileges>`](/sql-statements/sql-statement-revoke-privileges.md)
 * [SHOW GRANTS](/sql-statements/sql-statement-show-grants.md)
 * [Privilege Management](/privilege-management.md)

sql-statements/sql-statement-revoke-privileges.md

@@ -5,7 +5,7 @@ category: reference
 aliases: ['/docs-cn/dev/reference/sql/statements/revoke-privileges/']
 ---
 
-# REVOKE <privileges>
+# `REVOKE <privileges>`
 
 `REVOKE <privileges>` 语句用于删除已有用户的权限。执行 `REVOKE <privileges>` 语句需要拥有分配的权限，并且拥有 `GRANT OPTION` 权限。
 
@@ -128,6 +128,6 @@ ERROR 1141 (42000): There is no such grant defined for user 'newuser' on host '%
 
 ## 另请参阅
 
-* [GRANT <privileges>](/sql-statements/sql-statement-grant-privileges.md)
+* [`GRANT <privileges>`](/sql-statements/sql-statement-grant-privileges.md)
 * [SHOW GRANTS](/sql-statements/sql-statement-show-grants.md)
 * [Privilege Management](/privilege-management.md)

sql-statements/sql-statement-set-names.md

@@ -134,5 +134,5 @@ SHOW VARIABLES LIKE 'character_set%';
 ## 另请参阅
 
 * [SHOW \[GLOBAL|SESSION\] VARIABLES](/sql-statements/sql-statement-show-variables.md)
-* [SET <variable>](/sql-statements/sql-statement-set-variable.md)
+* [`SET <variable>`](/sql-statements/sql-statement-set-variable.md)
 * [Character Set Support](/character-set-and-collation.md)

sql-statements/sql-statement-set-transaction.md

@@ -99,5 +99,5 @@ SHOW SESSION VARIABLES LIKE 'transaction_isolation';
 
 ## 另请参阅
 
-* [SET \[GLOBAL|SESSION\] <variable>](/sql-statements/sql-statement-set-variable.md)
+* [`SET \[GLOBAL|SESSION\] <variable>`](/sql-statements/sql-statement-set-variable.md)
 * [Isolation Levels](/transaction-isolation-levels.md)

sql-statements/sql-statement-set-variable.md

@@ -5,7 +5,7 @@ category: reference
 aliases: ['/docs-cn/dev/reference/sql/statements/set-variable/']
 ---
 
-# SET [GLOBAL|SESSION] <variable>
+# `SET [GLOBAL|SESSION] <variable>`
 
 `SET [GLOBAL|SESSION]` 语句用于在 `SESSION` 或 `GLOBAL` 的范围内，对某个 TiDB 的内置变量进行更改。
 

sql-statements/sql-statement-show-privileges.md

@@ -70,4 +70,4 @@ show privileges;
 ## 另请参阅
 
 * [SHOW GRANTS](/sql-statements/sql-statement-show-grants.md)
-* [GRANT <privileges>](/sql-statements/sql-statement-grant-privileges.md)
+* [`GRANT <privileges>`](/sql-statements/sql-statement-grant-privileges.md)

tidb-binlog/binlog-slave-client.md

@@ -133,7 +133,7 @@ TiDB-Tools 项目提供了用于读取 Kafka 中 binlog 数据的 Driver，具
 * CommitTS：从哪个 commit ts 开始读取 binlog
 * Offset：从 Kafka 哪个 offset 开始读取，如果设置了 CommitTS 就不用配置该参数
 * ClusterID：TiDB 集群的 cluster ID
-* Topic: Kafka Topic 名称，如果 Topic 名称为空，将会使用 drainer <ClusterID>_obinlog 中的默认名称
+* Topic: Kafka Topic 名称，如果 Topic 名称为空，将会使用 drainer `<ClusterID>_obinlog` 中的默认名称
 
 用户以包的形式引用 Driver 的代码即可使用，可以参考 Driver 中提供的示例代码来学习如何使用 Driver 以及 binlog 数据的解析，目前提供了两个例子：
 

tidb-lightning/tidb-lightning-faq.md

@@ -35,7 +35,7 @@ TiDB Lightning 需要以下权限：
 * INSERT
 * DELETE
 
-+Importer-backend 无需以上两个权限，因为数据直接被 Ingest 到 TiKV 中，所以绕过了 TiDB 的权限系统。只要 TiKV、TiKV Importer 和 TiDB Lightning 的端口在集群之外不可访问，就可以保证安全。
+Importer-backend 无需以上两个权限，因为数据直接被 Ingest 到 TiKV 中，所以绕过了 TiDB 的权限系统。只要 TiKV、TiKV Importer 和 TiDB Lightning 的端口在集群之外不可访问，就可以保证安全。
 
 如果 TiDB Lightning 配置项 `checksum = true`，则 TiDB Lightning 需要有下游 TiDB admin 用户权限。
 

tidb-lightning/tidb-lightning-tidb-backend.md

@@ -100,7 +100,7 @@ on-duplicate = "replace" # 或者 “error”、“ignore”
 TiDB Lightning TiDB-backend 可以完全取代 [Loader](/loader-overview.md)。下表说明了如何将 [Loader](/loader-overview.md) 的配置迁移到 [TiDB Lightning 配置](/tidb-lightning/tidb-lightning-configuration.md)中：
 
 <table align="left">
-<thead><tr><th>Loader</th><th>TiDB Lightning</th></tr></thread>
+<thead><tr><th>Loader</th><th>TiDB Lightning</th></tr></thead>
 <tbody>
 <tr><td>
 

tiflash/maintain-tiflash.md

@@ -34,9 +34,9 @@ aliases: ['/docs-cn/dev/reference/tiflash/maintain/']
 
 | 日志信息          | 日志含义                |
 |---------------|---------------------|
-| [ 23 ] <Information> KVStore: Start to persist [region 47, applied: term 6 index 10] | 在 TiFlash 中看到类似日志代表数据开始同步（该日志开头方括号内的数字代表线程号，下同） |
-| [ 30 ] <Debug> CoprocessorHandler: grpc::Status DB::CoprocessorHandler::execute() | Handling DAG request，该日志代表 TiFlash 开始处理一个 Coprocessor 请求 |
-| [ 30 ] <Debug> CoprocessorHandler: grpc::Status DB::CoprocessorHandler::execute() | Handle DAG request done，该日志代表 TiFlash 完成 Coprocessor 请求的处理 |
+| [ 23 ] `<Information>` KVStore: Start to persist [region 47, applied: term 6 index 10] | 在 TiFlash 中看到类似日志代表数据开始同步（该日志开头方括号内的数字代表线程号，下同） |
+| [ 30 ] `<Debug>` CoprocessorHandler: grpc::Status DB::CoprocessorHandler::execute() | Handling DAG request，该日志代表 TiFlash 开始处理一个 Coprocessor 请求 |
+| [ 30 ] `<Debug>` CoprocessorHandler: grpc::Status DB::CoprocessorHandler::execute() | Handle DAG request done，该日志代表 TiFlash 完成 Coprocessor 请求的处理 |
 
 你可以找到一个 Coprocessor 请求的开始或结束，然后通过日志前面打印的线程号找到该 Coprocessor 请求的其他相关日志。
 

tikv-configuration-file.md

@@ -1140,7 +1140,7 @@ raftdb 相关配置项。
 
 ## import
 
-import 相关的配置项。
+用于 import 相关的配置项。
 
 ### `num-threads`
 

tiup/tiup-cluster.md

@@ -408,8 +408,7 @@ tiup cluster patch test-cluster /tmp/tidb-hotfix.tar.gz -N 172.16.4.5:4000
 
 ## 导入 TiDB Ansible 集群
 
-在 TiUP 之前，一般使用 TiDB Ansible 部署 TiDB 集群，import 命令用于将这部分集群过渡给 TiUP 接管。
-import 命令用法如下：
+在 TiUP 之前，一般使用 TiDB Ansible 部署 TiDB 集群，import 命令用于将这部分集群过渡给 TiUP 接管。import 命令用法如下：
 
 {{< copyable "shell-root" >}}