diff --git a/src/lib/markdown.tsx b/src/lib/markdown.tsx
index 1ddde9d..1ff8f5c 100644
--- a/src/lib/markdown.tsx
+++ b/src/lib/markdown.tsx
@@ -1,5 +1,14 @@
+/**
+ * Markdown Rendering Utility
+ * Converts markdown text to styled React components
+ */
+
 import React from 'react';
 
+/**
+ * Parse inline markdown syntax (code, bold, italic, links)
+ * Converts inline markdown elements within a text string to React components
+ */
 function parseInlineMarkdown(text: string): React.ReactNode {
   const parts: React.ReactNode[] = [];
   let remaining = text;
@@ -63,6 +72,10 @@ function parseInlineMarkdown(text: string): React.ReactNode {
   return parts.length === 1 ? parts[0] : <>{parts}</>;
 }
 
+/**
+ * Render markdown content to React components
+ * Supports headers, lists, code blocks, tables, blockquotes, and inline formatting
+ */
 export function renderMarkdown(content: string): React.ReactNode {
   const lines = content.split('\n');
   const elements: React.ReactNode[] = [];