Skip to content

A Java Wikipedia markup to plain text converter

Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



73 Commits

Repository files navigation


Build Status Maven Central LICENSE

WikiClean is a Java Wikipedia markup to plain text converter. It takes Wikipedia XML dumps with articles in wikimedia markup and generates clean plain text.


For text processing applications, we often need access to plain text, unadulterated by wikimedia markup. This is surprisingly non-trivial, as Wikipedia articles are full of complexities such as references, image captions, tables, infoboxes, etc., which are not useful for many applications.

Before setting out to write this package, I explored many of the Java alternatives for parsing Wikipedia pages described here and found none of them to be adequate for generating clean plain text. The primarily challenge is that most of these packages aspire to be complete Wikipedia parsers (e.g., for rendering), whereas WikiClean was designed with a much simpler goal — wiki markup to plain text conversion (nothing more, nothing less).


It's simple to use WikiClean:

WikiClean cleaner = new WikiClean.Builder().build();
String content = cleaner.clean(raw);

Where raw is the raw Wikpedia XML.

The builder allows you to specify a few options:

  • withTitle to specify whether to prepend the article title in the plain text.
  • withFooter to specify whether to keep the sections "See also", "Reference", "Further reading", and "External links".

By default, both options are set to false.

Also, use withLanguage to set the language. Currently, 17 are supported:

The corresponding classes are in org.wikiclean.languages.

Contributions for providing additional language support welcome!

Putting everything together, the default builder is equivalent to:

WikiClean cleaner =
    new WikiClean.Builder()
        .withLanguage(new English())
String content = cleaner.clean(raw);

Sample command-line invocation to read a Wikipedia dump and output plain text:

mvn exec:java -Dexec.mainClass=org.wikiclean.WikipediaArticlesDump \
  -Dexec.args="-input enwiki-20161220-pages-articles.xml.bz2" | less

Maven Artifacts

Latest releases of Maven artifacts are available at Maven Central.


Licensed under the Apache License, Version 2.0:


A Java Wikipedia markup to plain text converter