Apart from all the large options reminiscent of AsyncImage and searchable, the iOS 15 SDK additionally launched some minor enhancements to streamline the event of iOS apps. On this tutorial, we’ll present you the best way to use Markdown in SwiftUI’s Textual content view.
What’s Markdown
I assume you’ve used Markdown earlier than, however in case in case you have no thought what it’s, let me offer you a fast walkthrough. Created by John Gruber, Markdown is a light-weight markup language for including formatting to a plain textual content doc. Most significantly, it lets you simply flip the formatted textual content into an HTML net web page (or different varieties of paperwork). I’ve used Markdown for years to jot down my programming books. Due to its plain textual content nature, you don’t want any particular instruments to jot down Markdown, only a plain textual content editor is sweet sufficient.
Markdown is lifeless easy to study and use. Let me present you a couple of examples. To daring some textual content, all you could do is enclose the textual content in double asterisks (**):
Equally, to make the textual content italic, you utilize a single asterisk like this:
You possibly can cross the textual content like this:
To format the textual content as a heading, you write the Markdown syntax like this:
|
# Heading 1 (Largest) ## Heading 2 ### Heading 3 #### Heading 4 ##### Heading 5 ###### Heading 6 (Smallest) |
To focus on a command or a line of code, you possibly can enclose the textual content with single backticks. Right here is an instance:
|
To present all processess working on macOS, you can sort `ps aux` in Terminal. |
You possibly can simply embed hyperlinks in a doc by wrapping hyperlink textual content in sq. brackets (i.e. []) after which specify the URL inside parentheses. Right here is an instance:
|
The tutorial is offered by [AppCoda](https://www.appcoda.com). |
When the textual content is rendered in HTML, it can present a hyperlink.
The above are only a few examples of the Markdown syntax. For particulars, you possibly can confer with this doc on GitHub.
Utilizing Markdown in SwiftUI
I consider you need to have some concepts about Markdown. So, how are you going to use Markdown in SwiftUI growth? Ranging from iOS 15, SwiftUI comes with built-in assist for this markup language. You possibly can simply format textual content utilizing Markdown with the Textual content view.
To do this, all you could do is move the Textual content view with textual content in Markdown syntax. Here’s a pattern code snippet:
|
VStack(alignment: .main) { Textual content(“**Textual content in daring**”) Textual content(“*Textual content in italic*”) Textual content(“~This textual content is crossed out~”) Textual content(“`This line of code`”) Textual content(“You possibly can [click this link](https://www.appcoda.com) to go to the web site.”) } |
Should you enter the code in your SwiftUI undertaking, Xcode will mechanically format the textual content.
After all, you possibly can format a paragraph of textual content utilizing Markdown. Right here is one other instance:
Working with AttributedString
AttributedString in iOS 15, which is the Swift model of NSAttributedString, additionally has a built-in assist of Markdown. To create an attributed string in Markdown, you write the code like this:
|
do { var textual content = var textual content = strive AttributedString(markdown: “**This textual content is daring**”) } catch { print(“Didn’t create the attributed textual content”) } |
And, you possibly can combine Markdown and apply your most well-liked styling to the textual content. Right here is an instance that highlights some textual content with numerous colours:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
var attributedString: AttributedString = { do { var textual content = strive AttributedString(markdown: “`SwiftUI` has advanced a lot in these two years. **Apple has packed much more options and introduced extra UI parts to the `SwiftUI` framework**, which comes alongside with *Xcode 13*. It simply takes UI growth on iOS, iPadOS, and macOS to the **subsequent stage**.”)
if let vary = textual content.vary(of: “Apple”) { textual content[range].backgroundColor = .yellow }
if let vary = textual content.vary(of: “iPadOS”) { textual content[range].backgroundColor = .purple textual content[range].foregroundColor = .white }
return textual content
} catch { return “” } }() |
SwiftUI’s textual content part has a built-in assist for AttributedString. You possibly can merely move it to the Textual content view for rendering.
Present Limitations
The present model of Swift doesn’t assist all of the Markdown syntax. For instance, it may possibly’t render heading, numbered checklist, and picture. Hopefully, Apple will present additional enchancment in future updates of SwiftUI.
Founding father of AppCoda. Writer of a number of iOS programming books together with Starting iOS Programming with Swift and Mastering SwiftUI. iOS App Developer and Blogger. Comply with me at Fb, Twitter and Google+.
