fix: add error context and improve documentation for Markdown generation

- Add .with_context() to push_str() for consistency with other generators
- Differentiate documentation comment for internal implementation function
- Addresses Copilot PR review feedback

Author: GordonSmith

wit-bindgen-wasm/src/lib.rs

@@ -429,11 +429,15 @@ impl WitBindgen {
         }
     }
 
-    /// Generate Markdown documentation using wit-bindgen-markdown library
+    /// Internal implementation for generating Markdown documentation.
+    /// 
+    /// This function performs the actual Markdown generation using the wit-bindgen-markdown library.
+    /// It returns a `Result` containing a map of generated files, or an error if generation fails.
     fn generate_markdown_with_wit_bindgen(&self, content: &str, world_name: Option<&str>) -> Result<HashMap<String, String>, anyhow::Error> {
         let inline_path = Path::new("inline.wit");
         let mut resolve = Resolve::default();
-        let package_id = resolve.push_str(inline_path, content)?;
+        let package_id = resolve.push_str(inline_path, content)
+            .with_context(|| "Failed to parse WIT content for Markdown generation")?;
 
         let world_id = if let Some(world_name) = world_name {
             resolve.select_world(&[package_id], Some(world_name))?