title: Let Vim interpret and highlight code comments/docs as markdown
body: <p>I came up with this idea/question yesterday. I think it's very cool to have bold fonts, external links, mathematical formulas and references when you are writing code comments/docs. Before posting this question I find this idea is not new, people have asked about it. According to what I have tried (including this one: <a href="https://stackoverflow.com/questions/16201896/mixing-two-syntax-highlighting-scripts">Mixing two syntax highlighting scripts</a>), there have been no working solutions (or detailed enough for it to work for people like me...).</p>
  
  <p>I think this is not technically difficult, since syntax highlighters need to identify different syntax regions (comments, keywords, strings etc) before coloring them, just that we want the 'markdown' way to interpret the comment syntax region.</p>
  
  <p>Are there any experienced Vim users that have done things similar, I would appreciate some hints or examples from you very much! (for example: how to interpret """docstring""" in python as markdown) Following is content of my ~/.vim/after/syntax/python.vim file which does not work (I referred to this link: <a href="http://vim.wikia.com/wiki/Changing_the_default_syntax_highlighting" rel="nofollow noreferrer">http://vim.wikia.com/wiki/Changing_the_default_syntax_highlighting</a>):</p>
  
  <pre><code>syn include @Pandoc syntax/pandoc.vim
  "syn region pyDoc start="\"\"\"" end="\"\"\"" contains=@Pandoc
  syn region pyDoc start=+\%(:\n\s*\)\@&lt;=\z('''\|"""\)+ end=+\z1+ keepend
    \ contains=@Pandoc
  </code></pre>