title: How to embed markdown documentation inside a working code with C type syntax for commenting?
body: <p>Basically I want to write one piece of text which qualifies both as a working code and MarkDown (preferably GitHub flavor) for documentation. The language I'm using has C form commenting <code>\\</code> for rest-of-line and <code>/* ... */</code> for multi line comments. So far what I can do is:</p>
  
  <pre><code>/* --&gt; start with multi line comments 
  here some markdown text
  # heading
   * list
  
  end markdown section with
  &lt;!--- */ // --&gt;
  or
  [//]: # (end of comment block --&gt; */ // &lt;-- inline comment)
  
  _-_-indented code
  _-_-_-_-more indented code
  </code></pre>
  
  <p>The issues are:</p>
  
  <ul>
  <li>the first <code>/*</code> still showing in the documentation</li>
  <li>I can't use the proper multiline code block <code>``` ... ```</code>. I have to indent the code parts once more than what is required. Also the syntax highlighting doen't work in this format AFIK.</li>
  </ul>
  
  <p>I would appreciate if you could help me know first how to solve above issues. and Secondly if there is any better way to do this?</p>