HTML 형식은 대부분의 브라우저가 이 표준을 지원하므로 웹사이트의 기본 형식 중 하나입니다. 반면, Markdown 파일은 Markdown 언어의 여러 가지 방언 중 하나를 사용하여 생성된 텍스트 파일입니다. 일반 텍스트 서식을 사용하지만 텍스트 서식 지정 방법을 지정하는 인라인 텍스트 기호가 포함되어 있습니다(예: 굵은 텍스트의 경우 \bold, 기울임꼴, 들여쓰기, 헤더 등의 기타 마크업). Markdown 파일은 .MD, .MARKDN 및 .MDOWN 확장자를 사용할 수 있으며, 여기서 “.markdown” 및 “.md” 확장자가 가장 많이 사용됩니다. 그래서 이번 글에서는 REST API를 사용하여 HTML을 Markdown으로 변환하는 방법에 대해 자세히 설명하겠습니다.
HTML에서 마크다운으로의 변환 API
Aspose.HTML Cloud는 HTML 파일을 조작하는 기능을 제공하는 선도적인 HTML 파일 처리 API입니다. 또한 HTML을 PDF, JPG, TIFF, XPS 및 기타 지원 형식으로 변환하는 기능도 지원합니다. 또한 HTML을 MD 형식으로 변환하는 기능도 지원합니다. 이제 Java 언어를 사용하여 HTML-마크다운 변환기를 개발하려면 먼저 maven 빌드 유형의 pom.xml 파일에 Aspose.HTML Cloud SDK for Java 참조를 추가해야 합니다.
<repositories>
<repository>
<id>aspose-cloud</id>
<name>artifact.aspose-cloud-releases</name>
<url>https://artifact.aspose.cloud/repo</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-words-cloud</artifactId>
<version>22.8.0</version>
</dependency>
</dependencies>
설치 후 GitHub 또는 Google 계정을 사용하여 Aspose.Cloud 대시보드를 통해 클라우드 서비스에 무료 구독 계정을 만드십시오. 또는 새 계정을 생성하고 클라이언트 자격 증명 세부 정보를 얻으세요.
Java에서 HTML을 마크다운으로 변환
HTML을 Markdown으로 변환하려면 아래 지정된 지침을 따르십시오.
- 먼저, Configuration.setAPPSID 및 Configuration.setAPIKEY 메소드에 대해 클라이언트 자격 증명을 전달합니다.
- 둘째, setBasePath(..), setAuthPath(..)에 대한 세부 정보를 설정하고 setUserAgent(…)를 WebKit으로 지정합니다.
- 셋째, setDebug(..) 메소드에 true를 전달합니다.
- 구성 후 ConversionApi 클래스의 객체를 생성해주세요.
- 마지막으로 PutConvertDocumentToMarkdown(…) 메서드를 호출하여 HTML을 Markdown으로 변환하고 출력을 클라우드 저장소에 저장합니다.
// 더 많은 예를 보려면 https://github.com/aspose-html-cloud/aspose-html-cloud-java를 방문하세요.
try
{
// https://dashboard.aspose.cloud/에서 ClientID 및 ClientSecret 가져오기
String clientId = "bbf94a2c-6d7e-4020-b4d2-b9809741374e";
String clientSecret = "1c9379bb7d701c26cc87e741a29987bb";
// API 호출 세부정보
com.aspose.html.Configuration.setAPP_SID(clientId);
com.aspose.html.Configuration.setAPI_KEY(clientSecret);
com.aspose.html.Configuration.setBasePath("https://api.aspose.cloud/v3.0");
com.aspose.html.Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
com.aspose.html.Configuration.setUserAgent("WebKit");
com.aspose.html.Configuration.setDebug(true);
// Aspose.HTML Cloud API의 객체 생성
com.aspose.html.api.ConversionApi htmlApi = new ApiClient().createService(ConversionApi.class);
// 클라우드 스토리지의 HTML 문서
String name = "list.html";
String folder = null; // The folder in the storage. Should exist.
String storage = "Internal"; // Name of the storage. null
// 통화 준비 실행
retrofit2.Call<okhttp3.ResponseBody> call = htmlApi.PutConvertDocumentToMarkdown(name, "Converted.md", true, folder, storage);
System.out.println("HTML to Markdown conversion sucessfull !");
}catch(Exception ex)
{
System.out.println(ex);
}
cURL 명령을 사용하여 HTML에서 MD로
Aspose.HTML Cloud는 REST 아키텍처를 기반으로 하기 때문에 cURL 명령을 통해 쉽게 액세스할 수 있습니다. 이제 전제 조건으로 클라우드 대시보드의 계정에 대해 지정된 클라이언트 자격 증명을 기반으로 JWT 액세스 토큰을 생성해야 합니다. 이제 다음 명령을 실행하여 JWT 토큰을 생성하십시오.
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bbf94a2c-6d7e-4020-b4d2-b9809741374e&client_secret=1c9379bb7d701c26cc87e741a29987bb" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
JWT 토큰이 있으면 HTML에서 MD로 다음 명령을 실행하십시오.
curl -v -X PUT "https://api.aspose.cloud/html/list.html/convert/md?outPath=Converted.md&useGit=false" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
결론
이 문서에서는 Java Cloud SDK를 사용하여 HTML-Markdown 변환기를 개발하는 단계를 학습할 수 있는 훌륭한 소스를 제공했습니다. 우리는 더 적은 수의 코드 라인으로 HTML을 MD 형식으로 변환할 수 있다는 것을 확인했습니다. 웹 브라우저 내에서 Swagger UI를 통해 API를 탐색하는 것을 고려할 수도 있습니다. 관련 질문이 있거나 문제가 발생하는 경우 무료 기술 지원 포럼을 통해 언제든지 문의해 주세요.
관련 기사
이에 대해 자세히 알아보려면 다음 문서를 살펴보는 것이 좋습니다.