diff --git a/crates/ide/src/markdown_remove.rs b/crates/ide/src/markdown_remove.rs
index 62b2aa1e7ce..405d08d8e1b 100644
--- a/crates/ide/src/markdown_remove.rs
+++ b/crates/ide/src/markdown_remove.rs
@@ -1,5 +1,8 @@
+//! Removes markdown from strings.
+
 use pulldown_cmark::{Event, Parser};
 
+/// Removes all markdown, keeping the text and code blocks
 pub fn remove_markdown(markdown: &str) -> String {
     let mut out = String::new();
     let parser = Parser::new(markdown);