How to configure 'less' to show formatted markdown files?

Question

I would like to have less display *.md markdown files with some formatting -- like I know less can, for manpages, etc. I am running Ubuntu 12.04.

I am as far as putting a user defined filter into .lessfilter:

#!/bin/sh
case "$1" in
  *.md)
    fn=/tmp/$1.$$.html
    markdown "$1" | html2txt > $fn  ### LOSES FORMATTING
    cat $fn                         ### TO STDOUT???
    ;;
  *)
  # We don't handle this format
  exit 1
esac
# No further processing by lesspipe necessary
exit 0

So, the main questions are:

• How can I pass some basic formatting information to less as well, instead of losing it with html2txt
• Is it correct to just print the new content to stdout? Or could I just write the *.html to file disk and let less handle that html at its own digression (seeing the html-extension and acting on it?)

Answer 1

Take a look at Pandoc. It can convert files from markdown format to groff man pages which you can then view in man.

Your .lessfilter script would be:

case "$1" in
  *.md)
    pandoc -s -f markdown -t man "$1" | man -l -
    ;;

Alternatively, convert it to html using the markdown command and then use the lynx browser to view it, but this didn't work too well for me.

case "$1" in
  *.md)
    markdown "$1" | lynx -stdin
    ;;

And, yes, the lessfilter script must write to stdout.

Answer 2

Dogbane's answer is great, but if you use groff -T utf8 -man instead of man -l to do the formatting, then the bold, italic, etc. come through. As seen here: https://stackoverflow.com/a/20197316/2674930.