.markdownlint.yml

@@ -0,0 +1,23 @@
+line-length: false
+single-title: false
+no-inline-html:
+  allowed_elements:
+    - badge
+    - eslint-code-block
+    - sup
+
+# enforce consistency
+code-block-style:
+  style: fenced
+code-fence-style:
+  style: backtick
+emphasis-style:
+  style: asterisk
+heading-style:
+  style: atx
+hr-style:
+  style: ---
+strong-style:
+  style: asterisk
+ul-style:
+  style: dash

.markdownlintignore

@@ -0,0 +1 @@
+node_modules

docs/rules/README.md

@@ -12,7 +12,6 @@ sidebarDepth: 0
   :bulb: Indicates that some problems reported by the rule are manually fixable by editor [suggestions](https://eslint.org/docs/developer-guide/working-with-rules#providing-suggestions).
 :::
 
-
 ## Base Rules (Enabling Correct ESLint Parsing)
 
 Enforce all the rules in this category, as well as all higher priority rules, with:
@@ -167,7 +166,7 @@ Enforce all the rules in this category, as well as all higher priority rules, wi
 | Rule ID | Description |    |
 |:--------|:------------|:---|
 | [vue/attributes-order](./attributes-order.md) | enforce order of attributes | :wrench: |
-| [vue/component-tags-order](./component-tags-order.md) | enforce order of component top-level elements |  |
+| [vue/component-tags-order](./component-tags-order.md) | enforce order of component top-level elements | :wrench: |
 | [vue/no-lone-template](./no-lone-template.md) | disallow unnecessary `<template>` |  |
 | [vue/no-multiple-slot-args](./no-multiple-slot-args.md) | disallow to pass multiple arguments to scoped slots |  |
 | [vue/no-v-html](./no-v-html.md) | disallow use of v-html to prevent XSS attack |  |
@@ -283,7 +282,7 @@ Enforce all the rules in this category, as well as all higher priority rules, wi
 | Rule ID | Description |    |
 |:--------|:------------|:---|
 | [vue/attributes-order](./attributes-order.md) | enforce order of attributes | :wrench: |
-| [vue/component-tags-order](./component-tags-order.md) | enforce order of component top-level elements |  |
+| [vue/component-tags-order](./component-tags-order.md) | enforce order of component top-level elements | :wrench: |
 | [vue/no-lone-template](./no-lone-template.md) | disallow unnecessary `<template>` |  |
 | [vue/no-multiple-slot-args](./no-multiple-slot-args.md) | disallow to pass multiple arguments to scoped slots |  |
 | [vue/no-v-html](./no-v-html.md) | disallow use of v-html to prevent XSS attack |  |
@@ -335,6 +334,7 @@ For example:
 | [vue/no-restricted-class](./no-restricted-class.md) | disallow specific classes in Vue components |  |
 | [vue/no-restricted-component-options](./no-restricted-component-options.md) | disallow specific component option |  |
 | [vue/no-restricted-custom-event](./no-restricted-custom-event.md) | disallow specific custom event | :bulb: |
+| [vue/no-restricted-html-elements](./no-restricted-html-elements.md) | disallow specific HTML elements |  |
 | [vue/no-restricted-props](./no-restricted-props.md) | disallow specific props | :bulb: |
 | [vue/no-restricted-static-attribute](./no-restricted-static-attribute.md) | disallow specific attribute |  |
 | [vue/no-restricted-v-bind](./no-restricted-v-bind.md) | disallow specific argument in `v-bind` |  |
@@ -353,6 +353,7 @@ For example:
 | [vue/no-v-text](./no-v-text.md) | disallow use of v-text |  |
 | [vue/padding-line-between-blocks](./padding-line-between-blocks.md) | require or disallow padding lines between blocks | :wrench: |
 | [vue/prefer-import-from-vue](./prefer-import-from-vue.md) | enforce import from 'vue' instead of import from '@vue/*' | :wrench: |
+| [vue/prefer-prop-type-boolean-first](./prefer-prop-type-boolean-first.md) | enforce `Boolean` comes first in component prop types | :bulb: |
 | [vue/prefer-separate-static-class](./prefer-separate-static-class.md) | require static class names in template to be in a separate `class` attribute | :wrench: |
 | [vue/prefer-true-attribute-shorthand](./prefer-true-attribute-shorthand.md) | require shorthand form attribute when `v-bind` value is `true` | :bulb: |
 | [vue/require-direct-export](./require-direct-export.md) | require the component to be directly exported |  |

docs/rules/component-tags-order.md

@@ -10,6 +10,7 @@ since: v6.1.0
 > enforce order of component top-level elements
 
 - :gear: This rule is included in `"plugin:vue/vue3-recommended"` and `"plugin:vue/recommended"`.
+- :wrench: The `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#fixing-problems) can automatically fix some of the problems reported by this rule.
 
 ## :book: Rule Details
 
@@ -29,7 +30,7 @@ This rule warns about the order of the `<script>`, `<template>` & `<style>` tags
 
 ### `{ "order": [ [ "script", "template" ], "style" ] }` (default)
 
-<eslint-code-block :rules="{'vue/component-tags-order': ['error']}">
+<eslint-code-block fix :rules="{'vue/component-tags-order': ['error']}">
 
 ```vue
 <!-- ✓ GOOD -->
@@ -40,7 +41,7 @@ This rule warns about the order of the `<script>`, `<template>` & `<style>` tags
 
 </eslint-code-block>
 
-<eslint-code-block :rules="{'vue/component-tags-order': ['error']}">
+<eslint-code-block fix :rules="{'vue/component-tags-order': ['error']}">
 
 ```vue
 <!-- ✓ GOOD -->
@@ -51,7 +52,7 @@ This rule warns about the order of the `<script>`, `<template>` & `<style>` tags
 
 </eslint-code-block>
 
-<eslint-code-block :rules="{'vue/component-tags-order': ['error']}">
+<eslint-code-block fix :rules="{'vue/component-tags-order': ['error']}">
 
 ```vue
 <!-- ✗ BAD -->
@@ -64,7 +65,7 @@ This rule warns about the order of the `<script>`, `<template>` & `<style>` tags
 
 ### `{ "order": ["template", "script", "style"] }`
 
-<eslint-code-block :rules="{'vue/component-tags-order': ['error', { 'order': ['template', 'script', 'style'] }]}">
+<eslint-code-block fix :rules="{'vue/component-tags-order': ['error', { 'order': ['template', 'script', 'style'] }]}">
 
 ```vue
 <!-- ✓ GOOD -->
@@ -75,7 +76,7 @@ This rule warns about the order of the `<script>`, `<template>` & `<style>` tags
 
 </eslint-code-block>
 
-<eslint-code-block :rules="{'vue/component-tags-order': ['error', { 'order': ['template', 'script', 'style'] }]}">
+<eslint-code-block fix :rules="{'vue/component-tags-order': ['error', { 'order': ['template', 'script', 'style'] }]}">
 
 ```vue
 <!-- ✗ BAD -->
@@ -88,7 +89,7 @@ This rule warns about the order of the `<script>`, `<template>` & `<style>` tags
 
 ### `{ "order": ["docs", "template", "script", "style"] }`
 
-<eslint-code-block :rules="{'vue/component-tags-order': ['error', { 'order': ['docs', 'template', 'script', 'style'] }]}">
+<eslint-code-block fix :rules="{'vue/component-tags-order': ['error', { 'order': ['docs', 'template', 'script', 'style'] }]}">
 
 ```vue
 <!-- ✓ GOOD -->
@@ -100,7 +101,7 @@ This rule warns about the order of the `<script>`, `<template>` & `<style>` tags
 
 </eslint-code-block>
 
-<eslint-code-block :rules="{'vue/component-tags-order': ['error', { 'order': ['docs', 'template', 'script', 'style'] }]}">
+<eslint-code-block fix :rules="{'vue/component-tags-order': ['error', { 'order': ['docs', 'template', 'script', 'style'] }]}">
 
 ```vue
 <!-- ✗ BAD -->

docs/rules/custom-event-name-casing.md

@@ -163,6 +163,11 @@ export default {
 
 </eslint-code-block>
 
+## :couple: Related Rules
+
+- [vue/v-on-event-hyphenation](./v-on-event-hyphenation.md)
+- [vue/prop-name-casing](./prop-name-casing.md)
+
 ## :books: Further Reading
 
 - [Guide - Custom Events]
@@ -171,11 +176,6 @@ export default {
 [Guide - Custom Events]: https://vuejs.org/guide/components/events.html
 [Guide (for v2) - Custom Events]: https://v2.vuejs.org/v2/guide/components-custom-events.html
 
-## :couple: Related Rules
-
-- [vue/v-on-event-hyphenation](./v-on-event-hyphenation.md)
-- [vue/prop-name-casing](./prop-name-casing.md)
-
 ## :rocket: Version
 
 This rule was introduced in eslint-plugin-vue v7.0.0

docs/rules/html-closing-bracket-newline.md

@@ -66,11 +66,11 @@ This rule aims to warn the right angle brackets which are at the location other
 ```
 
 - `singleline` ... the configuration for single-line elements. It's a single-line element if the element does not have attributes or the last attribute is on the same line as the opening bracket.
-    - `"never"` (default) ... disallow line breaks before the closing bracket.
-    - `"always"` ... require one line break before the closing bracket.
+  - `"never"` (default) ... disallow line breaks before the closing bracket.
+  - `"always"` ... require one line break before the closing bracket.
 - `multiline` ... the configuration for multiline elements. It's a multiline element if the last attribute is not on the same line of the opening bracket.
-    - `"never"` ... disallow line breaks before the closing bracket.
-    - `"always"` (default) ... require one line break before the closing bracket.
+  - `"never"` ... disallow line breaks before the closing bracket.
+  - `"always"` (default) ... require one line break before the closing bracket.
 
 Plus, you can use [`vue/html-indent`](./html-indent.md) rule to enforce indent-level of the closing brackets.
 

docs/rules/html-closing-bracket-spacing.md

@@ -55,14 +55,14 @@ This rule aims to enforce consistent spacing style before closing brackets `>` o
 ```
 
 - `startTag` (`"always" | "never"`) ... Setting for the `>` of start tags (e.g. `<div>`). Default is `"never"`.
-    - `"always"` ... requires one or more spaces.
-    - `"never"` ... disallows spaces.
+  - `"always"` ... requires one or more spaces.
+  - `"never"` ... disallows spaces.
 - `endTag` (`"always" | "never"`) ... Setting for the `>` of end tags (e.g. `</div>`). Default is `"never"`.
-    - `"always"` ... requires one or more spaces.
-    - `"never"` ... disallows spaces.
+  - `"always"` ... requires one or more spaces.
+  - `"never"` ... disallows spaces.
 - `selfClosingTag` (`"always" | "never"`) ... Setting for the `/>` of self-closing tags (e.g. `<div/>`). Default is `"always"`.
-    - `"always"` ... requires one or more spaces.
-    - `"never"` ... disallows spaces.
+  - `"always"` ... requires one or more spaces.
+  - `"never"` ... disallows spaces.
 
 ### `"startTag": "always", "endTag": "always", "selfClosingTag": "always"`
 

docs/rules/html-comment-content-newline.md

@@ -56,21 +56,21 @@ This rule will enforce consistency of line break after the `<!--` and before the
 ```
 
 - The first option is either an object with `"singleline"` and `"multiline"` keys.
-    - `singleline` ... the configuration for single-line comments.
-        - `"never"` (default) ... disallow line breaks after the `<!--` and before the `-->`.
-        - `"always"` ... require one line break after the `<!--` and before the `-->`.
-    - `multiline` ... the configuration for multiline comments.
-        - `"never"` ... disallow line breaks after the `<!--` and before the `-->`.
-        - `"always"` (default) ... require one line break after the `<!--` and before the `-->`.
+  - `singleline` ... the configuration for single-line comments.
+    - `"never"` (default) ... disallow line breaks after the `<!--` and before the `-->`.
+    - `"always"` ... require one line break after the `<!--` and before the `-->`.
+  - `multiline` ... the configuration for multiline comments.
+    - `"never"` ... disallow line breaks after the `<!--` and before the `-->`.
+    - `"always"` (default) ... require one line break after the `<!--` and before the `-->`.
 
-    You can also set the same value for both `singleline` and `multiline` by specifies a string.
+  You can also set the same value for both `singleline` and `multiline` by specifies a string.
 
 - This rule can also take a 2nd option, an object with the following key: `"exceptions"`.
-    - The `"exceptions"` value is an array of string patterns which are considered exceptions to the rule.
+  - The `"exceptions"` value is an array of string patterns which are considered exceptions to the rule.
 
-    ```json
-    "vue/html-comment-content-newline": ["error", { ... }, { "exceptions": ["*"] }]
-    ```
+  ```json
+  "vue/html-comment-content-newline": ["error", { ... }, { "exceptions": ["*"] }]
+  ```
 
 ### `"always"`
 
@@ -162,7 +162,6 @@ This rule will enforce consistency of line break after the `<!--` and before the
 
 </eslint-code-block>
 
-
 ### `{"singleline": "ignore", "multiline": "always"}`
 
 <eslint-code-block fix :rules="{'vue/html-comment-content-newline': ['error', { 'singleline': 'ignore', 'multiline': 'always' }]}">

docs/rules/html-comment-content-spacing.md

@@ -48,17 +48,16 @@ Whitespace after the `<!--` and before the `-->` makes it easier to read text in
 ```
 
 - The first is a string which be either `"always"` or `"never"`. The default is `"always"`.
-    - `"always"` (default) ... there must be at least one whitespace at after the `<!--` and before the `-->`.
-    - `"never"` ... there should be no whitespace at after the `<!--` and before the `-->`.
-
+  - `"always"` (default) ... there must be at least one whitespace at after the `<!--` and before the `-->`.
+  - `"never"` ... there should be no whitespace at after the `<!--` and before the `-->`.
 
 - This rule can also take a 2nd option, an object with the following key: `"exceptions"`.
-    - The `"exceptions"` value is an array of string patterns which are considered exceptions to the rule.
-    Please note that exceptions are ignored if the first argument is `"never"`.
+  - The `"exceptions"` value is an array of string patterns which are considered exceptions to the rule.
+  Please note that exceptions are ignored if the first argument is `"never"`.
 
-    ```json
-    "vue/html-comment-content-spacing": ["error", "always", { "exceptions": ["*"] }]
-    ```
+  ```json
+  "vue/html-comment-content-spacing": ["error", "always", { "exceptions": ["*"] }]
+  ```
 
 ### `"always"`
 

docs/rules/max-len.md

@@ -112,7 +112,6 @@ var foo = ['line', 'length', 'is', '50', '......']
 
 </eslint-code-block>
 
-
 ### `"template": 120`
 
 <eslint-code-block :rules="{'vue/max-len': ['error', {template: 120}]}">

docs/rules/new-line-between-multi-line-property.md

@@ -75,7 +75,7 @@ export default {
 
 </eslint-code-block>
 
-## :wrench: Option
+## :wrench: Options
 
 ```json
 {

docs/rules/next-tick-style.md

@@ -46,6 +46,7 @@ export default {
 </eslint-code-block>
 
 ## :wrench: Options
+
 Default is set to `promise`.
 
 ```json

docs/rules/no-bare-strings-in-template.md

@@ -16,7 +16,6 @@ In order to be able to internationalize your application, you will need to avoid
 
 This rule was inspired by [no-bare-strings rule in ember-template-lint](https://github.com/ember-template-lint/ember-template-lint/blob/master/docs/rule/no-bare-strings.md).
 
-
 <eslint-code-block :rules="{'vue/no-bare-strings-in-template': ['error']}">
 
 ```vue

docs/rules/no-boolean-default.md

@@ -13,8 +13,8 @@ since: v7.0.0
 
 The rule prevents Boolean props from having a default value.
 
-
 ## :book: Rule Details
+
 The rule is to enforce the HTML standard of always defaulting boolean attributes to false.
 
 <eslint-code-block fix :rules="{'vue/no-boolean-default': ['error']}">
@@ -38,13 +38,19 @@ export default {
 </eslint-code-block>
 
 ## :wrench: Options
+
 - `'no-default'` (default) allows a prop definition object, but enforces that the `default` property not be defined.
 - `'default-false'` enforces that the default can be set but must be set to `false`.
 
 ```json
   "vue/no-boolean-default": ["error", "no-default|default-false"]
 ```
 
+## :couple: Related Rules
+
+- [vue/prefer-true-attribute-shorthand](./prefer-true-attribute-shorthand.md)
+- [vue/require-default-prop](./require-default-prop.md)
+
 ## :rocket: Version
 
 This rule was introduced in eslint-plugin-vue v7.0.0

docs/rules/no-custom-modifiers-on-v-model.md

@@ -11,7 +11,7 @@ since: v7.0.0
 
 - :gear: This rule is included in all of `"plugin:vue/essential"`, `"plugin:vue/strongly-recommended"` and `"plugin:vue/recommended"`.
 
-This rule checks whether `v-model `used on the component do not have custom modifiers.
+This rule checks whether `v-model` used on the component do not have custom modifiers.
 
 ## :book: Rule Details
 

docs/rules/no-empty-component-block.md

@@ -14,7 +14,7 @@ since: v7.0.0
 This rule disallows the `<template>` `<script>` `<style>` block to be empty.
 
 This rule also checks block what has attribute `src`.
-See: https://vue-loader.vuejs.org/spec.html#src-imports
+See [Vue Single-File Component (SFC) Spec](https://vue-loader.vuejs.org/spec.html#src-imports).
 
 <eslint-code-block :rules="{'vue/no-empty-component-block': ['error']}">
 

docs/rules/no-invalid-model-keys.md

@@ -108,7 +108,6 @@ export default {
 
 </eslint-code-block>
 
-
 ## :rocket: Version
 
 This rule was introduced in eslint-plugin-vue v7.9.0

docs/rules/no-parsing-error.md

@@ -16,10 +16,10 @@ This rule reports syntax errors in `<template>`. For example:
 - Syntax errors of scripts in directives.
 - Syntax errors of scripts in mustaches.
 - Syntax errors of HTML.
-    - Invalid end tags.
-    - Attributes in end tags.
-    - ...
-    - See also: [WHATWG HTML spec](https://html.spec.whatwg.org/multipage/parsing.html#parse-errors)
+  - Invalid end tags.
+  - Attributes in end tags.
+  - ...
+  - See also: [WHATWG HTML spec](https://html.spec.whatwg.org/multipage/parsing.html#parse-errors)
 
 ## :book: Rule Details
 

docs/rules/no-potential-component-option-typo.md

@@ -15,7 +15,7 @@ since: v7.0.0
 
 This rule disallow a potential typo in your component options
 
-**Here is the config**
+### Here is the config
 
 ```json
 {
@@ -59,7 +59,7 @@ export default {
 
 > we use edit distance to compare two string similarity, threshold is an option to control upper bound of edit distance to report
 
-**Here is the another example about config option `threshold`**
+### Here is the another example about config option `threshold`
 
 ```json
 {

docs/rules/no-restricted-class.md

@@ -70,6 +70,7 @@ export default {
 }
 </script>
 ```
+
 :::
 
 ## :rocket: Version