diff --git a/Cargo.lock b/Cargo.lock
index 4d200ec..64bb015 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -318,7 +318,7 @@ checksum = "841d1cc9bed7f9236f321df977030373f4a4163ae1a7dbfe1a51a2c1a51d9100"
 
 [[package]]
 name = "hoa-backend"
-version = "1.15.0"
+version = "1.15.1"
 dependencies = [
  "base64",
  "chrono",
diff --git a/src/formatter.rs b/src/formatter.rs
index 634dd21..2136849 100644
--- a/src/formatter.rs
+++ b/src/formatter.rs
@@ -1,6 +1,6 @@
 use regex::Regex;
-use std::fs;
 use std::path::Path;
+use tokio::fs;
 use walkdir::WalkDir;
 
 /// Format a single MDX file with all transformations
@@ -378,22 +378,35 @@ fn wrap_accordions_in_container(content: &str) -> String {
 }
 
 /// Format all MDX files in a directory recursively
-pub fn format_all_mdx_files(docs_dir: &Path) -> crate::error::Result<usize> {
-    let mut modified_count = 0;
+pub async fn format_all_mdx_files(docs_dir: &Path) -> crate::error::Result<usize> {
+    let mut tasks = Vec::new();
 
     for entry in WalkDir::new(docs_dir)
         .into_iter()
         .filter_map(|e| e.ok())
         .filter(|e| e.path().extension().is_some_and(|ext| ext == "mdx"))
     {
-        let path = entry.path();
-        let original = fs::read_to_string(path)?;
-        let formatted = format_mdx_file(&original);
+        let path = entry.path().to_path_buf();
 
-        if formatted != original {
-            fs::write(path, formatted)?;
-            modified_count += 1;
-        }
+        let task = tokio::spawn(async move {
+            let original = fs::read_to_string(&path).await?;
+            let formatted = format_mdx_file(&original);
+
+            if formatted != original {
+                fs::write(&path, formatted).await?;
+                Ok::<usize, std::io::Error>(1)
+            } else {
+                Ok::<usize, std::io::Error>(0)
+            }
+        });
+
+        tasks.push(task);
+    }
+
+    let mut modified_count = 0;
+    for task in tasks {
+        let res = task.await.unwrap()?; // unwrap JoinError, then ? for io::Error
+        modified_count += res;
     }
 
     Ok(modified_count)
@@ -739,4 +752,24 @@ Final $a$ inline."#;
         assert!(output.contains("x = $5"));
         assert!(output.contains(r#"let formula = "$$E=mc^2$$";"#));
     }
+
+    #[tokio::test]
+    async fn test_format_mdx_file_integration_async() {
+        let input = r#"<!-- comment -->
+# Title
+![badge](https://img.shields.io/test)
+<br>
+<div style="text-align:center;">Content</div>
+Math: $x = {1}$
+{{% details title="Test" %}}Answer{{% /details %}}"#;
+
+        let output = format_mdx_file(input);
+
+        // Check all transformations applied
+        assert!(!output.contains("<!--"));
+        assert!(!output.contains("shields.io"));
+        assert!(output.contains("<br />"));
+        assert!(output.contains("textAlign"));
+        assert!(output.contains("<Accordion"));
+    }
 }
diff --git a/src/generator.rs b/src/generator.rs
index c907960..2f51ca8 100644
--- a/src/generator.rs
+++ b/src/generator.rs
@@ -293,7 +293,10 @@ pub async fn generate_course_pages(
                 let frontmatter = build_frontmatter(&title, &course);
                 let use_course_info = !no_course_info_repo_ids.contains(repo_id);
                 let page_content = if use_course_info {
-                    format!("{}\n\n<CourseInfo />\n\n{}{}", frontmatter, content, filetree_content)
+                    format!(
+                        "{}\n\n<CourseInfo />\n\n{}{}",
+                        frontmatter, content, filetree_content
+                    )
                 } else {
                     format!("{}\n\n{}{}", frontmatter, content, filetree_content)
                 };
diff --git a/src/main.rs b/src/main.rs
index 527ec54..56cdad2 100644
--- a/src/main.rs
+++ b/src/main.rs
@@ -106,7 +106,10 @@ async fn main() -> Result<()> {
 
     let shared_categories_config = loader::load_shared_categories(&data_dir);
     if !shared_categories_config.categories.is_empty() {
-        println!("Loaded {} shared categories", shared_categories_config.categories.len());
+        println!(
+            "Loaded {} shared categories",
+            shared_categories_config.categories.len()
+        );
     }
 
     let grades_summary = loader::load_grades_summary(&data_dir);
@@ -149,7 +152,7 @@ async fn main() -> Result<()> {
 
     // Format MDX files
     println!("Formatting MDX files...");
-    let modified_count = formatter::format_all_mdx_files(&docs_dir)?;
+    let modified_count = formatter::format_all_mdx_files(&docs_dir).await?;
     println!("Formatted {} MDX files", modified_count);
 
     println!("\n✓ Done! All pages generated and formatted.");
diff --git a/src/models.rs b/src/models.rs
index 63d9e55..5a4063a 100644
--- a/src/models.rs
+++ b/src/models.rs
@@ -152,7 +152,7 @@ mod tests {
             title: "Test Course".to_string(),
             description: "A test description".to_string(),
             course: CourseMetadata {
-                credit: 3,
+                credit: 3.0,
                 assessment_method: "Exam".to_string(),
                 course_nature: "Required".to_string(),
                 hour_distribution: HourDistributionMeta {
@@ -193,7 +193,7 @@ mod tests {
             title: "Advanced Math".to_string(),
             description: "".to_string(),
             course: CourseMetadata {
-                credit: 4,
+                credit: 4.0,
                 assessment_method: "Mixed".to_string(),
                 course_nature: "Elective".to_string(),
                 hour_distribution: HourDistributionMeta {
@@ -238,7 +238,7 @@ mod tests {
             title: "Simple Course".to_string(),
             description: "No grading details".to_string(),
             course: CourseMetadata {
-                credit: 2,
+                credit: 2.0,
                 assessment_method: "Pass/Fail".to_string(),
                 course_nature: "Optional".to_string(),
                 hour_distribution: HourDistributionMeta {
@@ -265,7 +265,7 @@ mod tests {
             title: "Complex Course".to_string(),
             description: "".to_string(),
             course: CourseMetadata {
-                credit: 5,
+                credit: 5.0,
                 assessment_method: "Comprehensive".to_string(),
                 course_nature: "Core".to_string(),
                 hour_distribution: HourDistributionMeta {