At a glance:
Use the /v2/markdown-converter/ endpoint to generate markdown from (URLs, files). Simply provide a link, and type.
Markdown generation is a core operation that enables you to transform various file formats into clean, structured markdown, ready to be organized and queried in a collection. By default, the Wetrocloud API supports markdown generation from these resource types:
ResourceParameterDescription
FilefileSupports various file types including .csv, .docx, .epub, .hwp, .ipynb, .jpeg, .jpg, .mbox, .md, .mp3, .mp4, .pdf, .png, .ppt, .pptm, .pptx.
WebwebWeb-based resources, such as websites.
ImageimageSupports various images file types including .jpg, .jpeg, .png, .gif, .bmp, .tiff, .tif, .webp, .heif, .heic, .ico, .svg, .raw, .psd, .ai, .eps, .indd, .jfif, .apng, .avif, .exr, .dds, .aii, .emf, .wdp
To use the file type, all files must be provided as URLs. You can consider services like Amazon S3, Cloudinary, or similar platforms to host your files and provide their URLs to the API.
Specify a file format & the file itself and we’ll return its equivalent markdown structure, no extra setup required.

​
How to Generate Markdown

To insert generate markdown, make a POST request to the /v2/markdown-converter/ endpoint with the required parameters in the body.

​
Required Parameters

ParameterTypeDescription
linkStringA URL for your resource.
resource_typeStringThe type of resource to insert (e.g., web, file, image).

​
Request Example

from wetro import Wetrocloud
    
# Initialize the Wetrocloud client
client = Wetrocloud(api_key="your_api_key")
    
# Generate Markdown
markdown_response = client.markdown_converter(
  link = "https://res.cloudinary.com/dxcb59rb3/image/upload/v1746640907/Payverse_Demo_wfhxr9.pdf",
  resource_type = "file"
)

print(markdown_response)

​
Successful Response

A successful response confirms the operation and tracks token usage. Example Response 
 {
      response: '1. How do I convert BTC to Naira using Payv3rse?\n' +
        '\n' +
        'To convert BTC to Naira:\n' +
        '\n' +
        '1.  Log in to your Payv3rse account.\n' +
        '2.  Tap on the "Convert" button.\n' +
        '3.  Select BTC as your crypto and enter the amount you want to convert.\n' +
        '4.  Choose your Naira bank account for payout.\n' +
        '5.  Confirm the transaction.\n' +
        '\n' +
        'Your funds will be deposited within 2 minutes.\n' +
        '\n' +
        '2. What cryptocurrencies can I convert?\n' +
        '\n' +
        'Currently, Payv3rse supports:\n' +
        '\n' +
        '●  Bitcoin (BTC)\n' +
        '●  Ethereum (ETH)\n' +
        '●  USDT (TRC20 & ERC20)\n' +
        '●  BNB (BEP20)\n' +
        '\n' +
        'More tokens will be added soon.\n' +
        '\n' +
        '3. How long does it take to receive funds in my bank account?\n' +
        '\n' +
        'Once your crypto transaction is confirmed, Payv3rse will process your payout in under 2\n' +
        'minutes.\n' +
        '\n' +
        "4. Why hasn't my bank withdrawal arrived yet?\n" +
        '\n' +
        'Most bank transfers complete instantly.\n' +
        'If it’s been more than 5 minutes, please:\n' +
        '\n' +
        '●  Confirm your crypto was sent and confirmed on the blockchain.\n' +
        '●  Check that your bank account details are correct.\n' +
        '●  Contact support if needed — we’re here to help.\n' +
        '\n' +
        '5. What are the fees for converting crypto to Naira?\n' +
        '\n' +
        '\fPayv3rse charges a flat 1.5% transaction fee, which is automatically deducted from your\n' +
        'total before payout.\n' +
        '\n' +
        'There are no hidden fees.\n' +
        '\n' +
        '6. Is Payv3rse safe?\n' +
        '\n' +
        'Yes. We use:\n' +
        '\n' +
        '●  End-to-end encryption\n' +
        '●  Two-factor authentication (2FA)\n' +
        '●  Cold wallet storage for large funds\n' +
        '\n' +
        'Your security is our top priority.\n' +
        '\n' +
        '7. Can freelancers use Payv3rse to get paid?\n' +
        '\n' +
        'Absolutely. Freelancers can:\n' +
        '\n' +
        '●  Receive crypto payments from clients worldwide.\n' +
        '●\n' +
        '●  Withdraw to their local bank account.\n' +
        '\n' +
        'Instantly convert to Naira.\n' +
        '\n' +
        'No registration as a business required.\n' +
        '\n' +
        '8. How do I use the OTC desk for large transactions?\n' +
        '\n' +
        'To use our OTC service:\n' +
        '\n' +
        '1.  Go to the OTC Desk section in the app.\n' +
        '2.  Choose the crypto and volume you want to off-ramp.\n' +
        '3.  Submit a request — our team will confirm exchange rates and complete your transfer\n' +
        '\n' +
        'at the best available price.\n' +
        '\n',
      tokens: 1884,
      success: true
    }
FieldDescription
successIndicates whether the resource was inserted successfully.
tokensNumber of tokens consumed during the operation.
responseResult for the markdown generation