Interactive Testing

Postman Collection

Test our API instantly with our comprehensive Postman collection. All endpoints, examples, and environment variables included.

Download Collection

API Collection

Complete collection with all API endpoints, examples, and test scripts.

Download Collection

Environment Variables

Pre-configured environment with base URL and variable placeholders.

Download Environment

Setup Instructions

1

Import Collection

  • Open Postman and click "Import" in the top left
  • Select "Upload Files" and choose the downloaded collection file
  • Click "Import" to add the collection to your workspace
2

Import Environment

  • Click "Import" again and upload the environment file
  • Select "Markdown Converter API" from the environment dropdown
  • Set your actual API key in the environment variables
3

Configure API Key

  • Click the gear icon next to "Markdown Converter API" environment
  • Set the api_key variable to your actual API key
  • Save the environment
4

Start Testing

  • Expand the "Markdown Converter API" collection
  • Start with the "Health Check" request to test connectivity
  • Try the "Convert File" examples with sample data

Environment Variables

The environment file includes the following variables. Make sure to set your actual values:

Variable
Description
Example
base_url
API base URL
https://api.markdownconverters.com
api_key
Your API key
your_api_key_here

What's Included

API Endpoints

  • Health Check
  • Single File Conversion
  • URL Conversion
  • Batch Conversion
  • Status Check
  • Download Results

Features

  • Pre-configured authentication
  • Sample request bodies
  • Response validation tests
  • Environment variables
  • Error handling examples
  • Documentation links

Testing Tips

Best Practices

  • • Start with the Health Check endpoint to verify connectivity
  • • Use the provided sample files for initial testing
  • • Check the Tests tab to see response validation
  • • Monitor the Console for detailed request/response logs
  • • Use environments to switch between staging and production

Troubleshooting

  • • Verify your API key is correctly set in environment
  • • Ensure file content is properly Base64 encoded or use form data
  • • Review error messages in the response body
  • • Check rate limits if receiving 429 errors

Next Steps

Authentication Guide

Learn how to create and manage your API keys

Code Examples

See cURL examples for all endpoints