O formato HTML é um dos principais formatos para sites, já que a maioria dos navegadores oferece suporte a esse padrão. Considerando que um arquivo Markdown é um arquivo de texto criado usando um dos vários dialetos possíveis da linguagem Markdown. Ele usa formatação de texto simples, mas contém símbolos de texto embutidos que especificam como formatar o texto (por exemplo, \bold\ para texto em negrito ou outras marcações para itálico, recuo, cabeçalhos, etc.). Esteja ciente de que os arquivos Markdown podem usar extensões .MD, .MARKDN e .MDOWN, onde as extensões “.markdown” e “.md” são as mais populares. Portanto, neste artigo, discutiremos os detalhes da conversão de HTML em Markdown usando API REST.
- API de conversão de HTML para Markdown
- Converter HTML em Markdown em Java
- HTML para MD usando comandos cURL
API de conversão de HTML para Markdown
Aspose.HTML Cloud é uma API líder de processamento de arquivos HTML que fornece recursos para manipular arquivos HTML. Ele também suporta o recurso de conversão de HTML para PDF, JPG, TIFF, XPS e outros formatos suportados. Ele também suporta o recurso de conversão de HTML para o formato MD. Agora, para desenvolver o conversor de HTML para markdown usando a linguagem Java, primeiro precisamos adicionar a referência Aspose.HTML Cloud SDK para Java no arquivo pom.xml do tipo de construção maven.
<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>
Após a instalação, crie uma conta de assinatura gratuita em nossos serviços em nuvem por meio do painel Aspose.Cloud usando GitHub ou conta do Google. Ou simplesmente crie uma nova conta e obtenha os detalhes das suas credenciais de cliente.
Converter HTML em Markdown em Java
Siga as instruções especificadas abaixo para converter HTML em Markdown.
- Em primeiro lugar, passe as credenciais do cliente nos métodos Configuration.setAPPSID e Configuration.setAPIKEY.
- Em segundo lugar, defina os detalhes para setBasePath(..), setAuthPath(..) e especifique setUserAgent(…) como WebKit.
- Em terceiro lugar, passe true para o método setDebug(..).
- Após a configuração, crie um objeto da classe ConversionApi.
- Por fim, chame o método PutConvertDocumentToMarkdown(…) para converter HTML em Markdown e salvar a saída no armazenamento em nuvem.
// para mais exemplos, visite https://github.com/aspose-html-cloud/aspose-html-cloud-java
try
{
// Obtenha ClientID e ClientSecret em https://dashboard.aspose.cloud/
String clientId = "bbf94a2c-6d7e-4020-b4d2-b9809741374e";
String clientSecret = "1c9379bb7d701c26cc87e741a29987bb";
// detalhes para invocação da 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);
// Crie um objeto da API Aspose.HTML Cloud
com.aspose.html.api.ConversionApi htmlApi = new ApiClient().createService(ConversionApi.class);
// O documento HTML do armazenamento em nuvem
String name = "list.html";
String folder = null; // The folder in the storage. Should exist.
String storage = "Internal"; // Name of the storage. null
// Preparar execução de chamada
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);
}
HTML para MD usando comandos cURL
Como Aspose.HTML Cloud é baseado na arquitetura REST, pode ser facilmente acessado por meio de comandos cURL. Agora, como pré-requisito, precisamos gerar o token de acesso JWT com base nas credenciais do cliente especificadas em sua conta no painel da nuvem. Agora, execute o seguinte comando para gerar o token 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"
Assim que tivermos o token JWT, execute o seguinte comando de HTML para 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>"
Conclusão
Este artigo forneceu uma excelente fonte para aprender as etapas para desenvolver o conversor HTML para Markdown usando Java Cloud SDK. Observamos que com menos linhas de código conseguimos converter o formato HTML para MD. Você também pode considerar explorar as APIs por meio da UI do Swagger em um navegador da web. Caso você tenha alguma dúvida relacionada ou encontre algum problema, não hesite em nos contatar através do [fórum de suporte técnico] gratuito 12.
Artigos relacionados
É altamente recomendável ler os seguintes artigos para saber mais sobre eles: