作为一个开发人员,日常经常会需要编写各种各样的文档/材料之类的,个人非常喜欢用 Markdown 来完成这些工作,Markdown 的优点就不再赘述了,大家应该都有过了解,不过目前 iOS 原生并没有提供任何对 Markdown 的支持。所以最近基于 cmark-gfm 把 Markdown 转 HTML 的功能封装了一遍,并且在原有基础上添加了对列表 table 的支持,同时采用 WKWebView 做了一个可直接展示 Markdown 的 View,方便以后使用,现已开源到 GitHub 基于 WTFPL 协议进行分发,需要的同学可以自取。
项目地址:https://github.com/EyreFree/EFMarkdown
EFMarkdown - 一个轻量级的 Markdown 库,可以用来将 Markdown 转为 HTML,开题报告,开题报告,也可以用来直接展示 Markdown 对其进行预览。
English Introduction
预览sample1sample2sample3sample4示例
采用 git clone 命令下载本仓库;
采用 cd 命令切换到 Example 目录下,执行 pod install 命令;
随后打开 EFMarkdown.xcworkspace 编译即可。
或执行以下命令:
git clone git@github.com:EyreFree/EFMarkdown.git; cd EFMarkdown/Example; pod install; open EFMarkdown.xcworkspace环境XCode 8.0+
Swift 3.0+
安装EFMarkdown 可以通过 CocoaPods 进行获取。只需要在你的 Podfile 中添加如下代码就能实现引入:
pod 'EFMarkdown'使用1. 将 Markdown 转为 HTML你可以采用 EFMarkdown 轻松实现 Markdown 字符串到 HTML 字符串地转换,示例代码如下:
let markdown = '# Hello' var html = '' do { html = try EFMarkdown().markdownToHTML(markdown, options: EFMarkdownOptions.safe) print(html) // 这里会输出 '<h1>Hello</h1>\n' } catch let error as NSError { print ('Error: \(error.domain)') }2. 对 Markdown 进行预览你可以采用 EFMarkdownView 实现对 Markdown 字符串的预览,示例代码如下:
let screenSize = UIScreen.main.bounds let markView = EFMarkdownView() markView.frame = CGRect(x: 0, y: 20, width: screenSize.width, height: screenSize.height - 20) self.view.addSubview(markView) markView.load(markdown: testMarkdownFileContent(), options: [.default]) { [weak self] (_, _) in if let _ = self { // 可选:你可以通过在此处传入一个百分比来改变字体大小 markView.setFontSize(percent: 128) printLog('load finish!') } }3. 选项你可以通过传入不同的选项来控制底层 cmark 对 Markdown 字符串的处理,默认传入的值为 safe。
可选的值有以下这些:
default
sourcePos
hardBreaks
safe
noBreaks
validateUTF8
smart
githubPreLang
liberalHtmlTag
更多关于这些选项的信息,可以参考 cmark。
作者EyreFree, eyrefree@eyrefree.org
协议