diff --git a/.editorconfig b/.editorconfig
index 9b9ea1fd..6d5dc09a 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -20,5 +20,8 @@ indent_style = space
 indent_size = 2
 
 # Markdown Files
+#
+# Two spaces at the end of a line in Markdown mean "new line",
+# so trimming trailing whitespace for such files can cause breakage.
 [*.md]
 trim_trailing_whitespace = false