HTML 格式是网站的主要格式之一,因为大多数浏览器都支持此标准。而 Markdown 文件是使用 Markdown 语言的几种可能方言之一创建的文本文件。它使用纯文本格式,但包含指定如何设置文本格式的内联文本符号(例如,\bold\ 表示粗体文本,或其他用于斜体、缩进、标题等的标记)。请注意,Markdown 文件可能使用 .MD、.MARKDN 和 .MDOWN 扩展名,其中“.markdown”和“.md”扩展名是最流行的。因此,在本文中,我们将讨论使用 REST API 将 HTML 转换为 Markdown 的详细信息。
HTML 到 Markdown 转换 API
Aspose.HTML Cloud 是领先的 HTML 文件处理 API,提供操作 HTML 文件的功能。它还支持将 HTML 转换为 PDF、JPG、TIFF、XPS 和其他支持的格式 的功能。它还支持将 HTML 转换为 MD 格式的功能。现在为了使用Java语言开发HTML到Markdown转换器,我们首先需要在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 转换为 Markdown
请按照下面指定的说明将 HTML 转换为 Markdown。
- 首先,根据 Configuration.setAPPSID 和 Configuration.setAPIKEY 方法传递客户端凭据。
- 其次,设置 setBasePath(..)、setAuthPath(..) 的详细信息,并将 setUserAgent(…) 指定为 WebKit。
- 第三,将 true 传递给 setDebug(..) 方法。
- 配置完成后,请创建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 格式。您还可以考虑在 Web 浏览器中通过 Swagger UI 探索 API。如果您有任何相关疑问,或者遇到任何问题,请随时通过免费的技术支持论坛与我们联系。
相关文章
我们强烈建议您阅读以下文章以了解有关它们的更多信息: