{"uid":"cap_vseMuKhOHvT_sF2b9vRQz","slug":"1gateway-document-to-markdown-converter-81ae57df","name":"1gateway Document to Markdown Converter","description":"Use when an agent must read a document as clean Markdown: web page, PDF, DOCX or Korean HWP/HWPX, tables kept. Input: url (http/https) via GET, or POST a file (multipart 'file', raw body, or JSON contentBase64+filename). Over the per-format size cap → 413 before payment (see /openapi.json). Output: JSON markdown, title, pages, sourceType, bytes, warnings. Price by detected type: HTML $0.0027, PDF/DOCX $0.0045, HWP/HWPX $0.02. Example: ?url=https://example.com/","url":"https://1gateway.dev/v1/convert/markdown?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"url":{"type":"string","pattern":"^https?://","examples":["https://example.com/"],"maxLength":2048,"description":"Public http(s) URL of a web page, PDF, DOCX, HWP or HWPX within the per-format size caps (see 413 in /openapi.json). For uploads use POST instead."},"type":{"enum":["html","text","pdf","docx","hwp","hwpx"],"type":"string","examples":["html"],"description":"Optional expected type; a mismatch is rejected before payment (415, not charged)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["markdown","title","sourceType","priceTier","bytes","chars","warnings"],"properties":{"bytes":{"type":"integer"},"chars":{"type":"integer"},"pages":{"type":"integer"},"title":{"type":"string"},"markdown":{"type":"string"},"sections":{"type":"integer"},"warnings":{"type":"array","items":{}},"priceTier":{"type":"string"},"sourceUrl":{"type":"string"},"sourceType":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0027","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0027/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0027","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0027","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M8bcuxA8fMldWMyXbYC9z","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0027","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a web page, PDF, DOCX, or Korean HWP/HWPX file to clean Markdown by fetching a URL or accepting an uploaded file","exampleAgentPrompt":"Can you read this PDF and give me its full contents as clean markdown? Here's the URL: https://example.com/report.pdf","exampleUseCases":[{"title":"Research report ingestion pipeline","prompt":"Grab the contents of this annual report PDF at https://company.com/annual-report-2024.pdf and convert it to markdown so I can analyze the text — make sure headings and tables are preserved."},{"title":"Korean government document parsing","prompt":"I have a Korean government HWP document at https://gov.kr/policy/2024.hwp — can you convert it to markdown so I can read what it says?"},{"title":"Web article extraction for summarization","prompt":"Pull the article at https://techcrunch.com/2024/05/01/some-article/ and give me the full clean markdown version of the page so I can summarize it."}],"resultDescription":"A JSON object containing: 'markdown' (the full converted document as a Markdown string with headings, paragraphs, and tables), 'title' (document title if detected), 'sourceType' (detected file type, e.g. html/pdf/docx/hwp), 'priceTier' (which pricing tier was applied), 'bytes' (original file size in bytes), 'chars' (character count of extracted markdown), 'pages' (page count for paginated formats), and 'warnings' (array of any issues encountered during conversion).","failureModes":["URL not reachable or returns non-200 status — conversion fails with an error","File exceeds 10 MB limit — rejected before payment","Content type mismatch when 'type' query param is specified — returns 415 not charged","Unsupported file format — returns error indicating unsupported type","Malformed or inaccessible URL — returns parsing error","Password-protected or DRM-locked document — may produce empty or partial markdown","Network timeout fetching the remote URL — returns timeout error"],"whenToPreferThis":"Choose this endpoint when you need to read a document (web page, PDF, DOCX, or Korean HWP/HWPX) as structured, clean Markdown in a single API call — especially when dealing with Korean Hancom HWP/HWPX files which very few services support. Prefer this over generic scraping tools when you need consistent Markdown output with preserved headings and tables, or when you need to process documents behind a URL without managing file downloads yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:35:37.378Z","isFirstParty":false,"canonicalSlug":"1gateway-document-to-markdown-converter-81ae57df"}