diff --git a/types/showdown/index.d.ts b/types/showdown/index.d.ts
index 4721b64c75..21075fd6c7 100644
--- a/types/showdown/index.d.ts
+++ b/types/showdown/index.d.ts
@@ -297,8 +297,8 @@ declare namespace Showdown {
         /**
          * Converts an HTML string into a markdown string
          * 
-         * @param src
-         * @returns {string}
+         * @param src The input text (HTML)
+         * @returns The output markdown
          */
         makeMarkdown(src: string): string;