use markdown caption for examples
update docs