word-to-markdown - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #typescript #golang #android #machine-learning #rust #docker #macos #windows #awesome #security #open-source

word-to-markdown

(★ 1,550)

A ruby gem to liberate content from Microsoft Word documents

파일 탐색기

최종 버전 다운로드 (.zip)

- - bug_report.md
  - feature_request.md
- - approve-and-merge-dependabot-prs.yml
  - ci.yml
  - codeql-analysis.yml
  - moderate.yml
- CODEOWNERS
- config.yml
- dependabot.yml
- funding.yml
- no-response.yml
- release-drafter.yml
- settings.yml
- stale.yml
- w2m
- CODE_OF_CONDUCT.md
- CONTRIBUTING.md
- SECURITY.md
- - dependency_ext.rb
- - converter.rb
  - document.rb
  - version.rb
- word-to-markdown.rb
- bootstrap
- cibuild
- console
- - comma after bold.docx
  - em.docx
  - file with space.docx
  - h1.docx
  - h2.docx
  - list-with-links.docx
  - multiple-headings.docx
  - nested-ol.docx
  - nested-ul.docx
  - ol.docx
  - p.docx
  - small-medium-large.docx
  - strong.docx
  - table.docx
  - text after bold.docx
  - ul.docx
- helper.rb
- test_word_to_markdown.rb
- test_word_to_markdown_cli.rb
- test_word_to_markdown_document.rb
- test_word_to_markdown_implicit_headings.rb
- test_word_to_markdown_lists.rb
.codeclimate.yml
.gitignore
.hadolint.yml
.rubocop.yml
.rubocop_todo.yml
.travis.yml
appveyor.yml
docker-compose.yml
Dockerfile
Gemfile
LICENSE.md
Rakefile
README.md
word-to-markdown.gemspec

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Word to Markdown converter

> [!IMPORTANT]
> **Looking for the latest and greatest?** Check out [**word-to-markdown-js**](https://github.com/benbalter/word-to-markdown-js), the newer, better successor to this project. It's a modern, actively maintained rewrite and is recommended for new projects. This Ruby gem remains available for existing users.

A Ruby gem to liberate content from [the jail that is Word documents](http://ben.balter.com/2012/10/19/we-ve-been-trained-to-make-paper/#jailbreaking-content)

[![CI](https://github.com/benbalter/word-to-markdown/actions/workflows/ci.yml/badge.svg)](https://github.com/benbalter/word-to-markdown/actions/workflows/ci.yml) [![Gem Version](https://badge.fury.io/rb/word-to-markdown.png)](http://badge.fury.io/rb/word-to-markdown) [![Inline docs](http://inch-ci.org/github/benbalter/word-to-markdown.png)](http://inch-ci.org/github/benbalter/word-to-markdown) [![Build status](https://ci.appveyor.com/api/projects/status/x2gnsfvli3q47a2e/branch/master?svg=true)](https://ci.appveyor.com/project/benbalter/word-to-markdown/branch/master) [![Maintainability](https://api.codeclimate.com/v1/badges/aae0d67ea7db185f1595/maintainability)](https://codeclimate.com/github/benbalter/word-to-markdown/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/aae0d67ea7db185f1595/test_coverage)](https://codeclimate.com/github/benbalter/word-to-markdown/test_coverage)

## The problem

> Our default content publishing workflow is terribly broken. [We've all been trained to make paper](http://ben.balter.com/2012/10/19/we-ve-been-trained-to-make-paper/), yet today, content authored once is more commonly consumed in multiple formats, and rarely, if ever, does it embody physical form. Put another way, our go-to content authoring workflow remains relatively unchanged since it was conceived in the early 80s.
>
> I'm asked regularly by government employees — knowledge workers who fire up a desktop word processor as the first step to any project — for an automated pipeline to convert Microsoft Word documents to [Markdown](http://guides.github.com/overviews/mastering-markdown/), the *lingua franca* of the internet, but as my recent foray into building [just such a converter](http://word-to-markdown.herokuapp.com/) proves, it's not that simple.
>
> Markdown isn't just an alternative format. Markdown forces you to write for the web.

**[Read more](http://ben.balter.com/2014/03/31/word-versus-markdown-more-than-mere-semantics/)**

## Just want to convert a Microsoft Word (or Google) document to Markdown?

You can use this **[hosted service](https://word2md.com/)** (or check out [its source](https://github.com/benbalter/word-to-markdown-server)).

## Install

You'll need to install [LibreOffice](http://www.libreoffice.org/). Then:

```bash
gem install word-to-markdown
```

## Usage

```ruby
file = WordToMarkdown.new("/path/to/document.docx")
=> <WordToMarkdown path="/path/to/document.docx">

file.to_s
=> "# Test\n\n This is a test"

file.document.tree
=> <Nokogiri Document>
```

### Command line usage

Once you've installed the gem, it's just:

```
$ w2m path/to/document.docx
```

*Outputs the resulting markdown to stdout*

## Supports

* Paragraphs
* Numbered lists
* Unnumbered lists
* Nested lists
* Italic
* Bold
* Explicit headings (e.g., selected as "Heading 1" or "Heading 2")
* Implicit headings (e.g., text with a larger font size relative to paragraph text)
* Images
* Tables
* Hyperlinks

## Requirements and configuration

Word-to-markdown requires `soffice` a command line interface to LibreOffice that works on Linux, Mac, and Windows. To install soffice, see [the LibreOffice documentation](https://www.libreoffice.org/get-help/install-howto/).

## Testing

```
script/cibuild
```

## Docker

First, create the `Gemfile.lock` by installing the dependencies:

```
bundle install
```

Everything you need to run the executable locally:

```
docker-compose build
docker-compose run --rm app bundle exec w2m --help
docker-compose run --rm app bundle exec w2m test/fixtures/em.docx
```

## Hosted service

[Word-to-markdown-server](https://github.com/benbalter/word-to-markdown-server) contains a lightweight server for converting Word Documents as a service. A live version runs at [word2md.com](https://word2md.com).