diff --git a/helix-lsp-types/src/lib.rs b/helix-lsp-types/src/lib.rs
index ddb333db3..fd668de5f 100644
--- a/helix-lsp-types/src/lib.rs
+++ b/helix-lsp-types/src/lib.rs
@@ -2568,9 +2568,9 @@ pub enum Documentation {
 ///
 /// The pair of a language and a value is an equivalent to markdown:
 ///
-/// ```language
-/// value
-/// ```
+/// <pre><code>```${language}
+/// ${value}
+/// ```</code></pre>
 #[derive(Debug, Eq, PartialEq, Clone, Deserialize, Serialize)]
 #[serde(untagged)]
 pub enum MarkedString {