Annotations in markdown

Question

I have searched Google and SO, and don't know if SO is the place to ask this, but I was wondering if there is markup for doing annotations of some type for markdown? We do docs in markdown for our project and would like to do annotations between team members without changing the contents. Maybe I am asking this wrong, but I hope this makes sense. As of now, I am guessing there is not as I have not found an answer, and hoping someone else has found a way to do such a thing.

Thank you for any help that can be offered.

Answer 1

For comments:

Use HTML formatted comments (as scoa noted):

<!-- this is a comment --> 

HTML is a part of the markdown specification:

For any markup that is not covered by Markdown’s syntax, you simply use HTML itself. There’s no need to preface it or delimit it to indicate that you’re switching from Markdown to HTML; you just use the tags.

For footnotes:

Footnotes are not part of the offical/original markdown specification.

But some markdown flavours support [^1] / [^1]: syntax, for example:

Some Text. [^footnote]

[^footnote]: This is a footnote.

Answer 2

I think

http://criticmarkup.com/

might be a solution. It offeres a special syntax for additions, deletions, changes and comments, as well as a machinery to highlight these changes.