Le format HTML est l’un des principaux formats de sites Web car la majorité des navigateurs prennent en charge cette norme. Alors qu’un fichier Markdown est un fichier texte créé en utilisant l’un des nombreux dialectes possibles du langage Markdown. Il utilise un formatage de texte brut mais contient des symboles de texte en ligne qui spécifient comment formater le texte (par exemple, \bold\ pour le texte en gras, ou d’autres balises pour l’italique, l’indentation, les en-têtes, etc.). Veuillez noter que les fichiers Markdown peuvent utiliser les extensions .MD, .MARKDN et .MDOWN, où les extensions « .markdown » et « .md » sont les plus populaires. Ainsi, dans cet article, nous allons discuter des détails de la conversion de HTML en Markdown à l’aide de l’API REST.
- API de conversion HTML vers Markdown
- Convertir HTML en Markdown en Java
- HTML vers MD à l’aide des commandes cURL
API de conversion HTML vers Markdown
Aspose.HTML Cloud est une API leader de traitement de fichiers HTML offrant les capacités de manipuler des fichiers HTML. Il prend également en charge la fonctionnalité permettant de convertir le HTML en PDF, JPG, TIFF, XPS et d’autres formats pris en charge. Il prend également en charge la fonctionnalité permettant de convertir le HTML au format MD. Désormais, afin de développer un convertisseur HTML vers markdown à l’aide du langage Java, nous devons d’abord ajouter la référence Aspose.HTML Cloud SDK pour Java dans le fichier pom.xml de type de construction 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>
Après l’installation, veuillez créer un compte d’abonnement gratuit sur nos services cloud via le tableau de bord Aspose.Cloud en utilisant GitHub ou un compte Google. Ou, simplement créer un nouveau compte et obtenir les détails de vos informations d’identification client.
Convertir HTML en Markdown en Java
Veuillez suivre les instructions spécifiées ci-dessous pour convertir du HTML en Markdown.
- Tout d’abord, transmettez les informations d’identification du client aux méthodes Configuration.setAPPSID et Configuration.setAPIKEY.
- Deuxièmement, définissez les détails de setBasePath(..), setAuthPath(..) et spécifiez setUserAgent(…) comme WebKit.
- Troisièmement, transmettez true à la méthode setDebug(..).
- Après la configuration, veuillez créer un objet de la classe ConversionApi.
- Enfin, appelez la méthode PutConvertDocumentToMarkdown(…) pour convertir le HTML en Markdown et enregistrer la sortie dans le stockage cloud.
// pour plus d'exemples, veuillez visiter https://github.com/aspose-html-cloud/aspose-html-cloud-java
try
{
// Obtenez ClientID et ClientSecret depuis https://dashboard.aspose.cloud/
String clientId = "bbf94a2c-6d7e-4020-b4d2-b9809741374e";
String clientSecret = "1c9379bb7d701c26cc87e741a29987bb";
// détails pour l'invocation de l'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);
// Créer un objet de l'API Cloud Aspose.HTML
com.aspose.html.api.ConversionApi htmlApi = new ApiClient().createService(ConversionApi.class);
// Le document HTML du stockage cloud
String name = "list.html";
String folder = null; // The folder in the storage. Should exist.
String storage = "Internal"; // Name of the storage. null
// Préparer l'exécution de l'appel
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 vers MD à l’aide des commandes cURL
Comme Aspose.HTML Cloud est basé sur l’architecture REST, il est donc facilement accessible via les commandes cURL. Désormais, comme condition préalable, nous devons générer un jeton d’accès JWT basé sur les informations d’identification client spécifiées pour votre compte sur le tableau de bord cloud. Maintenant, veuillez exécuter la commande suivante pour générer le jeton 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"
Une fois que nous avons le jeton JWT, veuillez exécuter la commande suivante en HTML vers 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>"
Conclusion
Cet article a fourni une excellente source pour apprendre les étapes de développement d’un convertisseur HTML vers Markdown à l’aide du SDK Java Cloud. Nous avons observé qu’avec moins de lignes de code, nous parvenions à convertir du HTML au format MD. Vous pouvez également envisager d’explorer les API via Swagger UI dans un navigateur Web. Si vous avez des questions connexes ou si vous rencontrez des problèmes, n’hésitez pas à nous contacter via le [forum d’assistance technique] gratuit]12.
Articles Liés
Nous vous recommandons fortement de parcourir les articles suivants pour en savoir plus à leur sujet :