HTML::WikiConverter::Markdown - Convert HTML to Markdown markup


  use HTML::WikiConverter;
  my $wc = new HTML::WikiConverter( dialect => 'Markdown' );
  print $wc->html2wiki( $html );


This module contains rules for converting HTML into Markdown markup. You should not use this module directly; HTML::WikiConverter is the entry point for html->wiki conversion (eg, see synopsis above). See HTML::WikiConverter for additional usage details.


In addition to the regular set of attributes recognized by the HTML::WikiConverter constructor, this dialect also accepts the following attributes that can be passed into the new() constructor. See "ATTRIBUTES" in HTML::WikiConverter for usage details.


Possible values: 'setext', 'atx'. Determines how headers h1-h6 will be formatted. See for more information. Default is 'atx'.

Possible values: 'inline', 'reference'. See for more information. Default is 'reference'.

Possible values: 0, 1. If enabled, links to anchors within the same page (eg, #some-anchor) will always produce inline Markdown links, even under reference link style. This might be useful for building tables of contents. Default is 0.


Possible values: 'inline', 'reference'. See for more information. Default is 'reference'.


Possible values: 0, 1. Markdown's image markup does not support image dimensions. If image_tag_fallback is enabled, image tags containing dimensional information (ie, width or height) will not be converted into Markdown markup. Rather, they will be roughly preserved in their HTML form. Default is 1.


Possible values: 'asterisk', 'plus', 'dash'. See for more information. Default is 'asterisk'.


Possible values: 'sequential', 'one-dot'. Markdown supports two different markups for ordered lists. Sequential style gives each list element its own ordinal number (ie, '1.', '2.', '3.', etc.). One-dot style gives each list element the same ordinal number (ie, '1.'). See for more information. Default is 'sequential'.


Possible values: 0, 1. Support MarkDown Extra extensions. Default is 0.

This support is incomplete.

    # Tables                            Supported
    # Fenced Code Blocks
    # Definition Lists          Supported
    # Footnotes
    # Special Attributes
    # SmartyPants
    # Newlines
    # Strikethrough


David J. Iberri, <diberri at>


Please report any bugs or feature requests to bug-html-wikiconverter-markdown at, or through the web interface at I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.


You can find documentation for this module with the perldoc command.

    perldoc HTML::WikiConverter::Markdown

You can also look for information at:


Copyright 2006 David J. Iberri, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.