Better code comments for C#

MyFunction.txt

Current way has some cool features, but nobody uses them, and SNR is terrible, plus XML is terribly bad too:

/// <summary>
/// Function summary goes here
/// </summary>
/// <param name="param1">Some <i>crazy</i> number</param>
/// <param name="param2">Some <b>bad</b> string</param>
/// <param name="param3">An amazingly nice value</param>
/// <returns>Function returns <see cref="SomeClassType"/></returns>

Proposed new way (to be revised) has excellent SNR, is simple and concise:

/// Function summary goes here
/// param1: Some _crazy_ number
/// param2: Some *bad* string
/// param3: An amazingly nice value
/// returns: Function returns @SomeClassType

Revisions/sugestions are welcome. Once we have something good we'll discuss editor plugins.

Stick to md? I personally don't like [](SomeType), and considering that the vast majority of 'links' will be just refing types, that's overkill, we better go with some tags to wrap our stuff, or maybe even some special character to mark the beginning of a type since it can't contain spaces anyway, maybe something like this method returns @SomeType class etc.