Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/perfectlysoft/perfect-markdown

A solution to convert markdown text into html presentation in Swift, based on GerHobbelt's "upskirt" project.
https://github.com/perfectlysoft/perfect-markdown

html markdown swift

Last synced: 1 day ago
JSON representation

A solution to convert markdown text into html presentation in Swift, based on GerHobbelt's "upskirt" project.

Awesome Lists containing this project

README

        

# Perfect-Markdown [įŽ€äŊ“中文](README.zh_CN.md)



Get Involed with Perfect!



Star Perfect On Github


Stack Overflow


Follow Perfect on Twitter


Join the Perfect Slack



Swift 4.1


Platforms OS X | Linux


License Apache


PerfectlySoft Twitter


Slack Status

This project provides a solution to convert markdown text into html presentations.

This package builds with Swift Package Manager and is part of the [Perfect](https://github.com/PerfectlySoft/Perfect) project but can also be used as an independent module.

## Acknowledgement

Perfect-Markdown is directly building on [GerHobbelt's "upskirt"](https://github.com/GerHobbelt/upskirt) project.

## Swift Package Manager

Add dependencies to your Package.swift

``` swift
.package(url: "https://github.com/PerfectlySoft/Perfect-Markdown.git",
from: "3.0.0")

// on target section:
.target(
// name: "your project name",
dependencies: ["PerfectMarkdown"]),
```

## Import Perfect Markdown Library

Add the following header to your swift source code:

``` swift
import PerfectMarkdown
```

## Get HTML from Markdown Text

Once imported, a new String extension `markdownToHTML` would be available:

```
let markdown = "# some blah blah blah markdown text \n\n## with mojo 🇨đŸ‡ŗ 🇨đŸ‡Ļ"

guard let html = markdown.markdownToHTML else {
// conversion failed
}//end guard

print(html)
```

## Further Information
For more information on the Perfect project, please visit [perfect.org](http://perfect.org).