අවසන් වසරේදී, ව්යාපෘති හතරක් තුළම එකම ගැටළුවක් මතු වුණා – Markdown ලේඛනවලින් JSON නිර්මාණය කිරීම. එකක් ද්රව්ය වෙබ් අඩවියක්, තවත් එකක් RAG (Retrieval‑Augmented Generation) සක්රිය කිරීම, තවත් එකක් n8n වර්ක්ෆ්ලෝ, සහ අන් එකක් පරිශීලකයන්ගේ Markdown අන්තර්ගතය තහවුරු කිරීම. එම සෑම අවස්ථාවකම වෙන්වූ පුස්තකාලයක් හෝ regex ක්රමයක් භාවිතා කළා, නමුත් ඒවා එකම වරදකින් වැරදි – ගැඹුරු GFM tasklist, YAML frontmatter, වගු ශීර්ෂක ඉඩ, කේත බ්ලොක් තුළ Markdown වැනි අසමත්තා.
එකම විසඳුමක් හදුන්වා දුන්නා – POST /v1/parse යන endpoint එකක්, Markdown (text/markdown) හෝ JSON (application/json) payload එකක් ගෙන, ස්ථාවර JSON ආකෘතියක් ලබා දෙනවා. ප්රතිඵලයේ title, frontmatter, headings, sections, lists, tasklists, tables, codeBlocks, links, paragraphs සහ අවශ්ය නම් ast (mdast) ඇතුළත් වේ. sections ගොඩනැගීම heading depth අනුව hierarchical වශයෙන් සිදු වන නිසා, RAG සඳහා chunk boundary එකක් ලෙස සෘජු භාවිතා කළ හැක.
මෙම API එක කොඩ් ලයිබ්රරියක් නොව සෑම තාක්ෂණමය පරිසරයකටම එකම parser එකක් ලබා දෙනවා – Python, Node, n8n, Browser Extension යන සියල්ලටම එක URL එකම භාවිතා කළ හැක. Cloudflare Workers මත Stateless ලෙස ක්රියා කරන නිසා, දත්ත ගබඩා, auth server, proxy වැනි පරිපාලන වැය නැත; traffic නැතිවූ විටද $0 බිල්පතක්. අසමත් frontmatter එකක් ඇතුළත් වූ විට 422 error code එකක් ලබා දී, caller එකට retry/skip/Fail තීරණය ගැනීමට හැකියාව ලැබේ.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලංකාවේ තාක්ෂණික ශිෂ්යයන්, ඩිවලපර්, ව්යවසාය සඳහා මේ API එක ගෙන ආ විශාල ප්රතිලාභ කිහිපයක් ඇත:
- කාල සම්පාදනය – එක් ලයිබ්රරියක් පවත්වාගෙන යාමට වඩා, එක endpoint එකක් භාවිතා කිරීමෙන් කේතය නැවත නැවත ලියන අවශ්යතාව අඩු වේ.
- දෝෂ පාලනය – සමාන්ය edge‑case ගැටළු (nested tasklist, quoted booleans) එකම ස්ථානයේ සවිස්තරාත්මකව නිවැරදි කර ඇත, එමඟින් නිෂ්පාදන ගුණාත්මකත්වය වැඩි වේ.
- ආර්ථික පිරිවැය – Cloudflare Workers හි serverless ආකෘතිය නිසා, අඩු traffic වලට පවා පිරිවැය නොමැතිව සේවාව භාවිතා කළ හැක.
- ඉගෙනුම් හැකියාව – AI‑RAG, static site generators, automation workflows වැනි නව තාක්ෂණයන්ට Markdown‑to‑JSON පරිවර්තනය අවශ්ය වන විට, සිංහල දේශීය ඩිවලපර්ලාට ඉක්මනින් ඒකීකරණය කළ හැක.
අපගේ දේශීය startups සහ SMEs ගණනාවක් වෙබ් අඩවි, knowledge base, internal documentation වැනි අන්තර්ගත කළමනාකරණය සඳහා මේ සේවාව භාවිතා කරමින්, කාර්ය සාධනය වැඩි කරගෙන යනවා.
අවසන් වශයෙන්, Markdown‑to‑JSON එකක් සෑම පයිප්ලයිනයකටම වෙනම ලයිබ්රරියක් තබා ගැනීමට අවශ්ය නැත. එක API එකෙන් සම්පූර්ණ, ස්ථාවර, සහ සුරක්ෂිත JSON ප්රතිඵලයක් ලබා ගනිමින්, ඔබේ වැඩපිළිවෙළ තවත් කාර්යක්ෂම කරගන්න.
