Refine delete API documentation for Markdown indexing

Author: mdonovanmsft

articles/search/search-how-to-index-markdown-blobs.md

@@ -466,16 +466,17 @@ This method uses a soft-delete to delete documents associated with a specific bl
 
 #### Option 2. Use the delete API
 
-Before re-indexing a modified Markdown file, explicitly delete the existing documents associated with that file using the [https://learn.microsoft.com/en-us/rest/api/searchservice/delete-documents](https://learn.microsoft.com/en-us/rest/api/searchservice/preview-api/add-update-delete-documents). You can either:
+Before re-indexing a modified Markdown file, explicitly delete the existing documents associated with that file using the [delete API](https://learn.microsoft.com/rest/api/searchservice/preview-api/add-update-delete-documents). You can either:
 
 * Manually indentify individual stale documents by identifying duplicates in the index to be deleted. This may be feasible for small, well-understood changes but can be time-consuming.
 * (**Recommended**) Remove all documents generated from the same parent file before re-indexing. This ensures a clean slate and avoids inconsistencies.
 
   1. Identify the id  of the documents associated with the file. Use a query like the one below to retrieve the document key IDs (e.g., `id`, `chunk_id`, etc.) for all documents tied to a specific file. Replace `metadata_storage_path` with the appropriate field in your index that maps to the file path or blob URI. Note that this field must be a key.
-  ```
-  GET https://<search-service>.search.windows.net/indexes/<index-name>/docs?api-version=2025-05-01-preview
-  Content-Type: application/json
-  api-key: [admin key]
+```http
+GET https://[service name].search.windows.net/indexes/[index name]/docs?api-version=2025-05-01-preview
+Content-Type: application/json
+api-key: [admin key]
+
 
   {  
       "filter": "metadata_storage_path eq 'https://<storage-account>.blob.core.windows.net/<container-name>/<file-name>.md'",
@@ -484,10 +485,10 @@ Before re-indexing a modified Markdown file, explicitly delete the existing docu
 ```
 
   2. Issue a delete request for the documents with the identified keys.
-  ```
-  GET https://<search-service>.search.windows.net/indexes/<index-name>/docs?api-version=2025-05-01-preview
-  Content-Type: application/json
-  api-key: [admin key]
+```http
+POST https://[service name].search.windows.net/indexes/[index name]/docs/index?api-version=2025-05-01-preview
+Content-Type: application/json
+api-key: [admin key]
 
 {  
   "value": [