Back to products
docc2json

docc2json

Turn Apple DocC output into a web-friendly SDK JSON schema

Website github.com
Overview

What it is

Apple DocC is great inside Xcode, but hard to reuse elsewhere. docc2json parses DocC JSON output and converts it into a clean, structured SDK schema optimized for web documentation sites, IDE tooling, and analysis.

Intent

I need it when

Generate markdown or MDX documentation files from structured API data for docs site integration

The included json2docs command converts the generated JSON into .md or .mdx files with optional frontmatter, enabling seamless integration with documentation systems like Docusaurus, Next.js, or other static site generators

Convert Apple DocC documentation into a structured JSON format suitable for web deployment

docc2json parses Xcode-built DocC JSON output and transforms it into a clean, API-deployable JSON schema optimized for web documentation sites and SDKs, enabling developers to host and render documentation on custom frontends

Organize and filter SDK documentation by access level and group related types for better navigation

docc2json supports filtering by public-only access level, automatic prefix-based grouping, custom YAML-based grouping configuration, and protocol conformance filtering to organize documentation into logical sections for website integration

Automate SDK documentation pipeline from Xcode build output to deployable web format

docc2json is a fast Go CLI tool with parallel JSON processing that can be integrated into CI/CD workflows to automatically convert DocC archives into web-ready JSON and markdown, supporting articles, tutorials, and cross-reference resolution

Extract comprehensive API documentation including types, methods, parameters, and code examples from Swift source

The tool extracts full documentation metadata from DocC comments including abstracts, discussions, examples, code listings, parameters, return types, and async/throws modifiers, preserving rich context for API reference generation

Drop

Not a fit when

  • User needs to convert non-Apple DocC documentation formats (tool is specific to Xcode DocC output)
  • User requires a graphical user interface or web-based tool (docc2json is a command-line CLI tool)
  • User needs real-time documentation hosting and rendering (tool only generates JSON; separate frontend required)
  • User works with non-Swift or non-Apple ecosystem documentation (tool designed for Apple's DocC format)
  • User requires commercial support or SLA guarantees (open source project with no official support tier)
Commercials

Pricing

Free, open source