마크다운 ZIP 패키지를 즉시 사용 가능한 HTML로 변환하세요
마크다운과 로컬 이미지가 포함된 ZIP 아카이브를 업로드하세요. 시스템이 에셋을 처리하고 참조를 수정하여 미리보기, 배포 및 후속 워크플로우에 바로 사용할 수 있는 HTML을 생성합니다.
문서와 이미지를 한 번에 가져오기
- 모든 이미지를 수동으로 업로드할 필요 없는 ZIP 가져오기
- 이미지는 처리 및 업로드되며, ZIP 파일 자체는 COS에 저장되지 않음
- 디렉토리 경로, 테마 스타일, 저장된 아티클, AI 호환 문서를 하나의 흐름으로 처리
ZIP 우선 수집
상대 경로 이미지 참조가 포함된 Obsidian 및 마크다운 패키지 내보내기에 최적화되어 있습니다.
즉시 사용 가능한 HTML 출력
추가적인 수동 정리 작업 없이 바로 미리보기, 게시 또는 후속 작업에 활용할 수 있는 HTML을 제공합니다.
테마 인식 렌더링
브랜드 콘텐츠, 지식 베이스 게시 및 배치 워크플로우 전반에서 일관된 출력 스타일을 유지합니다.
자동 정리되는 에셋
아티클과 에셋이 깔끔하게 정리되어 검색, 재사용 및 팀 협업이 용이합니다.
일반적인 사용 사례
- 1
Obsidian, 지식 베이스 또는 로컬 편집 파일의 마크다운 아티클을 ZIP 아카이브로 패키징합니다.
- 2
시스템이 이미지 업로드, 참조 교체 및 레이아웃 변환을 자동으로 처리하도록 합니다.
- 3
생성된 결과를 게시, 배포, AI 강화 또는 내부 편집 파이프라인에 활용합니다.
실제 결과물
- 미리보기, 임베딩 또는 후속 게시를 위한 준비가 완료된 HTML 콘텐츠
- 추가 편집을 위해 이미지 참조가 정리된 아티클 자료
- 협업, 아카이빙 및 배치 관리를 위한 더욱 안정적인 에셋 구조
- 다양한 소스의 마크다운 패키지에서 일관된 시각적 출력
API 키 및 AI 호환 문서
아래 섹션은 개발자 콘솔이자 AI 통합을 위한 복사 가능한 핸드오프 문서로 작동합니다.
ZIP 가져오기 API 문서
클릭 한 번으로 API 키를 생성하고, 아래 마크다운 가이드를 복사해 AI 에이전트나 개발팀에 바로 전달하세요.
가져오기 API 키 생성
이 기능에 액세스하려면 로그인하십시오
기존 키
생성된 API 키가 없습니다
테마 API 식별자
각 themeId는 에디터에 표시된 테마 이름과 일치합니다. 사람이 읽을 수 있는 이름과 참조 색상이 아래에 나열되어 있습니다.
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.linkhost, so clients only need one public base URL.
Authentication
Use an API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Async workflow
- Upload the ZIP archive to the upload endpoint and get back
uploadRelativePath - Create an async import job with
POST https://api.imgto.link/api/v1/md/import - 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 1archiveFilename(required): original zip filenamearchiveSize(optional): archive size in bytesthemeId(optional): theme API name, default isclassicdirectoryPath(optional): base upload directory path likepublic/articles/launch-2026entryMarkdown(optional): specific markdown file path inside the ZIP when there are multiple markdown filessaveFolderId(optional): target markdown folder ID in the editormdfileId(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",
"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_COMPENSATIONandFAILED_COMPENSATION_ERROR resultis returned only when the job succeedserroris returned when the job fails
Result field notes
result.resolvedMarkdown: Markdown after local image paths are replaced with Imgto.link URLsresult.html: Base rendered HTML for preview or debuggingresult.wechatApiHtml: Recommended HTML for submitting to the WeChat Official Account APIcontentfieldresult.mdfileId: The saved Markdown article ID, returned for convenient reuse in the next replace import requestresult.savedArticle: Saved Markdown article record in the editorresult.savedArticle.mdfileId: Stable article identifier to pass back on the next import if you want to replace this article instead of creating a new oneresult.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
mdfileIdomitted: create a new import job using the uploaded ZIPmdfileIdprovided: 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
mdfileIdfrom 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.wechatApiHtmlfor WeChat Official Account API publishing - Do not use
result.htmlas thecontentfield if you need output aligned with the website's copy/export flow - Image URLs inside
result.wechatApiHtmlshould already point to uploaded Imgto.link assets - You still need to provide your own WeChat
access_tokenandthumb_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."