improve markdown and add a couple articles