DocC
Produce rich API reference documentation and interactive tutorials for your Swift framework or package.
Overview
The DocC documentation compiler converts Markdown-based text into rich documentation for Swift frameworks and packages. You can preview the documentation in its published form as you work on it, and also host it on a website when it’s complete.
DocC syntax — called documentation markup — is a custom variant of Markdown that adds functionality for developer-specific documentation features, like cross-symbol linking, term-definition lists, code listings, and asides. You add documentation markup to your source code, compile it with DocC, and produce reference documentation for your APIs. You can also use documentation markup, along with a set of directives that instruct how DocC generates your content, to offer step-by-step tutorials that teach developers to use your APIs through interactive coding exercises or to craft comprehensive articles that explain specific technologies or topics.
[Image]
Topics
Essentials
Documentation Content
Writing Symbol Documentation in Your Source FilesAdding Supplemental Content to a Documentation CatalogLinking to Symbols and Other ContentAdding Code Snippets to your ContentDocumenting API with Different Language Representations
Structure and Formatting
Formatting Your Documentation ContentAdding Tables of DataOther Formatting OptionsAdding Images to Your ContentAdding Structure to Your Documentation PagesCustomizing the Appearance of Your Documentation Pages