Go doc comments are written in a simple syntax that supports paragraphs, headings, links, lists, and preformatted code blocks. To keep comments lightweight and readable in source files, there is no support for complex features like font changes or raw HTML. Markdown aficionados can view the syntax as a simplified subset of Markdown.
Комментарии Go doc написаны с использованием простого синтаксиса, который поддерживает абзацы, заголовки, ссылки, списки и предварительно отформатированные блоки кода. Чтобы комментарии были легкими и читаемыми в исходных файлах, не поддерживаются сложные функции, такие как изменение шрифта или необработанный HTML. Поклонники Markdown могут рассматривать синтаксис как упрощенное подмножество Markdown.