fix: fix markdown syntax & reference anchors in api/directives

Author: Zhang Visper

src/api/directives.md

@@ -2,77 +2,77 @@
 
 ## v-text
 
-- **预期：**`string`
+- **预期**：`string`
 
-- **详细：**
+- **详细**：
 
-  更新元素的 [textContent](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent)。如果要更新部分的 `textContent`，需要使用 `{{ Mustache }}` 插值。
+  更新元素的 [textContent](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent)。如果要更新部分的 `textContent`，需要使用 [Mustache  插值](/guide/template-syntax.html#文本)。
 
-- **示例：**
+- **示例**：
 
   ```html
   <span v-text="msg"></span>
-  <!-- same as -->
+  <!-- 等价于 -->
   <span>{{msg}}</span>
   ```
 
--  **参考：** [数据绑定语法 - 插值](../guide/template-syntax.html#text)
+- **参考**：[数据绑定语法 - 插值](/guide/template-syntax.html#文本)
 
 ## v-html
 
-- **预期：**`string`
+- **预期**：`string`
 
-- **详细：**
+- **详细**：
 
   更新元素的 [innerHTML](https://developer.mozilla.org/en-US/docs/Web/API/Element/innerHTML)。**注意：内容按普通 HTML 插入 - 不会作为 Vue 模板进行编译**。如果试图使用 `v-html` 组合模板，可以重新考虑是否通过使用组件来替代。
 
   :::warning
   在网站上动态渲染任意 HTML 是非常危险的，因为容易导致 [XSS 攻击](https://en.wikipedia.org/wiki/Cross-site_scripting)。只在可信内容上使用 `v-html`，**永不**用在用户提交的内容上。
   :::
 
-  在[单文件组件] (../guide/single-file-component.html 里，`scoped` 的样式不会应用在 `v-html` 内部，因为那部分 HTML 没有被 Vue 的模板编译器处理。如果你希望针对 `v-html` 的内容设置带作用域的 CSS，你可以替换为 [CSS modules](https://vue-loader.vuejs.org/en/features/css-modules.html) 或用一个额外的全局 `<style>` 元素手动设置类似 BEM 的作用域策略。
+  在[单文件组件](../guide/single-file-component.html)里，`scoped` 的样式不会应用在 `v-html` 内部，因为那部分 HTML 没有被 Vue 的模板编译器处理。如果你希望针对 `v-html` 的内容设置带作用域的 CSS，你可以替换为 [CSS modules](https://vue-loader.vuejs.org/en/features/css-modules.html) 或用一个额外的全局 `<style>` 元素手动设置类似 BEM 的作用域策略。
 
-- **示例：**
+- **示例**：
 
   ```html
   <div v-html="html"></div>
   ```
 
--  **参考：** [数据绑定语法 - 插值](../guide/template-syntax.html#raw-html)
+- **参考**：[数据绑定语法 - 插值](/guide/template-syntax.html#原始-html)
 
 ## v-show
 
-- **预期：**`any`
+- **预期**：`any`
 
-- **用法：**
+- **用法**：
 
-  根据表达式之真假值，切换元素的 `display` CSS property。
+  根据表达式的真假值，切换元素的 `display` CSS property。
 
   当条件变化时该指令触发过渡效果。
 
--  **参考：** [条件渲染 - v-show](../guide/conditional.html#v-show)
+- **参考**：[条件渲染 - v-show](../guide/conditional.html#v-show)
 
 ## v-if
 
-- **预期：**`any`
+- **预期**：`any`
 
-- **用法：**
+- **用法**：
 
-  根据表达式的值的 truthy-ness 来有条件地渲染元素。在切换时元素及它的数据绑定 / 组件被销毁并重建。如果元素是 `<template>`，将提取它的内容作为条件块。
+  根据表达式的真假值来有条件地渲染元素。在切换时元素及它的数据绑定 / 组件被销毁并重建。如果元素是 `<template>`，将提取它的内容作为条件块。
 
   当条件变化时该指令触发过渡效果。
 
-  当和 `v-if` 一起使用时，`v-for` 的优先级比 `v-if` 更高。详见[列表渲染教程](../guide/list.html#v-for-with-v-if)
+  当和 `v-if` 一起使用时，`v-for` 的优先级比 `v-if` 更高。详见[列表渲染教程](/guide/list.html#v-for-与-v-if-一同使用)
 
--  **参考：** [条件渲染 - v-if](../guide/conditional.html#v-if)
+- **参考**：[条件渲染 - v-if](../guide/conditional.html#v-if)
 
 ## v-else
 
 - **不需要表达式**
 
-- **限制：**前一兄弟元素必须有 `v-if` 或 `v-else-if`。
+- **限制**：前一兄弟元素必须有 `v-if` 或 `v-else-if`。
 
-- **用法：**
+- **用法**：
 
   为 `v-if` 或者 `v-else-if` 添加“else 块”。
 
@@ -85,15 +85,15 @@
   </div>
   ```
 
--  **参考：** [条件渲染 - v-else](../guide/conditional.html#v-else)
+- **参考**：[条件渲染 - v-else](../guide/conditional.html#v-else)
 
 ## v-else-if
 
-- **预期：**`any`
+- **预期**：`any`
 
-- **限制：**前一兄弟元素必须有 `v-if` 或 `v-else-if`。
+- **限制**：前一兄弟元素必须有 `v-if` 或 `v-else-if`。
 
-- **用法：**
+- **用法**：
 
   表示 `v-if` 的“else if 块”。可以链式调用。
 
@@ -112,13 +112,13 @@
   </div>
   ```
 
--  **参考：** [条件渲染- v-else-if](../guide/conditional.html#v-else-if)
+- **参考**：[条件渲染- v-else-if](../guide/conditional.html#v-else-if)
 
 ## v-for
 
-- **预期：**`Array | Object | number | string | Iterable`
+- **预期**：`Array | Object | number | string | Iterable`
 
-- **用法：**
+- **用法**：
 
   基于源数据多次渲染元素或模板块。此指令之值，必须使用特定语法 `alias in expression`，为当前遍历的元素提供别名：
 
@@ -148,22 +148,22 @@
 
   `v-for` 的详细用法可以通过以下链接查看教程详细说明。
 
--  **参考：**
+- **参考**：
   - [列表渲染](../guide/list.html)
 
 ## v-on
 
-- **缩写：**`@`
+- **缩写**：`@`
 
-- **预期：**`Function | Inline Statement | Object`
+- **预期**：`Function | Inline Statement | Object`
 
-- **参数：**`event`
+- **参数**：`event`
 
-- **修饰符：**
+- **修饰符**：
 
   - `.stop` - 调用 `event.stopPropagation()`。
   - `.prevent` - 调用 `event.preventDefault()`。
-  - `.capture` - - 添加事件侦听器时使用 capture 模式。
+  - `.capture` - 添加事件侦听器时使用 capture 模式。
   - `.self` - 只当事件是从侦听器绑定的元素本身触发时才触发回调。
   - `.{keyAlias}` - 仅当事件是从特定键触发时才触发回调。
   - `.once` - 只触发一次回调。
@@ -172,7 +172,7 @@
   - `.middle` - 只当点击鼠标中键时触发。
   - `.passive` - `{ passive: true }` 模式添加侦听器
 
-- **用法：**
+- **用法**：
 
   绑定事件监听器。事件类型由参数指定。表达式可以是一个方法的名字或一个内联语句，如果没有修饰符也可以省略。
 
@@ -182,7 +182,7 @@
 
   `v-on` 同样支持不带参数绑定一个事件/监听器键值对的对象。注意当使用对象语法时，是不支持任何修饰器的。
 
-- **示例：**
+- **示例**：
 
   ```html
   <!-- 方法处理器 -->
@@ -231,23 +231,23 @@
   <my-component @my-event="handleThis(123, $event)"></my-component>
   ```
 
--  **参考：**
-  - [事件处理器]](../guide/events.html)
-  - [组件 - 自定义事件](../guide/component-basics.html#listening-to-child-components-events)
+- **参考**：
+  - [事件处理器](../guide/events.html)
+  - [组件 - 自定义事件](../guide/component-basics.html#监听子组件事件)
 
 ## v-bind
 
-- **缩写：**`:`
+- **缩写**：`:`
 
-- **预期：**`any (with argument) | Object (without argument)`
+- **预期**：`any (with argument) | Object (without argument)`
 
-- **参数：**`attrOrProp (optional)`
+- **参数**：`attrOrProp (optional)`
 
-- **修饰符：**
+- **修饰符**：
 
   - `.camel` - 将 kebab-case attribute 名转换为 camelCase。
 
-- **用法：**
+- **用法**：
 
   动态地绑定一个或多个 attribute，或一个组件 prop 到表达式。
 
@@ -257,7 +257,7 @@
 
   没有参数时，可以绑定到一个包含键值对的对象。注意此时 `class` 和 `style` 绑定不支持数组和对象。
 
-- **示例：**
+- **示例**：
 
   ```html
   <!-- 绑定 attribute -->
@@ -305,53 +305,53 @@
 
   在使用字符串模板或通过 `vue-loader` / `vueify` 编译时，无需使用 `.camel`。
 
--  **参考：**
+- **参考**：
   - [Class 和 Style 绑定](../guide/class-and-style.html)
-  - [组件 - Props](../guide/component-basics.html#passing-data-to-child-components-with-props)
+  - [组件 - Props](../guide/component-basics.html#通过-prop-向子组件传递数据)
 
 ## v-model
 
-- **预期：**随表单控件类型不同而不同。
+- **预期**：随表单控件类型不同而不同。
 
-- **限制于：**
+- **限制于**：
 
   - `<input>`
   - `<select>`
   - `<textarea>`
   - components
 
-- **修饰符：**
+- **修饰符**：
 
-  - [`.lazy`](../guide/forms.html#lazy) -  取代 `input` 监听 `change` 事件
+  - [`.lazy`](../guide/forms.html#lazy) - 监听 `change` 而不是 `input` 事件
   - [`.number`](../guide/forms.html#number) - 输入字符串转为有效的数字
   - [`.trim`](../guide/forms.html#trim) - 输入首尾空格过滤
 
-- **用法：**
+- **用法**：
 
   在表单控件或者组件上创建双向绑定。细节请看下面的教程链接。
 
--  **参考：**
+- **参考**：
   - [表单控件绑定](../guide/forms.html)
-  - [组件 - 在输入组件上使用自定义事件](../guide/component-custom-events.html#v-model-arguments)
+  - [组件 - 在输入组件上使用自定义事件](../guide/component-custom-events.html#v-model-参数)
 
 ## v-slot
 
-- **缩写：**`#`
+- **缩写**：`#`
 
-- **预期：**可放置在函数参数位置的 JavaScript 表达式 (在[支持的环境](../guide/component-slots.html#destructuring-slot-props)下可使用解构)。可选，即只需要在为插槽传入 prop 的时候使用。
+- **预期**：可放置在函数参数位置的 JavaScript 表达式 (在[支持的环境](../guide/component-slots.html#解构插槽-prop)下可使用解构)。可选，即只需要在为插槽传入 prop 的时候使用。
 
-- **参数：**插槽名 (可选，默认值是 `default`)
+- **参数**：插槽名 (可选，默认值是 `default`)
 
-- **限用于：**
+- **限用于**：
 
   - `<template>`
-  - [组件](../guide/component-slots.html#abbreviated-syntax-for-lone-default-slots) (对于一个单独的带 prop 的默认插槽)
+  - [组件](../guide/component-slots.html#独占默认插槽的缩写语法) (对于一个单独的带 prop 的默认插槽)
 
-- **用法：**
+- **用法**：
 
   提供具名插槽或需要接收 prop 的插槽。
 
-- **示例：**
+- **示例**：
 
   ```html
   <!-- 具名插槽 -->
@@ -386,18 +386,18 @@
 
   更多细节请查阅以下链接。
 
--  **参考：**
+- **参考**：
   - [组件 - 插槽](../guide/component-slots.html)
 
 ## v-pre
 
 - **不需要表达式**
 
-- **用法：**
+- **用法**：
 
   跳过这个元素和它的子元素的编译过程。可以用来显示原始 Mustache 标签。跳过大量没有指令的节点会加快编译。
 
-- **示例：**
+- **示例**：
 
   ```html
   <span v-pre>{{ this will not be compiled }}</span>
@@ -407,11 +407,11 @@
 
 - **不需要表达式**
 
-- **用法：**
+- **用法**：
 
   这个指令保持在元素上直到关联组件实例结束编译。和 CSS 规则如 `[v-cloak] { display: none }` 一起用时，这个指令可以隐藏未编译的 Mustache 标签直到组件实例准备完毕。
 
-- **示例：**
+- **示例**：
 
   ```css
   [v-cloak] {
@@ -431,7 +431,7 @@
 
 - **不需要表达式**
 
-- **详细：**
+- **详细**：
 
   只渲染元素和组件**一次**。随后的重新渲染，元素/组件及其所有的子节点将被视为静态内容并跳过。这可以用于优化更新性能。
 
@@ -451,18 +451,18 @@
   </ul>
   ```
 
--  **参考：**
-  - [数据绑定语法- 插值](../guide/template-syntax.html#text)
+- **参考**：
+  - [数据绑定语法- 插值](../guide/template-syntax.html#文本)
 
 ## v-is
 
 > 注意：本节仅影响直接在页面的 HTML 中写入 Vue 模板的情况。
 
-- **预期：**字符串文本
+- **预期**：字符串文本
 
-- **限制于：**原生 HTML 元素
+- **限制于**：原生 HTML 元素
 
-- **用法：**在 DOM 内模板使用时，模板受原生 HTML 解析规则的约束。某些 HTML 元素，如：`<ul>`、`<ol>`、`<table>` 和 `<select>` 等，对哪些元素可以出现在它们内部有限制，而某些元素 (如：`<li>`、`<tr>` 和 `<option>` 只能出现在某些其他元素中。作为解决方法，我们可以对以下元素使用 `v-is` 指令：
+- **用法**：在 DOM 内模板使用时，模板受原生 HTML 解析规则的约束。某些 HTML 元素，如：`<ul>`、`<ol>`、`<table>` 和 `<select>` 等，对哪些元素可以出现在它们内部有限制，而某些元素 (如：`<li>`、`<tr>` 和 `<option>` 只能出现在某些其他元素中。作为解决方法，我们可以对以下元素使用 `v-is` 指令：
 
 ```html
 <table>