Handle messy md code samples containing neste code blocks and texts

Author: gmourier

guides/front_end/front_end_integration.mdx

@@ -2,6 +2,7 @@
 title: Front-end integration — Meilisearch documentation
 description: Create a simple front-end interface to search through your dataset after following Meilisearch's quick start.
 ---
+import GettingStartedFrontEndIntegrationMd from '/snippets/getting_started_front_end_integration_md.mdx';
 
 # Front-end integration
 
@@ -16,6 +17,6 @@ Using [`instant-meilisearch`](https://github.com/meilisearch/instant-meilisearch
 3. Copy-paste one of the code samples above—either vanilla JavaScript, Vue 2, or React— and save the file
 4. Open `index.html` in your browser by double-clicking it in your folder
 
-<CodeSamples id="getting_started_front_end_integration_md" />
+<GettingStartedFrontEndIntegrationMd />
 
 You should now have a working front-end search interface. [Consult `instant-meilisearch`'s documentation for more information on how to further customize your search interface.](https://github.com/meilisearch/instant-meilisearch)

scripts/pull-code-samples.js

@@ -132,11 +132,34 @@ async function processRepos() {
     const filePath = path.join(OUTPUT_DIR, `${operationName}.mdx`);
     const content = `
 <CodeGroup>
-${snippets.map(snippet => `
+${snippets.map(snippet => {
+  // Split content into description and code if it contains a nested code block
+  const parts = snippet.content.split('```');
+  
+  if (parts.length > 1) { // handle samples with nested code blocks
+    // Has description and code blocks
+    const description = parts[0].trim();
+    const codeBlocks = parts.slice(1);
+    
+    // Join all parts back together, keeping the description at the top
+    return `
+\`\`\`text ${snippet.label}
+${description}
+
+${codeBlocks.map(block => {
+  // Remove language identifier and code block markers to ensure Mintlify can parse it
+  const cleanBlock = block.replace(/^[a-z]+\s*/, '').replace(/```$/, '');
+  return cleanBlock;
+}).join('\n')}
+\`\`\``;
+  } else {
+    // Regular standard code block
+    return `
 \`\`\`${snippet.lang} ${snippet.label}
 ${snippet.content}
-\`\`\`
-`).join('\n')}
+\`\`\``;
+  }
+}).join('\n')}
 </CodeGroup>
     `.trim();
 

snippets/add_movies_json_1.mdx

@@ -7,13 +7,11 @@ curl \
   --data-binary @movies.json
 ```
 
-
 ```javascript JS
 const movies = require('./movies.json')
 client.index('movies').addDocuments(movies).then((res) => console.log(res))
 ```
 
-
 ```python Python
 import json
 
@@ -22,15 +20,13 @@ movies = json.load(json_file)
 client.index('movies').add_documents(movies)
 ```
 
-
 ```php PHP
 $moviesJson = file_get_contents('movies.json');
 $movies = json_decode($moviesJson);
 
 $client->index('movies')->addDocuments($movies);
 ```
 
-
 ```java Java
 import com.meilisearch.sdk;
 import org.json.JSONArray;
@@ -44,7 +40,6 @@ Index index = client.index("movies");
 index.addDocuments(moviesJson);
 ```
 
-
 ```ruby Ruby
 require 'json'
 
@@ -53,7 +48,6 @@ movies = JSON.parse(movies_json)
 client.index('movies').add_documents(movies)
 ```
 
-
 ```go Go
 import (
   "encoding/json"
@@ -68,7 +62,6 @@ json.Unmarshal([]byte(file), &movies)
 client.Index("movies").AddDocuments(&movies)
 ```
 
-
 ```csharp C#
 // Make sure to add this using to your code
 using System.IO;
@@ -77,7 +70,6 @@ var jsonDocuments = await File.ReadAllTextAsync("movies.json");
 await client.Index("movies").AddDocumentsJsonAsync(jsonDocuments);
 ```
 
-
 ```rust Rust
 use meilisearch_sdk::{
   indexes::*,
@@ -111,7 +103,6 @@ fn main() { block_on(async move {
 })}
 ```
 
-
 ```swift Swift
 let path = Bundle.main.url(forResource: "movies", withExtension: "json")!
 let documents: Data = try Data(contentsOf: path)
@@ -126,12 +117,10 @@ client.index("movies").addDocuments(documents: documents) { (result) in
 }
 ```
 
-
 ```dart Dart
 // import 'dart:io';
 // import 'dart:convert';
 final json = await File('movies.json').readAsString();
 await client.index('movies').addDocumentsJson(json);
 ```
-
 </CodeGroup>

snippets/add_or_replace_documents_1.mdx

@@ -15,7 +15,6 @@ curl \
   ]'
 ```
 
-
 ```javascript JS
 client.index('movies').addDocuments([{
     id: 287947,
@@ -26,7 +25,6 @@ client.index('movies').addDocuments([{
 }])
 ```
 
-
 ```python Python
 client.index('movies').add_documents([{
   'id': 287947,
@@ -37,7 +35,6 @@ client.index('movies').add_documents([{
 }])
 ```
 
-
 ```php PHP
 $client->index('movies')->addDocuments([
   [
@@ -50,7 +47,6 @@ $client->index('movies')->addDocuments([
 ]);
 ```
 
-
 ```java Java
 client.index("movies").addDocuments("[{"
   + "\"id\": 287947,"
@@ -62,7 +58,6 @@ client.index("movies").addDocuments("[{"
 );
 ```
 
-
 ```ruby Ruby
 client.index('movies').add_documents([
   {
@@ -75,7 +70,6 @@ client.index('movies').add_documents([
 ])
 ```
 
-
 ```go Go
 documents := []map[string]interface{}{
   {
@@ -89,7 +83,6 @@ documents := []map[string]interface{}{
 client.Index("movies").AddDocuments(documents)
 ```
 
-
 ```csharp C#
 var movie = new[]
 {
@@ -105,7 +98,6 @@ var movie = new[]
 await index.AddDocumentsAsync(movie);
 ```
 
-
 ```rust Rust
 let task: TaskInfo = client
   .index("movies")
@@ -122,7 +114,6 @@ let task: TaskInfo = client
   .unwrap();
 ```
 
-
 ```swift Swift
 let documentJsonString = """
 [
@@ -147,7 +138,6 @@ client.index("movies").addDocuments(documents: documents) { (result) in
 }
 ```
 
-
 ```dart Dart
 await client.index('movies').addDocuments([
   {
@@ -161,5 +151,4 @@ await client.index('movies').addDocuments([
   }
 ]);
 ```
-
 </CodeGroup>

snippets/add_or_update_documents_1.mdx

@@ -13,7 +13,6 @@ curl \
   ]'
 ```
 
-
 ```javascript JS
 client.index('movies').updateDocuments([{
     id: 287947,
@@ -22,7 +21,6 @@ client.index('movies').updateDocuments([{
 }])
 ```
 
-
 ```python Python
 client.index('movies').update_documents([{
     'id': 287947,
@@ -31,7 +29,6 @@ client.index('movies').update_documents([{
 }])
 ```
 
-
 ```php PHP
 $client->index('movies')->updateDocuments([
   [
@@ -42,7 +39,6 @@ $client->index('movies')->updateDocuments([
 ]);
 ```
 
-
 ```java Java
 client.index("movies").updateDocuments("[{
   + "\"id\": 287947,"
@@ -52,7 +48,6 @@ client.index("movies").updateDocuments("[{
 );
 ```
 
-
 ```ruby Ruby
 client.index('movies').update_documents([
   {
@@ -63,7 +58,6 @@ client.index('movies').update_documents([
 ])
 ```
 
-
 ```go Go
 documents := []map[string]interface{}{
   {
@@ -75,7 +69,6 @@ documents := []map[string]interface{}{
 client.Index("movies").UpdateDocuments(documents)
 ```
 
-
 ```csharp C#
 var movie = new[]
 {
@@ -84,7 +77,6 @@ var movie = new[]
 await index.UpdateDocumentsAsync(movie);
 ```
 
-
 ```rust Rust
 // Define the type of our documents
 #[derive(Serialize, Deserialize)]
@@ -105,7 +97,6 @@ let task: TaskInfo = client
   .unwrap();
 ```
 
-
 ```swift Swift
 let documentJsonString = """
 [
@@ -128,7 +119,6 @@ client.index("movies").updateDocuments(documents: documents) { (result) in
 }
 ```
 
-
 ```dart Dart
 await client.index('movies').updateDocuments([
   {
@@ -138,5 +128,4 @@ await client.index('movies').updateDocuments([
   }
 ]);
 ```
-
 </CodeGroup>

snippets/analytics_event_bind_event_1.mdx

@@ -14,5 +14,4 @@ curl \
     "position": 0
   }'
 ```
-
 </CodeGroup>

snippets/analytics_event_bind_search_1.mdx

@@ -8,5 +8,4 @@ curl \
   -H 'X-MS-USER-ID: MEILISEARCH_USER_ID' \
   --data-binary '{}'
 ```
-
 </CodeGroup>

snippets/analytics_event_click_1.mdx

@@ -13,5 +13,4 @@ curl \
     "position": 0
   }'
 ```
-
 </CodeGroup>

snippets/analytics_event_conversion_1.mdx

@@ -13,5 +13,4 @@ curl \
     "position": 0
   }'
 ```
-
 </CodeGroup>

snippets/async_guide_canceled_by.mdx

@@ -10,5 +10,4 @@ client.getTasks(params: TasksQuery(canceledBy: [9, 15])) { result in
   }
 }
 ```
-
 </CodeGroup>