documentation: fix more markdown issues (youtube embeds broken on github?)