doxygen \ codeタグは同じページのhtmlタグを壊します

Question

これは私のここでの最初の質問です。

私のC++コードを文書化するためにdoxygenを使用すると、私は奇妙な問題が発生します。ページに\ codeタグがあるとすぐに、すべてのHTMLタグが出力で処理されません。

最初の例は、私がhtmlタグから期待したものを示しています。 2番目の例では、doxygen \ codeタグを追加するだけで、完全な出力が破損しています。

例1：

//! \page testpage Test Page 
//! 
//! <ul> 
//!  <li>\ref test_section1</li> 
//!  <li>\ref test_section2</li> 
//! </ul> 
//! 
//! \section test_section1 Test Section 1 
//! 
//! Any text. 
//! 
//! \section test_section2 Test Section 2 
//! 
//! Any text. 
//! <br><br> 

doxygen result of the first example

例2：私はLinux上でdoxygenの1.8.5を使用していますところで

//! \page testpage Test Page 
//! 
//! <ul> 
//!  <li>\ref test_section1</li> 
//!  <li>\ref test_section2</li> 
//! </ul> 
//! 
//! \section test_section1 Test Section 1 
//! 
//! Any text. 
//! 
//! \code 
//! if (x==1) return; 
//! \endcode 
//! 
//! \section test_section2 Test Section 2 
//! 
//! Any text. 
//! <br><br> 

doxygen result of the second example

。

Answer 1

現在のバージョンのdoxygen（1.8.12）を使用することで問題は解決します。

doxygen設定ファイル（Doxyfile）でMarkdownサポート（MARKDOWN_SUPPORT = NO）を無効にすると、1.8.5でより良い結果が得られます。

良い結果

また、コードの次の形式を使用することによって得ることができます。

/** 
    \page testpage2 Test2 Page 

    <ul> 
    <li>\ref test_section1</li> 
    <li>\ref test_section2</li> 
    </ul> 

    \section test_section1 Test Section 1 

    Any text. 

    \code 
    if (x==1) return; 
    \endcode 

    \section test_section2 Test Section 2 

    Any text. 
    <br><br> 
*/ 

これはMARKDOWN_SUPPORTの設定とは無関係に進みます。

アドバイスは現在のバージョン（1.8.12）を使用しています。