The following example demonstrates a problem with inline markdown links that reference targets with ) in them:

/**
 * X
 */
class X {
public:
    /**
     * func
     */
    void func();

    /**
     * call
     */
    void operator()();
};

/**
 * [func](\ref X::func)
 *
 * [func](\ref X::func())
 *
 * [func](\ref X::operator()())
 *
 * [func][1]
 *
 * [func][2]
 *
 * [func][3]
 *
 * [1]: \ref X::func
 * [2]: \ref X::func()
 * [3]: \ref X::operator()()
 */
class Y {
};


For all of the reference links, everything is fine, however for the inline links, it appears that the parsing stops at the first ) encountered, resulting in some mangled output when converted to doxygen markup. For example the second link about is translated as:

\ref X::func( "func")