diff --git a/.markdownlint.js b/.markdownlint.js
new file mode 100644
index 0000000000..eb043f42c4
--- /dev/null
+++ b/.markdownlint.js
@@ -0,0 +1,2 @@
+const markdownlintGitHub = require('@github/markdownlint-github')
+module.exports = markdownlintGitHub.init()
diff --git a/package.json b/package.json
index 924638f57e..1212703dc9 100644
--- a/package.json
+++ b/package.json
@@ -25,6 +25,7 @@
     "compile:script": "tsc -P script/tsconfig.json",
     "lint": "yarn prettier && yarn lint:src",
     "lint:fix": "yarn prettier --write && yarn lint:src:fix",
+    "markdownlint": "markdownlint **/*.{md,mdx} --config .markdownlint.js --rules node_modules/@github/markdownlint-github --ignore node_modules --ignore gemoji",
     "prettier": "prettier --check \"./**/*.{ts,tsx,js,json,jsx,scss,html,yaml,yml}\"",
     "lint:src": "yarn eslint-check && yarn eslint",
     "lint:src:fix": "yarn eslint --fix",