1. Продукти
  2.   Обработване на текст
  3.   Ruby
  4.   Word to Markdown
 
  

Безплатна Ruby библиотека за конвертиране на Microsoft Word в Markdown

Отворен код Ruby Gem, който позволява на софтуерните разработчици да четат и конвертират Microsoft Word документи (DOCX или DOC) в чист, човешки четим Markdown файл.

Какво е Word to Markdown?

Когато създавате съдържание и изграждате уебсайтове, как структурирате текста си е от съществено значение. Въпреки че Microsoft Word се използва широко за създаване на документи, Markdown се е превърнал в предпочитания формат за уеб писане. Неговото просто форматиране, съвместимостта с контрол на версии и способността да работи на различни платформи го правят топ избор за писатели, разработчици и издатели. Но какво правите, когато имате множество Word документи, които искате да включите в блога си, в ръководствата си или на сайта си? Ръчният процес на тяхното конвертиране може да бъде досаден и пълен с грешки. Тук на помощ идва библиотеката Word-to-Markdown, отворен код gem от Бен Балтър.

Word to Markdown е мощен инструмент, който автоматизира конвертирането на .docx файлове в чист, четим Markdown, спестявайки ви безброй часове ръчно форматиране. В основата си това е Ruby gem, който интелигентно конвертира Microsoft Word документи в Markdown. Той не е просто прост екстрактор на текст; това е изискан инструмент, който разбира подлежащата структура на Word документ и я превежда в съответния Markdown синтаксис. Това означава, че заглавия, списъци, удебелен и курсивен текст, както и по-сложни елементи като изображения и таблици се запазват по време на процеса на конвертиране. Основните функции включват:

  • CLI инструмент за пакетно или единично конвертиране на файлове
  • Клиентска версия, базирана на браузър
  • Минимални зависимости и бързо време за изпълнение
  • Проектиран за създаване на четим Markdown с заглавия, списъци, линкове, изображения, дори бележки под линия
Previous Next

Започване с Word to Markdown

Препоръчителният начин за инсталиране на Word to Markdown е чрез RubyGems. Моля, използвайте следната команда за безпроблемна инсталация.

Инсталиране на Word to Markdown чрез RubyGems

gem install word-to-markdown
You can also download it directly from GitHub.

Конвертиране на Word Docx в Markdown чрез Ruby

Библиотеката Word-to-Markdown се гордее с впечатляващ списък от поддържани конвертации, което я прави гъвкав инструмент за широк спектър от случаи на употреба. Gem‑ът парсира .docx файлове (формат Office Open XML) и по-стари .doc файлове, като извлича текст, заглавия, списъци, линкове, таблици, изображения и други. Библиотеката безпроблемно конвертира основно текстово форматиране, като гарантира, че акцентът и структурата на вашето съдържание остават непроменени. Стандартните параграфи се конвертират със съответните разстояния, както и текст, форматиран като удебелен или курсив в Word, се превръща лесно в съответния Markdown синтаксис. Следният пример демонстрира как софтуерните разработчици могат да конвертират Word документи с основно текстово форматиране, използвайки Ruby библиотеката.

Как да конвертираме Word Docx в Markdown с основно форматиране чрез Ruby?

require 'word-to-markdown'

# Create a new WordToMarkdown object with the path to your .docx file
w2m = WordToMarkdown.new("path/to/your/document.docx")

# Convert the document to Markdown
markdown_output = w2m.to_s

# Print the output
puts markdown_output

Извличане на изображения и връзки чрез Ruby

Изображенията често са проблем в миграцията на съдържание, но библиотеката Word-to-Markdown ги обработва без усилие. Тя включва пълна поддръжка за извличане на изображения, таблици и линкове от Microsoft Word документи в Ruby приложения. Библиотеката извлича изображенията от Word документа и автоматично генерира Markdown синтаксис за изображение (![alt text](image_url)). Следният пример показва как софтуерните разработчици могат да извлекат изображения в директория images/ и да вградят Markdown линкове към изображения в изхода, използвайки Ruby API.

Как автоматично да обработваме изображения в Word документи чрез Ruby?

options = { extract_images: true, image_output_dir: "images" }
md_with_images = WordToMarkdown.convert("report.docx", **options)
puts md_with_images

Извличане на таблици и хипервръзки от Word файл чрез Ruby

Таблиците са друг сложен елемент, който може да бъде труден за ръчно конвертиране. Отворената код библиотека Word-to-Markdown изпълнява отлично превръщането на Word таблици в pipe‑базирания синтаксис на Markdown с няколко реда код. Всички хипервръзки в оригиналния Word документ се запазват и се конвертират в правилния Markdown синтаксис за линкове ([link text](url)).

 Български