diff --git a/Makefile b/Makefile
index 54a9a816..716c3814 100644
--- a/Makefile
+++ b/Makefile
@@ -26,7 +26,7 @@ lint-openapi:
 	npm run lint:openapi
 
 lint-spectral:
-	npx spectral lint openapi.yaml --fail-severity=error
+	npm run lint:spectral
 
 lint-markdown:
 	npm run lint:markdown
diff --git a/package.json b/package.json
index dbaec30c..b5aa3d1d 100644
--- a/package.json
+++ b/package.json
@@ -5,7 +5,9 @@
   "scripts": {
     "build:openapi": "npx @redocly/cli bundle openapi/openapi.yaml -o openapi.yaml && cp openapi.yaml mintlify/openapi.yaml",
     "prelint:openapi": "npm run build:openapi",
-    "lint:openapi": "npx @redocly/cli bundle openapi/openapi.yaml -o openapi.yaml && npx @redocly/cli lint openapi.yaml && npx spectral lint openapi.yaml --fail-severity=error && cp openapi.yaml mintlify/openapi.yaml",
+    "lint:openapi": "npx @redocly/cli bundle openapi/openapi.yaml -o openapi.yaml && npx @redocly/cli lint openapi.yaml && spectral lint openapi.yaml --fail-severity=error && cp openapi.yaml mintlify/openapi.yaml",
+    "lint:spectral": "spectral lint openapi.yaml --fail-severity=error",
+    "lint:markdown": "markdownlint \"mintlify/**/*.mdx\"",
     "lint": "npm run lint:openapi",
     "broken-links": "cd mintlify && mint broken-links",
     "validate": "npm run lint",