Konwertuj Word na Markdown w Javie
Microsoft Word jest powszechnie używany do tworzenia, edytowania i przekształcania dokumentów Word (DOC/DOCX) do różnych formatów. Podobnie Markdown to lekki język znaczników, którego można używać do dodawania elementów formatujących do dokumentów tekstowych. Jest to zwykły dokument tekstowy, który powinien być czytelny bez tagów, które wszystko mieszają, ale nadal powinny istnieć sposoby dodawania modyfikatorów tekstu, takich jak listy, pogrubienie, kursywa itp. Więc jeśli mamy dokument Word i musimy utworzyć równoważny plik w składni Markdown trudno jest go ręcznie utworzyć. Jednak rozwiązanie programowe może rozwiązać problem. W tym artykule wyjaśnimy wszystkie szczegóły dotyczące tworzenia konwertera słów na markdown za pomocą pakietu Java Cloud SDK.
Interfejs API konwersji Worda do Markdown
Nasz oparty na REST interfejs API o nazwie Aspose.Words Cloud to niesamowite rozwiązanie do implementacji operacji tworzenia dokumentów MS Word, manipulacji i konwersji do różnych obsługiwanych formatów. Teraz, aby zaimplementować te same możliwości konwersji i przetwarzania dokumentów w aplikacji Java, musimy użyć Aspose.Words Cloud SDK for Java, który jest opakowaniem wokół REST API. Tak więc w pierwszym kroku wykorzystania SDK musimy dodać jego referencję do naszego projektu Java, umieszczając następujące informacje w pom.xml (projekt typu kompilacji 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.12.0</version>
</dependency>
</dependencies>
Po dodaniu referencji SDK do projektu kolejnym ważnym krokiem jest uzyskanie poświadczeń klienta z Cloud Dashboard. W przeciwnym razie musisz najpierw zarejestrować bezpłatne konto, używając ważnego adresu e-mail.
Word do MD w Javie
W tej sekcji wyjaśniono kroki i powiązane szczegóły, w jaki sposób możemy przekonwertować program Word na format MD za pomocą fragmentu kodu Java. Użyjemy dwóch opcji ładowania wejściowego dokumentu Word, tj. z magazynu w chmurze lub dysku lokalnego, a następnie przekształcimy go do formatu Markdown.
Załaduj dokument programu Word z dysku lokalnego
- Przede wszystkim utwórz instancję WordsApi i przekaż spersonalizowane poświadczenia jako argumenty
- Po drugie, przeczytaj zawartość wejściowego dokumentu Worda za pomocą metody Files.readAllBytes(…) i uzyskaj zwróconą wartość w tablicy byte[]
- Po trzecie, utwórz obiekt ConvertDocumentRequest, który pobiera wejściowy plik Word, format MD i wynikową nazwę pliku Markdown jako argumenty
- Teraz wywołaj metodę convertDocument(…) dla konwersji Worda na MD. Wynikowy Markdown jest zwracany jako strumień odpowiedzi, który ma zostać zapisany w instancji byte[].
- Na koniec, aby zapisać wynikowy Markdown na dysku lokalnym, utwórz obiekt FileOutputStream i użyj jego metody write(…)
// Aby uzyskać więcej fragmentów kodu, proszę https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// jeśli baseUrl ma wartość null, WordsApi używa domyślnego https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
// załaduj dokument Word z systemu lokalnego
File file1 = new File("sample_EmbeddedOLE.docx");
// przeczytaj treść dokumentu ze słowem wejściowym
byte[] documentStream = Files.readAllBytes(file1.toPath());
// wynikowy format pliku
String format = "md";
// utwórz żądanie konwersji dokumentu, w którym podajemy wynikową nazwę pliku
ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(documentStream,format, null,null, null, null);
// wykonaj konwersję słowa na markdown i zapisz dane wyjściowe w tablicy bajtów
byte[] resultantFile = wordsApi.convertDocument(convertRequest);
// Zapisz wynikową dokumentację przeceny na dysku lokalnym
FileOutputStream fos = new FileOutputStream("/Users/nayyer/Documents/" + "resultant.md");
fos.write(resultantFile);
fos.close();
}catch(Exception ex)
{
System.out.println(ex);
}
Obraz: — Podgląd konwersji Worda do Markdown
Możesz rozważyć pobranie wejściowego dokumentu Word z sampleEmbeddedOLE.docx.
Załaduj dokument Word z Cloud Storage
- Podobnie, najpierw musimy utworzyć instancję WordsApi, przekazując spersonalizowane poświadczenia jako argumenty
- Po drugie, utwórz obiekt GetDocumentWithFormatRequest, który przyjmuje nazwę pliku wejściowego Word, format MD i wynikową nazwę pliku Markdown jako argumenty
- Na koniec wywołaj metodę getDocumentWithFormat(..), która wyzwala operację konwersji Worda na Markdown. Wynikowy plik MD jest zapisywany w chmurze
// Aby uzyskać więcej fragmentów kodu, proszę https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// jeśli baseUrl ma wartość null, WordsApi używa domyślnego https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
String format = "md";
// teraz utwórz nowy obiekt GetDocumentWithFormatRequest
GetDocumentWithFormatRequest convertRequest = new GetDocumentWithFormatRequest("sample_EmbeddedOLE.docx",format,null, null, null,null,null,"Converted.md",null);
// teraz wywołaj metodę, aby zainicjować operację konwersji
// wynikowy plik jest przechowywany w chmurze
wordsApi.getDocumentWithFormat(convertRequest);
}catch(Exception ex)
{
System.out.println(ex);
}
DOC do Markdown za pomocą poleceń cURL
Interfejsy API REST zapewniają również elastyczność dostępu z dowolnej platformy za pomocą poleceń cURL. Dlatego w tej sekcji omówimy szczegóły ładowania dokumentu Word z magazynu w chmurze, przeprowadzania konwersji DOCX na Markdown i zapisywania wynikowego pliku MD na dysku lokalnym. Teraz najpierw musimy wygenerować token dostępu JWT (na podstawie poświadczeń klienta) za pomocą następującego polecenia, a następnie przeprowadzić konwersję DOCX na Markdown.
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"
Po wygenerowaniu JWT wykonaj następujące polecenie, aby załadować dokument Word z magazynu w chmurze i przeprowadzić konwersję Word do Markdown. Wynikowy plik MD jest następnie zapisywany na dysku lokalnym
curl -v -X GET "https://api.aspose.cloud/v4.0/words/sample_EmbeddedOLE.docx?format=md" \
-H "accept: application/octet-stream" \
-H "Authorization: Bearer <JWT Token>" \
-o "newOutput.md"
Wniosek
Dotarliśmy do końca tego artykułu, gdzie poznaliśmy szczegóły, w jaki sposób możemy programowo przekonwertować Word na Markdown za pomocą Javy. Podobnie zbadaliśmy również kroki konwersji DOCX na Markdown za pomocą poleceń cURL.
Inną opcją eksploracji możliwości API jest użycie SwaggerUI w przeglądarce internetowej. Zalecamy również zapoznanie się z Dokumentacją produktu, która jest niesamowitym źródłem informacji o innych ekscytujących funkcjach. W przypadku konieczności pobrania i zmodyfikowania kodu źródłowego Cloud SDK jest on dostępny na GitHub (opublikowany na licencji MIT). Wreszcie, jeśli napotkasz jakiekolwiek problemy podczas korzystania z interfejsu API, możesz rozważyć skontaktowanie się z nami w celu uzyskania szybkiego rozwiązania za pośrednictwem bezpłatnego forum wsparcia produktu.
Powiązane artykuły
Odwiedź poniższe linki, aby dowiedzieć się więcej o: