NAME

       html2markdown - converts a page of HTML into markdown.

SYNOPSIS

       html2markdown [options...] [(filename|url) [encoding]]

DESCRIPTION

       html2markdown  downloads  the  specified HTML page, and converts it to text marked up with
       markdown.  The source HTML page may be a local file or remote URL.  If not  specified,  it
       will be read from standard input.  The output is printed to standard output.

       If  an  encoding  is  specified, it will override any encoding information provided by the
       HTTP Server.  When not  specified,  python-feedparser  (if  available)  will  be  used  to
       determine  the  source  encoding.   If  not  available,  or  when reading local files, the
       encoding is assumed to be UTF-8.

OPTIONS

       --default-image-alt=TEXT
              The default alt string for images with missing ones.

       --pad-tables
              Pad the cells to equal column width in tables.

       --no-wrap-links
              Don't wrap long links.

       --wrap-list-items
              Wrap long list items.

       --wrap-tables
              Wrap long table rows.

       --ignore-emphasis
              Don't include any formatting for emphasis.

       --reference-links
              Use reference style links instead of in-line links.

       --ignore-links
              Don't include any formatting for links.

       --ignore-mailto-links
              Don't include any formatting for mailto: links.

       --protect-links
              Protect links from line breaks surrounding them with angle brackets.

       --ignore-images
              Don't include any formatting for images.

       --images-as-html
              Always write image tags as row html; preserves height, width and alt if possible.

       --images-to-alt
              Discard image data, only keep alt text.

       --images-with-size
              Write image tags with height and width attrs as raw html to retain dimensions.

       -g, --google-doc
              Convert an html-exported Google Document.

       -d, --dash-unordered-list
              Use a dash rather than a star for unordered list items.

       -e, --asterisk-emphasis
              Use an asterisk rather than an underscore for emphasized text.

       -b BODY_WIDTH, --body-width=BODY_WIDTH
              Number of characters per output line, 0 for no wrap.

       -i LIST_INDENT, --google-list-indent=LIST_INDENT
              Number of pixels Google indents nested lists.

       -s, --hide-strikethrough
              Hide strike-through text. Only relevant when -g is specified as well.

       --escape-all
              Escape all special characters. Output is less  readable,  but  avoids  corner  case
              formatting issues.

       --bypass-tables
              Format tables in HTML rather than Markdown syntax.

       --ignore-tables
              Ignore table-related tags (table, th, td, tr) while keeping rows.

       --single-line-break
              Use  a  single line break after a block element rather than two line breaks.  NOTE:
              Requires --body-width=0.

       --unicode-snob
              Use unicode throughout document.

       --no-automatic-links
              Do not use automatic links wherever applicable.

       --no-skip-internal-links
              Do not skip internal links.

       --links-after-para
              Put links after each paragraph instead of document.

       --mark-code
              Mark program code blocks with [code]...[/code].

       --decode-errors=DECODE_ERRORS
              What to do in case of decode errors. ignore, strict,  and  replace  are  acceptable
              values.

       --open-quote=CHAR
              The character used to open quotes.

       --close-quote=CHAR
              The character used to clone quotes.

       --include-sup-sub
              Include the sup and sub tags.

       --version
              Show program's version number and exit.

       -h, --help
              Show a help message and exit.

AUTHOR

       This manpage was written for Debian, by Stefano Rivera <stefanor@debian.org>.