{"id":13461780,"url":"https://github.com/swiftlang/swift-markdown","last_synced_at":"2025-12-11T23:01:50.422Z","repository":{"id":37377478,"uuid":"387532152","full_name":"swiftlang/swift-markdown","owner":"swiftlang","description":"A Swift package for parsing, building, editing, and analyzing Markdown documents.","archived":false,"fork":false,"pushed_at":"2025-05-13T08:30:21.000Z","size":1926,"stargazers_count":2950,"open_issues_count":49,"forks_count":217,"subscribers_count":125,"default_branch":"main","last_synced_at":"2025-05-13T09:35:44.830Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://swiftpackageindex.com/swiftlang/swift-markdown/documentation/markdown","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/swiftlang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-07-19T16:42:24.000Z","updated_at":"2025-05-13T08:30:26.000Z","dependencies_parsed_at":"2023-02-14T16:30:46.155Z","dependency_job_id":"ee818d36-cde5-4825-a4f0-11dd4ada0ee6","html_url":"https://github.com/swiftlang/swift-markdown","commit_stats":{"total_commits":103,"total_committers":36,"mean_commits":2.861111111111111,"dds":0.7572815533980582,"last_synced_commit":"82f9258ce53b9da7980d1c1aaf80e5bdbbf98c9b"},"previous_names":["swiftlang/swift-markdown","apple/swift-markdown"],"tags_count":843,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swiftlang%2Fswift-markdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swiftlang%2Fswift-markdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swiftlang%2Fswift-markdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swiftlang%2Fswift-markdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/swiftlang","download_url":"https://codeload.github.com/swiftlang/swift-markdown/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253918403,"owners_count":21984248,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T11:00:57.415Z","updated_at":"2025-12-11T23:01:45.063Z","avatar_url":"https://github.com/swiftlang.png","language":"Swift","funding_links":[],"categories":["Swift","others"],"sub_categories":[],"readme":"# Swift Markdown\n\nSwift `Markdown` is a Swift package for parsing, building, editing, and analyzing Markdown documents.\n\nThe parser is powered by GitHub-flavored Markdown's [cmark-gfm](https://github.com/github/cmark-gfm) implementation, so it follows the spec closely. As the needs of the community change, the effective dialect implemented by this library may change.\n\nThe markup tree provided by this package is comprised of immutable/persistent, thread-safe, copy-on-write value types that only copy substructure that has changed. Other examples of the main strategy behind this library can be seen in [SwiftSyntax](https://github.com/swiftlang/swift-syntax).\n\n## Getting Started Using Markup\n\nIn your `Package.swift` Swift Package Manager manifest, add the following dependency to your `dependencies` argument:\n\n```swift\n.package(url: \"https://github.com/swiftlang/swift-markdown.git\", branch: \"main\"),\n```\n\nAdd the dependency to any targets you've declared in your manifest:\n\n```swift\n.target(\n    name: \"MyTarget\", \n    dependencies: [\n        .product(name: \"Markdown\", package: \"swift-markdown\"),\n    ]\n),\n```\n\nTo parse a document, use `Document(parsing:)`, supplying a `String` or `URL`:\n\n```swift\nimport Markdown\n\nlet source = \"This is a markup *document*.\"\nlet document = Document(parsing: source)\nprint(document.debugDescription())\n// Document\n// └─ Paragraph\n//    ├─ Text \"This is a markup \"\n//    ├─ Emphasis\n//    │  └─ Text \"document\"\n//    └─ Text \".\"\n```\n\nPlease see Swift `Markdown`'s [documentation site](https://swiftlang.github.io/swift-markdown/documentation/markdown/)\nfor more detailed information about the library.\n\n## Contributing to Swift Markdown\n\nPlease see the [contributing guide](https://swift.org/contributing/#contributing-code) for more information.\n\n### Submitting a Bug Report\n\nSwift Markdown tracks all bug reports with [GitHub Issues](https://github.com/swiftlang/swift-markdown/issues).\nYou can use the \"Swift-Markdown\" component for issues and feature requests specific to Swift Markdown.\nWhen you submit a bug report we ask that you follow the\nSwift [Bug Reporting](https://swift.org/contributing/#reporting-bugs) guidelines\nand provide as many details as possible.\n\n### Submitting a Feature Request\n\nFor feature requests, please feel free to file a [GitHub issue](https://github.com/swiftlang/swift-markdown/issues/new)\nor start a discussion on the [Swift Forums](https://forums.swift.org/c/development/swift-docc).\n\nDon't hesitate to submit a feature request if you see a way\nSwift Markdown can be improved to better meet your needs.\n\n\n\n\u003c!-- Copyright (c) 2021-2023 Apple Inc and the Swift Project authors. All Rights Reserved. --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswiftlang%2Fswift-markdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fswiftlang%2Fswift-markdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswiftlang%2Fswift-markdown/lists"}