MarkdownKit

MarkdownKit is a high-performance native Markdown renderer for Apple platforms, built in Swift with swift-markdown and TextKit-based layout.

Highlights

• CommonMark + GitHub Flavored Markdown (tables, task lists, strikethrough, links)
• Native table rendering (NSTextTable) with GitHub-like styling
• Math support ($...$, $$...$$, and fenced math) via MathJaxSwift
• Collapsed sections support (<details>/<summary>)
• Diagram fence detection (mermaid, geojson, topojson, stl) with pluggable adapter fallback
• Async layout pipeline and virtualized iOS/macOS collection views

Requirements

• Swift 6.2+
• iOS 17.0+
• macOS 26.0+

Quick Start

swift build
swift test
swift run MarkdownKitDemo

Basic Usage

import MarkdownKit

let parser = MarkdownKitEngine.makeParser()
let solver = MarkdownKitEngine.makeLayoutSolver()

let document = parser.parse("# Hello MarkdownKit")
let layout = await solver.solve(node: document, constrainedToWidth: 800)
print(layout.children.count)

One-Call Convenience

import MarkdownKit

let layout = await MarkdownKitEngine.layout(
    markdown: "# Hello\n\nThis is **MarkdownKit**.",
    constrainedToWidth: 800
)
print(layout.children.count)

Automated Verification

bash scripts/verify_all.sh

Optional heavy benchmark suites:

bash scripts/verify_all.sh --with-benchmarks

One-shot full suite (includes all tests, including benchmarks/snapshots):

bash scripts/verify_all.sh --full

Project Structure

• Sources/MarkdownKit: core parser, AST nodes, plugins, layout engine, UI components
• Sources/MarkdownKitDemo: demo app
• Tests/MarkdownKitTests: unit/integration tests
• docs/: PRD, feature notes, roadmap
• scripts/: local automation and verification entrypoints
• tasks/: implementation checklist