use lib/md and document usage