Markdown in Doxygen with @file

问题:

I'm trying to document some source code templates with doxygen and markdown using fenced code blocks

~~~cpp
/// @file    filename.h
~~~

But Doxygen seems to process the @file command even though its verbatim code which results in the warning

warning: the name `filename.h' supplied as the second argument
in the \file statement is not an input file

What am I doing wrong?

回答1:

You have to escape the "@" sign. Use \@file instead.