From Wikipedia, the free encyclopedia
Jump to navigation Jump to search

There are various methods to transfer content from word processor software into a MediaWiki format as used on Wikipedia.

Microsoft Word[edit]


VisualEditor allows for the copying/pasting of content from Word documents directly into a wiki page. Most formatting is kept intact – including tables. However, images and advanced formatting may need to be cleaned up upon import.


The following Visual Basic macros from 2007, unmaintained as of 2017, may still work: Word2MediaWikiPlus Tested with Office 365 word, conversion works despite getting a warning several times. NOTE: This will (apparently?) only work with 32-bit Office installations

Download from:

Microsoft Office Word Add-in For MediaWiki[edit]

Microsoft released an add-in that allows you to save your Microsoft Office Word 2007 or above documents straight into MediaWiki.

  1. Download the "Microsoft Office Word Add-in For MediaWiki" from Microsoft Download Center, and install it.
  2. Save the document as "MediaWiki (*.txt)" file type.
  3. Copy the text from the (*.txt) file into your Wiki page

Note that this extension does not work for Word 2013 by default, however it can be made to work with a registry change. See this page.

Possible issues with alternative solution[edit]

  • This add-in requires Windows as an operating system; it won't work with macOS
  • This Microsoft add-in does not handle images. A placeholder is emitted.
  • End notes and footnotes can't be converted. Including them in a document will throw an error.
  • If you attempt to resolve the previous issue by inserting <ref> tags, upon conversion Word will replace the angled brackets with < and >
  • Some text will be enclosed by <nowiki> and </nowiki> tags.
  • Not supported for Office/Word 2013, see Word Add-in For MediaWiki not supported in Word 2013?

Nevertheless, for those who are unfamiliar with MediaWiki Markup Language and who are working on simple articles, the Microsoft Office Word Add-in For MediaWiki can be a useful tool.

Two-stage conversion from Word to MediaWiki[edit]

The following methods both perform: Word → HTML → MediaWiki.


  1. Open your document in Word, and "save as" an HTML file.
  2. Open the HTML file in a text editor and copy the HTML source code to the clipboard.
  3. Paste the HTML source into the large text box labeled "HTML markup:" on the html to wiki page.
  4. Click the blue Convert button at the bottom of the page.
  5. Select the text in the "Wiki markup:" text box and copy it to the clipboard.
  6. Paste the text to a Wikipedia article.

Automated scripts[edit]

The conversion can also be done using a combination of two scripts and two software packages.

  1. The following two software packages must be installed:
  2. Write the bash script "doc2mw", and the perl script "html2mw", both shown below.
  3. Call doc2mw passing the word document as parameter. i.e.
> doc2mw my_word.doc
a bash script taking a single parameter, which calls wvHtml followed by html2mw.
 #       doc2mw - Word to MediaWiki converter
 if [ -x "./html2mw" ]; then
 wvHtml --targetdir=/tmp "${FILE}" "${TMP}" 
 # but see also AbiWord:
 # Remove extra divs
 perl -pi -e "s/\<div[^\>]+.\>//gi;" "/tmp/${TMP}"
 ${HTML2MW} "/tmp/${TMP}"
 rm "/tmp/${TMP}"
a perl script called by doc2mw, which uses HTML::WikiConverter to convert html -> mediawiki.
 #       html2mw - HTML to MediaWiki converter
 use HTML::WikiConverter;
 my $b;
 while (<>) { $b .= $_; }
 my $w = new HTML::WikiConverter( dialect => 'MediaWiki' );
 my $p = $w->html2wiki($b);
 # Substitutions to get rid of nasty things we don't need
 $p =~ s/<br \/>//g;
 $p =~ s/\&nbsp\;//g;
 print $p;

Disclaimer: These scripts are probably not the best way to do this, only a possible way to do this. Please feel free to improve them.

OpenOffice or LibreOffice[edit]

LibreOffice Writer can save Word documents directly to wikitext: go to File → Export → Save as type: Mediawiki. (For Linux users it may be necessary to install the library libreoffice-wiki-publisher). Alternatively, use the command-line utility like this:

soffice --headless --convert-to txt:MediaWiki mydocument.doc

OpenOffice versions 3.3 and later can send documents in formats it supports (including Microsoft Word) directly to a MediaWiki, but this does not seem to work under Windows 7. (At least for the German version of OpenOffice 3.3.0 you need to install the ‘Sun Wiki Publisher’-extension first! Server url: ) Once you have added the MediaWiki-server of your choice, future submissions can happen automatically.

  1. Open the document in OpenOffice or LibreOffice Writer.
  2. Go to File → Send-To → To MediaWiki or File → Export → Save file as: Mediawiki
  3. Select your MediaWiki-server (or click on the button "Add..." to add a new site).
  4. Select a title and summary for your article, check the box if it's a minor revision.
  5. Click the send button.

Alternatively the manual 'export-function' can be used: File → Export → choose ‘MediaWiki (.txt)’-format. LibreOffice Writer 5 can export as a MediaWiki .txt file under Windows 10 if the appropriate 32- or 64-bit Java Runtime Environment (JRE) has been installed and enabled in LO. The document to be converted has to use styles, etc.; for example headers must be in Heading 2 style to be bracketed by "==" when converted.


Pandoc is a command-line utility that can convert from and to many document formats. Once installed, converting from Word to Mediawiki looks like this:

$ pandoc -t mediawiki mydocument.docx >

See also the online Pandoc tool which can convert an HTML-export of the Word document to MediaWiki format.

See also[edit]