Markdown2HTML API

마크다운 ZIP 패키지를 즉시 사용 가능한 HTML로 변환하세요

마크다운과 로컬 이미지가 포함된 ZIP 아카이브를 업로드하세요. 시스템이 에셋을 처리하고 참조를 수정하여 미리보기, 배포 및 후속 워크플로우에 바로 사용할 수 있는 HTML을 생성합니다.

문서와 이미지를 한 번에 가져오기

  • 모든 이미지를 수동으로 업로드할 필요 없는 ZIP 가져오기
  • 이미지는 처리 및 업로드되며, ZIP 파일 자체는 COS에 저장되지 않음
  • 디렉토리 경로, 테마 스타일, 저장된 아티클, AI 호환 문서를 하나의 흐름으로 처리
Base URL: https://api.imgto.link

ZIP 우선 수집

상대 경로 이미지 참조가 포함된 Obsidian 및 마크다운 패키지 내보내기에 최적화되어 있습니다.

즉시 사용 가능한 HTML 출력

추가적인 수동 정리 작업 없이 바로 미리보기, 게시 또는 후속 작업에 활용할 수 있는 HTML을 제공합니다.

테마 인식 렌더링

브랜드 콘텐츠, 지식 베이스 게시 및 배치 워크플로우 전반에서 일관된 출력 스타일을 유지합니다.

자동 정리되는 에셋

아티클과 에셋이 깔끔하게 정리되어 검색, 재사용 및 팀 협업이 용이합니다.

일반적인 사용 사례

  1. 1

    Obsidian, 지식 베이스 또는 로컬 편집 파일의 마크다운 아티클을 ZIP 아카이브로 패키징합니다.

  2. 2

    시스템이 이미지 업로드, 참조 교체 및 레이아웃 변환을 자동으로 처리하도록 합니다.

  3. 3

    생성된 결과를 게시, 배포, AI 강화 또는 내부 편집 파이프라인에 활용합니다.

실제 결과물

  • 미리보기, 임베딩 또는 후속 게시를 위한 준비가 완료된 HTML 콘텐츠
  • 추가 편집을 위해 이미지 참조가 정리된 아티클 자료
  • 협업, 아카이빙 및 배치 관리를 위한 더욱 안정적인 에셋 구조
  • 다양한 소스의 마크다운 패키지에서 일관된 시각적 출력

API 키 및 AI 호환 문서

아래 섹션은 개발자 콘솔이자 AI 통합을 위한 복사 가능한 핸드오프 문서로 작동합니다.

ZIP 가져오기 API 문서

클릭 한 번으로 API 키를 생성하고, 아래 마크다운 가이드를 복사해 AI 에이전트나 개발팀에 바로 전달하세요.

가져오기 API 키 생성

이 기능에 액세스하려면 로그인하십시오

기존 키

생성된 API 키가 없습니다

테마 API 식별자

각 themeId는 에디터에 표시된 테마 이름과 일치합니다. 사람이 읽을 수 있는 이름과 참조 색상이 아래에 나열되어 있습니다.

기본 테마
themeId: warm
시스템 기본
클래식, 따뜻함
#ea580c
#333
중국풍
themeId: china
본명조
고전적, 우아함
#7f1d1d
#292524
#f5f5f4
사이버펑크
themeId: cyber
고정 폭 글꼴
미래, 네온, 테크
#ec4899
#a855f7
#3b82f6
위챗 클래식
themeId: classic
고딕 (Sans)
깔끔함, 안전함, 범용성
#07c160
#333
먹물 세리프
themeId: ink
명조 (Serif)
문화, 역사, 전통
#3f3f46
#78716c
에디토리얼 매거진
themeId: editorial
세리프 + 고딕
패션, 예술, 프리미엄 그레이
#1f2937
#ef4444
치유의 문카이
themeId: wenkai
문카이체
감성, 일상, 손글씨 느낌
#57534e
#78716c
깊이 있는 독서
themeId: business
시스템 고딕
비즈니스, 테크, 정보성
#1e3a8a
#1e40af
숲길
themeId: forest
고딕 (Sans)
자연, 여행, 싱그러움
#059669
#ecfdf5
아주르 코스트
themeId: azure
고딕 (Sans)
테크니컬, 여름, 투명함
#0ea5e9
#e0f2fe
포근한 커피
themeId: coffee
명조 (Serif)
빈티지, 이야기, 따뜻함
#78350f
#fffbeb
사이버 네온
themeId: neon
고정 폭 (Mono)
긱, 미래적, 트렌디
#d946ef
#06b6d4
오리엔탈 레드
themeId: red
명조 (Serif)
국조, 축제, 우아함
#be123c
#fff1f2
실버 테크
themeId: silver
고딕 (Sans)
이성적, 차가움, 전문적
#475569
#e2e8f0
미니멀 블랑
themeId: minimal
고딕 (Sans)
사진, 디자인, 차분함
#000
#999
모란디 핑크
themeId: morandi
명조 (Serif)
뷰티, 여성스러움, 부드러움
#be185d
#fbcfe8
써니 바이브
themeId: sunny
경쾌함
음식, 탐방, 젊음
#f97316
#fbbf24
민트 썸머
themeId: mint
라운드 고딕
시원함, 생활, 힐링
#10b981
#d1fae5
골든 오텀
themeId: autumn
명조 (Serif)
따뜻함, 이야기, 감성
#d97706
#fef3c7
프로방스
themeId: lavender
명조 (Serif)
몽환적, 로맨틱, 미적
#8b5cf6
#ede9fe
빈티지 필름
themeId: vintage
고딕 (Sans)
레트로, 분위기, 리뷰
#7f1d1d
#fecaca
공부 노트
themeId: notes
문카이체
하이라이트, 손글씨, 팁
#facc15
#fef08a
스모키 그레이
themeId: grey
고딕 (Sans)
미니멀, 차가움, 질감
#374151
#f3f4f6

AI 호환 API 통합 가이드

Imgto.link Markdown ZIP Import API

What this API does

  • Upload one ZIP package containing one Markdown file and its local images
  • Queue an asynchronous import job
  • Automatically create the target image directory if it does not exist
  • Automatically save the imported Markdown into the article folder 公众号
  • Upload referenced images to Imgto.link storage
  • Replace local image references in Markdown
  • Return the final resolved Markdown, HTML output, saved article info, and image directory path after the job completes

Base URL

https://api.imgto.link

Endpoints on the same host

  • ZIP upload endpoint: POST https://api.imgto.link/uploads/md-import
  • Create import job: POST https://api.imgto.link/api/v1/md/import
  • Poll job status: GET https://api.imgto.link/api/v1/md/import/jobs/{jobId}
  • In production you can proxy the control-plane routes on the same https://api.imgto.link host, so clients only need one public base URL.

Authentication

Use an API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Async workflow

  1. Upload the ZIP archive to the upload endpoint and get back uploadRelativePath
  2. Create an async import job with POST https://api.imgto.link/api/v1/md/import
  3. Poll GET https://api.imgto.link/api/v1/md/import/jobs/{jobId} until the job reaches a terminal status

Step 1: upload ZIP archive

Endpoint

POST https://api.imgto.link/uploads/md-import

Content-Type

multipart/form-data

Form fields

  • archive (required): ZIP file containing one Markdown file and its local image files

Success response

{
  "code": 200,
  "data": {
    "relativePath": "inbox/2026/03/12/uuid-article-package.zip",
    "originalFilename": "article-package.zip",
    "size": 345678,
    "uploadedAt": "2026-03-12T08:00:00.000Z"
  }
}

Step 2: create import job

Endpoint

POST https://api.imgto.link/api/v1/md/import

Content-Type

application/json

Request body

{
  "uploadRelativePath": "inbox/2026/03/12/uuid-article-package.zip",
  "archiveFilename": "article-package.zip",
  "archiveSize": 345678,
  "themeId": "classic",
  "directoryPath": "public/articles/demo",
  "entryMarkdown": "docs/index.md",
  "saveFolderId": 12,
  "mdfileId": 123
}

Request field notes

  • uploadRelativePath (required): value returned from step 1
  • archiveFilename (required): original zip filename
  • archiveSize (optional): archive size in bytes
  • themeId (optional): theme API name, default is classic
  • directoryPath (optional): base upload directory path like public/articles/launch-2026
  • entryMarkdown (optional): specific markdown file path inside the ZIP when there are multiple markdown files
  • saveFolderId (optional): target markdown folder ID in the editor
  • mdfileId (optional): existing markdown article ID. When provided, the import is treated as a replace/update. The old article and its imported images are deleted before the new content is saved

Success response

{
  "code": 202,
  "message": "Accepted",
  "data": {
    "jobId": "mdi_1234567890abcdef",
    "status": "QUEUED",
    "progress": 0,
    "pollUrl": "/api/v1/md/import/jobs/mdi_1234567890abcdef"
  }
}

Step 3: poll job status

Endpoint

GET https://api.imgto.link/api/v1/md/import/jobs/{jobId}

Non-terminal response example

{
  "code": 200,
  "message": "Ok",
  "data": {
    "jobId": "mdi_1234567890abcdef",
    "status": "PROCESSING",
    "progress": 65,
    "currentStage": "processing_images",
    "message": "正在处理图片 2/4",
    "compensationStatus": "NOT_REQUIRED",
    "updatedAt": "2026-03-12T08:01:15.000Z"
  }
}

Completed response example

{
  "code": 200,
  "message": "Ok",
  "data": {
    "jobId": "mdi_1234567890abcdef",
    "status": "SUCCEEDED",
    "progress": 100,
    "currentStage": "completed",
    "message": "导入完成",
    "compensationStatus": "NOT_REQUIRED",
    "updatedAt": "2026-03-12T08:01:30.000Z",
    "result": {
      "mdfileId": 123,
      "resolvedMarkdown": "# Title\n\n![cover](https://...)",
      "html": "<section>...</section>",
      "wechatApiHtml": "<section>...</section>",
      "imageDirectoryPath": "public/公众号/my-article",
      "savedArticle": {
        "id": 123,
        "mdfileId": 123,
        "title": "My Article",
        "folder": {
          "id": 9,
          "name": "公众号",
          "fullPath": "公众号"
        }
      }
    }
  }
}

Failed response example

{
  "code": 200,
  "message": "Ok",
  "data": {
    "jobId": "mdi_1234567890abcdef",
    "status": "FAILED_COMPENSATED",
    "progress": 100,
    "currentStage": "failed",
    "message": "导入失败,已回滚上传图片与用户额度",
    "compensationStatus": "COMPLETED",
    "updatedAt": "2026-03-12T08:02:00.000Z",
    "error": {
      "message": "Referenced image not found: ./images/cover.png"
    }
  }
}

Job status notes

  • Terminal success status: SUCCEEDED
  • Terminal failure status: FAILED_COMPENSATED
  • Transitional failure statuses can appear briefly during rollback, such as FAILED_PENDING_COMPENSATION and FAILED_COMPENSATION_ERROR
  • result is returned only when the job succeeds
  • error is returned when the job fails

Result field notes

  • result.resolvedMarkdown: Markdown after local image paths are replaced with Imgto.link URLs
  • result.html: Base rendered HTML for preview or debugging
  • result.wechatApiHtml: Recommended HTML for submitting to the WeChat Official Account API content field
  • result.mdfileId: The saved Markdown article ID, returned for convenient reuse in the next replace import request
  • result.savedArticle: Saved Markdown article record in the editor
  • result.savedArticle.mdfileId: Stable article identifier to pass back on the next import if you want to replace this article instead of creating a new one
  • result.imageDirectoryPath: Final image upload directory path

Example cURL: step 1 upload

curl -X POST "https://api.imgto.link/uploads/md-import" \
  -F "archive=@article-package.zip" \

Example cURL: step 2 create job

curl -X POST "https://api.imgto.link/api/v1/md/import" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "uploadRelativePath": "inbox/2026/03/12/uuid-article-package.zip",
    "archiveFilename": "article-package.zip",
    "archiveSize": 345678,
    "themeId": "classic",
    "directoryPath": "public/articles/demo"
  }'

Example cURL: step 3 poll job

curl -X GET "https://api.imgto.link/api/v1/md/import/jobs/mdi_1234567890abcdef" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example JavaScript: end-to-end async import

const uploadFormData = new FormData();
uploadFormData.append("archive", zipFile);

const uploadResponse = await fetch("https://api.imgto.link/uploads/md-import", {
  method: "POST",
  body: uploadFormData
});

const uploadResult = await uploadResponse.json();
const relativePath = uploadResult.data.relativePath;

const createResponse = await fetch("https://api.imgto.link/api/v1/md/import", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    uploadRelativePath: relativePath,
    archiveFilename: uploadResult.data.originalFilename,
    archiveSize: uploadResult.data.size,
    themeId: "classic",
    directoryPath: "public/articles/demo"
  })
});

const createResult = await createResponse.json();
const jobId = createResult.data.jobId;

let finalResult = null;

for (;;) {
  const pollResponse = await fetch("https://api.imgto.link/api/v1/md/import/jobs/" + jobId, {
    method: "GET",
    headers: {
      Authorization: "Bearer YOUR_API_KEY"
    }
  });

  const pollResult = await pollResponse.json();
  const job = pollResult.data;

  if (job.status === "SUCCEEDED") {
    finalResult = job.result;
    break;
  }

  if (job.status === "FAILED_COMPENSATED") {
    throw new Error(job.error?.message || "Import failed");
  }

  await new Promise((resolve) => setTimeout(resolve, 1800));
}

console.log(finalResult.mdfileId);
console.log(finalResult.resolvedMarkdown);
console.log(finalResult.wechatApiHtml);
console.log(finalResult.savedArticle);

Example: replace an existing imported article

Use the result.savedArticle.mdfileId returned by the previous successful import job.

const replaceResponse = await fetch("https://api.imgto.link/api/v1/md/import", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    uploadRelativePath: uploadedZip.data.relativePath,
    archiveFilename: uploadedZip.data.originalFilename,
    archiveSize: uploadedZip.data.size,
    themeId: "classic",
    mdfileId: previousResult.savedArticle.mdfileId
  })
});

const replaceResult = await replaceResponse.json();
console.log(replaceResult.data.jobId);

Replace behavior

  • mdfileId omitted: create a new import job using the uploaded ZIP
  • mdfileId provided: force this import to replace that exact article
  • During replacement, the job deletes the old markdown record first
  • It also deletes images previously imported for that markdown article before uploading the new images
  • Read the latest mdfileId from the final successful poll result and keep using it for future updates

Example: publish to WeChat Official Account draft API

Use result.wechatApiHtml from the completed import job for the content field instead of result.html.

const completedImport = await waitForImportJob(jobId);
const wechatApiHtml = completedImport.result.wechatApiHtml;

const draftPayload = {
  articles: [
    {
      title: completedImport.result.savedArticle?.title || "Imported article",
      author: "Your Team",
      digest: "",
      content: wechatApiHtml,
      content_source_url: "",
      thumb_media_id: "YOUR_WECHAT_THUMB_MEDIA_ID",
      need_open_comment: 0,
      only_fans_can_comment: 0
    }
  ]
};

const wechatResponse = await fetch(
  "https://api.weixin.qq.com/cgi-bin/draft/add?access_token=YOUR_WECHAT_ACCESS_TOKEN",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify(draftPayload)
  }
);

const wechatResult = await wechatResponse.json();
console.log(wechatResult);

WeChat publishing note

  • Prefer result.wechatApiHtml for WeChat Official Account API publishing
  • Do not use result.html as the content field if you need output aligned with the website's copy/export flow
  • Image URLs inside result.wechatApiHtml should already point to uploaded Imgto.link assets
  • You still need to provide your own WeChat access_token and thumb_media_id

Theme API names

  • 기본 테마 (warm): #ea580c, #333
  • 중국풍 (china): #7f1d1d, #292524, #f5f5f4
  • 사이버펑크 (cyber): #ec4899, #a855f7, #3b82f6
  • 위챗 클래식 (classic): #07c160, #333
  • 먹물 세리프 (ink): #3f3f46, #78716c
  • 에디토리얼 매거진 (editorial): #1f2937, #ef4444
  • 치유의 문카이 (wenkai): #57534e, #78716c
  • 깊이 있는 독서 (business): #1e3a8a, #1e40af
  • 숲길 (forest): #059669, #ecfdf5
  • 아주르 코스트 (azure): #0ea5e9, #e0f2fe
  • 포근한 커피 (coffee): #78350f, #fffbeb
  • 사이버 네온 (neon): #d946ef, #06b6d4
  • 오리엔탈 레드 (red): #be123c, #fff1f2
  • 실버 테크 (silver): #475569, #e2e8f0
  • 미니멀 블랑 (minimal): #000, #999
  • 모란디 핑크 (morandi): #be185d, #fbcfe8
  • 써니 바이브 (sunny): #f97316, #fbbf24
  • 민트 썸머 (mint): #10b981, #d1fae5
  • 골든 오텀 (autumn): #d97706, #fef3c7
  • 프로방스 (lavender): #8b5cf6, #ede9fe
  • 빈티지 필름 (vintage): #7f1d1d, #fecaca
  • 공부 노트 (notes): #facc15, #fef08a
  • 스모키 그레이 (grey): #374151, #f3f4f6

ZIP package rules

  • Include exactly one Markdown file, or pass entryMarkdown
  • Reference local images with relative paths such as ./images/a.png
  • Remote image URLs are kept as-is
  • The API converts static images to AVIF by default
  • The imported Markdown is automatically saved to the article folder 公众号
  • The image upload directory becomes {directoryPath}/{article-slug}

AI integration instruction

If you give this API to an AI coding assistant, tell it:

"Use the async workflow. First upload the ZIP to https://api.imgto.link/uploads/md-import with multipart/form-data and read data.relativePath, data.originalFilename, and data.size. Then call POST https://api.imgto.link/api/v1/md/import with JSON using uploadRelativePath, archiveFilename, and optional themeId, directoryPath, entryMarkdown, saveFolderId, and mdfileId. Authenticate the control-plane API with Authorization: Bearer YOUR_API_KEY. Then poll GET https://api.imgto.link/api/v1/md/import/jobs/{jobId} until status becomes SUCCEEDED or FAILED_COMPENSATED. On success, read result.resolvedMarkdown, result.wechatApiHtml, result.savedArticle, result.mdfileId, and result.imageDirectoryPath. Prefer result.wechatApiHtml when publishing to the WeChat Official Account API content field."

원시 마크다운 보기