palabra para rebajar

Convierta Word a Markdown en C# .NET

En nuestra vida diaria, se utilizan varios formatos de documentos para diferentes propósitos. Markdown (MD) se ha convertido en un formato popular para crear contenido para sitios web, blogs y otras plataformas en línea. Por otro lado, Microsoft Word es una de las herramientas de procesamiento de texto más utilizadas para crear y editar documentos. Sin embargo, cuando se trata de publicar contenido en línea, los documentos de Word (DOC/DOCX) pueden no ser la mejor opción debido a sus complejidades de formato. Aquí es donde la conversión de documentos de Word al formato Markdown resulta útil. En este artículo, discutiremos cómo convertir documentos de Word al formato Markdown (MD) usando C# y REST API.

Markdown es una opción popular para la creación de documentos, especialmente para redacción técnica y científica, ya que permite formatear fácilmente el texto sin tener que usar herramientas de formato complejas.

API de conversión de Word a Markdown

Aspose.Words Cloud es una API REST que permite a los desarrolladores realizar diversas tareas de procesamiento de documentos, como la conversión de Word a Markdown. Con la ayuda de Aspose.Words Cloud SDK for .NET, puede utilizar fácilmente esta API en sus aplicaciones .NET. Ofrece una forma simple y eficiente de convertir documentos de Word al formato Markdown, lo que le permite concentrarse en la lógica principal de su aplicación.

Ahora, para usar el SDK, busque Aspose.Words-Cloud en el administrador de paquetes NuGet y haga clic en el botón Agregar paquete. En segundo lugar, obtenga sus credenciales de cliente de Cloud Dashboard.

En caso de que no tenga una cuenta existente, simplemente cree una cuenta gratuita usando una dirección de correo electrónico válida.

Palabra a MD en C#

Intente usar el siguiente fragmento de código para convertir Word a MD usando C# .NET.

// Obtenga las credenciales del cliente de https://dashboard.aspose.cloud/
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";

// crear un objeto de configuración utilizando ClinetID y los detalles del secreto del cliente
var config = new Configuration { ClientId = clientID, ClientSecret = clientSecret };
// inicializar la instancia de WordsApi
var wordsApi = new WordsApi(config);

// nombre del archivo de entrada
String inputFile = "test_doc.docx";

// nombre del archivo resultante
String resultant = "resultant.md";

// formato de archivo resultante
String format = "MD";
try
{
    // cargar el archivo desde la unidad local
    using (var file = System.IO.File.OpenRead(inputFile))
    {
        var uploadFileRequest = new UploadFileRequest(file, inputFile);
        
        // subir archivo al almacenamiento en la nube
        wordsApi.UploadFile(uploadFileRequest);
   }
    
    // crear objeto de solicitud DocumentWithFormat
    var response = new GetDocumentWithFormatRequest(inputFile, format,outPath: resultant);
    
    // desencadenar la operación del documento
    wordsApi.GetDocumentWithFormat(response);

    // imprimir mensaje de éxito si la conversión es exitosa
    if (response != null && response.Equals("OK"))
    {
        Console.WriteLine("Word to Markdown conversion successfull !");
        Console.ReadKey();
    }
}catch (Exception ex)
{
    Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}
palabra a Markdown

Imagen: - Vista previa de conversión de Word a Markdown.

A continuación se presentan los detalles sobre cada línea de código.

  • En primer lugar, hemos creado una instancia de la clase de configuración al pasar las credenciales de Client ID y Client Secret como argumentos.
  • En segundo lugar, cree un objeto de WordsApi donde pasemos el objeto de configuración como argumento.
  • En tercer lugar, lea el documento de Word de entrada desde el disco local y cárguelo en el almacenamiento en la nube usando el método UploadFile (…).
  • Luego, cree una instancia de GetDocumentWithFormatRequest donde estamos pasando el nombre del archivo de entrada, el formato resultante como MD y el nombre del archivo resultante como argumentos.
  • Finalmente, llame al método GetDocumentWithFormat(..) para realizar la conversión de Word a Markdown. Después de la conversión, el archivo resultante también se guarda en el almacenamiento en la nube.

El documento de Word de muestra utilizado en el ejemplo anterior se puede descargar desde testdoc.docx.

DOC a Markdown usando comandos cURL

Al utilizar los comandos cURL y Aspose.Words Cloud, puede convertir rápida y fácilmente documentos de Word al formato Markdown sin necesidad de escribir ningún código personalizado. Este enfoque permite una integración perfecta con los flujos de trabajo y las herramientas existentes, lo que ahorra tiempo y esfuerzo. Por lo tanto, el uso de comandos cURL y Aspose.Words Cloud para la conversión de Word a Markdown proporciona una solución simple, eficiente y personalizable para sus necesidades de conversión de documentos.

Para comenzar con este enfoque, necesitamos generar el accessToken (basado en las credenciales del cliente). Ejecute el siguiente comando:

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bb959721-5780-4be6-be35-ff5c3a6aa4a2&client_secret=4d84d5f6584160cbd91dba1fe145db14" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Una vez que se haya generado {accessToken}, ejecute el siguiente comando para cargar el documento de Word desde el almacenamiento en la nube y convertirlo al formato Markdown (md). Hemos utilizado el parámetro -o que guarda la salida en una unidad local.

curl -v "https://api.aspose.cloud/v4.0/words/test_doc.docx?format=MD" \
-X GET \
-H  "accept: application/octet-stream" \
-H  "Authorization: Bearer <accessToken>" \
-o "resultant.md"

Conclusión

En conclusión, la capacidad de convertir documentos de Word al formato Markdown puede simplificar enormemente el proceso de creación de contenido para desarrolladores, bloggers y escritores técnicos. Aspose.Words Cloud proporciona una solución simple pero poderosa para lograr esta conversión, con la flexibilidad de usar los comandos .NET SDK o cURL. Con esta herramienta, los usuarios pueden convertir fácilmente sus documentos de Word al formato Markdown, ahorrando tiempo y esfuerzo valiosos en el proceso de creación de contenido.

Enlaces útiles

Artículos relacionados

Visite los siguientes enlaces para obtener más información sobre: