CDMarkdownKit

This Swift framework handles standard markdown parsing along with the ability to parse custom elements.

For a demonstration of the capabilities of CDMarkdownKit; run the iOS Example project after cloning the repo.

• Features
• Requirements
• Installation
• Usage
  • Initialization
  • Customization
  • Supported Markdown Elements
  • CDMarkdownTextView
  • CDMarkdownLabel
• License

---

Pre-Release Software

This framework is currently in development. As of release 0.9.0 the code is stable and in a usable state to install in applications. But be aware that breaking changes may occur until 1.0.0 is released.

---

Features

• Markdown Parsing
  • Italic
  • Bold
  • Header
  • Quote
  • List
  • Code
  • Syntax
  • Link
  • Image
• UITextView With Markdown Formatting
• UILabel With Markdown Formatting
• Documentation

---

Requirements

• iOS 8.0+
• Xcode 8.1+
• Swift 3.0+

---

Installation

Installation via CocoaPods

CDMarkdownKit is available through CocoaPods. CocoaPods is a dependency manager that automates and simplifies the process of using 3rd-party libraries like CDMarkdownKit in your projects. You can install CocoaPods with the following command:

gem install cocoapods

To integrate CDMarkdownKit into your Xcode project using CocoaPods, simply add the following line to your Podfile:

# use this line to install CDMarkdownKit while in development
pod "CDMarkdownKit", :git => "https://github.com/chrisdhaan/CDMarkdownKit"
# this line will eventually be used upon the 1.0.0 release of CDMarkdownKit and can be disregarded for now
pod "CDMarkdownKit" "~> 1.0.0"

Afterwards, run the following command:

pod install

Installation via Carthage

CDMarkdownKit is available through Carthage. Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage via Homebrew with the following commands:

brew update
brew install carthage

To integrate CDMarkdownKit into your Xcode project using Carthage, simply add the following line to your Cartfile:

# use this line to install CDMarkdownKit while in development
github "chrisdhaan/CDMarkdownKit"
# this line will eventually be used upon the 1.0.0 release of CDMarkdownKit and can be disregarded for now
github "chrisdhaan/CDMarkdownKit" ~> 1.0.0

Afterwards, run the following command:

carthage update

Next, add the built CDMarkdownKit.framework into your Xcode project.

Installation via Swift Package Manager

CDMarkdownKit is available through the Swift Package Manager. The Swift Package Manager is a tool for automating the distribution of Swift code.

The Swift Package Manager is in early development, but CDMarkdownKit does support its use on supported platforms. Until the Swift Package Manager supports non-host platforms, it is recommended to use CocoaPods, Carthage, or Git Submodules to build iOS, watchOS, and tvOS apps.

The Swift Package Manager is integrated into the Swift compiler.

To integrate CDMarkdownKit into your Xcode project using The Swift Package Manager, simply add the following line to your Package.swift file:

dependencies: [
    .Package(url: "https://github.com/chrisdhaan/CDMarkdownKit.git", majorVersion: 1)
]

Afterwards, run the following command:

swift package fetch

Installation via Git Submodule

CDMarkdownKit is available through Git Submodule Git Submodule allows you to keep another Git repository in a subdirectory of your repository.

If your project is not initialized as a git repository, navigate into your top-level project directory, and install Git Submodule with the following command:

git init

To integrate CDMarkdownKit into your Xcode project using Git Submodule, simply run the following command:

git submodule add https://github.com/chrisdhaan/CDMarkdownKit.git

Afterwards, open the new CDMarkdownKit folder, and drag the CDMarkdownKit.xcodeproj into the Project Navigator of your Xcode project. A common location for the CDMarkdownKit.xcodeproj is directly below the Products folder.

Next, select your application project in the Project Navigator to navigate to the target configuration window and select the application target under the Targets heading in the sidebar. In the tab bar at the top of that window, open the General panel. Click on the + button under the Embedded Binaries section. You will see two different CDMarkdownKit.xcodeproj folders, each with a version of the CDMarkdownKit.framework nested inside a Products folder. It does not matter which Products folder you choose from, select the CDMarkdownKit.framework for iOS.

---

Usage

Initialization

// Create parser
let markdownParser = CDMarkdownParser()
// Parse markdown
let markdown = "This *framework* helps **with** parsing `markdown`."
label.attributedText = markdownParser.parse(markdown)

Customization

// Create parser
let markdownParser = CDMarkdownParser(font: UIFont(name: "HelveticaNeue", size: 16),
boldFont: UIFont(name: "HelveticaNeue-Bold", size: 16),
italicFont: UIFont(name: "HelveticaNeue-Thin", size: 16),
fontColor: UIColor.darkGray,
backgroundColor: UIColor.lightGray)
// Customize elements
/// Bold
markdownParser.bold.color = UIColor.cyan
markdownParser.bold.backgroundColor = UIColor.purple
/// Header
markdownParser.header.color = UIColor.black
markdownParser.header.backgroundColor = UIColor.orange
/// List
markdownParser.list.color = UIColor.black
markdownParser.list.backgroundColor = UIColor.red
/// Quote
markdownParser.quote.color = UIColor.gray
markdownParser.quote.backgroundColor = UIColor.clear
/// Link
markdownParser.link.color = UIColor.blue
markdownParser.link.backgroundColor = UIColor.green
markdownParser.automaticLink.color = UIColor.blue
markdownParser.automaticLink.backgroundColor = UIColor.green
/// Italic
markdownParser.italic.color = UIColor.gray
markdownParser.italic.backgroundColor = UIColor.clear
/// Code
markdownParser.code.font = UIFont.systemFont(ofSize: 17)
markdownParser.code.color = UIColor.red
markdownParser.code.backgroundColor = UIColor.black
/// Syntax
markdownParser.syntax.font = UIFont.systemFont(ofSize: 15)
markdownParser.syntax.color = UIColor.lightGray
markdownParser.syntax.backgroundColor = UIColor.black
// Parse markdown
let markdown = "This *framework* helps **with** parsing `markdown`."
label.attributedText = markdownParser.parse(markdown)

Supported Markdown Elements

*italic* or _italic_
**bold** or __bold__

# Header 1
## Header 2
### Header 3
#### Header 4
##### Header 5
###### Header 6

> Quote

* List
- List
+ List

`code`

```syntax```

[Link](url)
![Image](url)

CDMarkdownTextView

It is recommended that any CDMarkdownTextView objects be initialized programmatically as it uses custom text drawing objects to render attributed strings.

A CDMarkdownTextView object will still render when initialized via a storyboard but the default behavior for the following properties will be overridden:

• isScrollEnabled = true
• isSelectable = false
• isEditable = false

These defaults are set to avoid crashes. There still may be unforeseen crashes that occur when initializing a CDMarkdownTextView object via a storyboard.

Programmatic Example

let size = self.frame.size
let rect = CGRect(x: 10, 
y: 10, 
width: CGFloat(size.width - 20), 
height: CGFloat(size.height - 20))
/// Create custom text container
let textContainer = NSTextContainer(size: size)
/// Create custom layout manager
let layoutManager = CDMarkdownLayoutManager()
layoutManager.addTextContainer(textContainer)
/// Initialization
let textView = CDMarkdownTextView(frame: rect, 
textContainer: textContainer, 
layoutManager: layoutManager)
textView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
/// Standard markdown UI formatting
textView.roundCodeCorners = true
textView.roundSyntaxCorners = true
/// Custom markdown UI formatting
textView.roundAllCorners = true

self.view.addSubview(textView)

Storyboard Example

/// Initialization
@IBOutlet fileprivate weak var textView: CDMarkdownTextView!
/// Standard markdown UI formatting
self.textView.roundCodeCorners = true
self.textView.roundSyntaxCorners = true
/// Custom markdown UI formatting
self.textView.roundAllCorners = true

CDMarkdownLabel

Programmatic Example

let size = self.frame.size
let rect = CGRect(x: 10, 
y: 10, 
width: CGFloat(size.width - 20), 
height: CGFloat(size.height - 20))
/// Initialization
let label = CDMarkdownLabel(frame: rect)
label.autoresizingMask = [.flexibleWidth, .flexibleHeight]
/// Standard markdown UI formatting
label.roundCodeCorners = true
label.roundSyntaxCorners = true
/// Custom markdown UI formatting
label.roundAllCorners = true

self.view.addSubview(label)

Storyboard Example

/// Initialization
@IBOutlet fileprivate weak var label: CDMarkdownLabel!
/// Standard markdown UI formatting
self.label.roundCodeCorners = true
self.label.roundSyntaxCorners = true
/// Custom markdown UI formatting
self.label.roundAllCorners = true

---

Author

Christopher de Haan, [email protected]

Credits

CDMarkdownKit was influenced by MarkdownKit, a markdown parsing library developed by Ivan Bruel.

CDMarkdownKit adds the following functionalities:

• Fixed header element parsing
• Image element parsing
• Ability to customize font for all elements
• Ability to customize color for all elements
• Ability to customize background color for all elements
• UITextView with the ability to round background text color corners for code, syntax, or all elements
• UILabel with the ability to round background text color corners for code, syntax, or all elements

License

CDMarkdownKit is available under the MIT license. See the LICENSE file for more info.

---