Import from other blog software


pelican-import is a command line tool for converting articles from other software to ReStructuredText. The supported formats are:

  • WordPress XML export
  • Dotclear export
  • RSS/Atom feed

The conversion from HTML to reStructuredText relies on pandoc. For Dotclear, if the source posts are written with Markdown syntax, they will not be converted (as Pelican also supports Markdown).


pelican-import has two dependencies not required by the rest of pelican:

  • BeautifulSoup
  • pandoc

BeatifulSoup can be installed like any other Python package:

$ pip install BeautifulSoup

For pandoc, install a package for your operating system from the pandoc site.


pelican-import [-h] [–wpfile] [–dotclear] [–feed] [-o OUTPUT]
[-m MARKUP][–dir-cat]

Optional arguments

-h, --help show this help message and exit
--wpfile Wordpress XML export
--dotclear Dotclear export
--feed Feed to parse
-o OUTPUT, --output OUTPUT
 Output path
-m MARKUP Output markup
--dir-cat Put files in directories with categories name


for WordPress:

$ pelican-import --wpfile -o ~/output ~/posts.xml

for Dotclear:

$ pelican-import --dotclear -o ~/output ~/backup.txt


To test the module, one can use sample files:

Fork me on GitHub