diff --git a/.gitattributes b/.gitattributes
index 12cff929..0af13c51 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1,6 +1,12 @@
-# Ignore Markdown files for language statistics
-*.html linguist-detectable=false
+# Documentation
+*.html linguist-documentation
+docs/* linguist-documentation
+docs/examples/* linguist-documentation
 docs/md_v2/* linguist-documentation
 
-# Force Python files to be detected
+# Explicitly mark Python as the main language
+*.py linguist-detectable=true
 *.py linguist-language=Python
+
+# Exclude HTML from language statistics
+*.html linguist-detectable=false