How to Xcode Markup Formatting in Playground

코딩을 하다보면, 주석이나 설명을 달 때가 많다.
Xcode 에서 주석이나 마크업을 깔끔하게 작성한 예시는 이렇다.
아래 코드는 closures 예제코드이다.

//: [Previous](@previous)
/*:
## 클로징이 그 언어의 일등 시민이라는 것은 무엇을 의미하는가?
*/
import UIKit
import PlaygroundSupport
//: Assign to a var or constant
//: 변수나 상수로 할당
let f = { (x:Int-> Int in
    return x + 32
}
let v = { (x:Int-> Int in
    return x + 20
}
/*:
Closure에도 유형이 있습니다! 오른쪽의 *결과 사이드바*를 보면 알 수 있습니다.\
위의 closure 유형은 ```Int -> Int```\
```Int``` 를 취하고 ```Int``` 를 반환하는 것임을 알 수 있습니다.
*/
 
f(0)
f(1)
 
/*:
EXERCISE: Create an array with two closures, one that takes 2 integers and returns the sum as
another integer, and one that takes two floats and returns the sum as a float.
Will it compile? Why?
*/
// a, b : Int
let sum = {(x: Int, y: Intin x + y}
sum(1,3)
//: - Callout(Data type is different): Error!
sum(1.23)
//: [Next](@next)

Heading은 //: # 제목 ,# 를 추가해서 Heading 1,2,3,4를 만들 수 있다.
텍스트는 한 줄일 때, //: 줄이 늘어날때, /*: */ 넣으면 된다.
경고 텍스트는 //: - Callout(내용): 부연설명 이렇게 만든다.

  • 작성한 뒤, Xcode 메뉴에서 [Editor] - [Show Raw Markup] 마크업 포맷이 변경된다.

변경된 Markup 포맷1
변경된 Markup 포맷 A
변경된 Markup 포맷2
변경된 Markup 포맷 B


참고 링크

Xcode Markup Formatting Reference - Apple