diff --git a/docs/CHANGELOG.asciidoc b/docs/CHANGELOG.asciidoc
index e49584d87eb128..2c67b6b653b058 100644
--- a/docs/CHANGELOG.asciidoc
+++ b/docs/CHANGELOG.asciidoc
@@ -131,6 +131,13 @@ Observability::
 
 Review the following information about the 7.17.1 release.
 
+[float]
+[[known-issue-v7.17.1]]
+=== Known issue
+
+Lens & visualizations::
+A change in the Markdown library that {kib} uses to create *TSVB* *Markdown* visualizations and *Text* dashboard panels renders some tables differently. For more information, check out link:https://github.com/markdown-it/markdown-it/pull/767[#767]. 
+
 [float]
 [[breaking-changes-v7.17.1]]
 === Breaking changes