Xcode 27.1 Markdown 편집기 사용법은? 2026 학생 입문

README를 열었는데 별표와 기호가 그대로 보여서 문서가 잘못된 것처럼 느껴지나요?

판단: README를 읽거나 다듬는 목적이라면 Xcode 27.1의 Markdown 편집기를 활용할 수 있습니다. 다만 미리보기는 문서 표시를 확인할 뿐, 프로젝트 빌드나 앱 실행을 검증하지 않습니다. 과제에서 Mac이 필요한지는 제출물과 실행 요구사항으로 판단하세요.

이 안내는 Swift 또는 iOS 수업 프로젝트의 README를 처음 읽고 고치려는 학생을 위한 내용입니다.
Markdown을 처음 접했거나 Xcode 27.1에서 문서 미리보기를 찾는 학습자에게도 맞습니다.
수업에서 앱 빌드까지 요구하지만 쓸 수 있는 Mac이 없다면, 마지막 환경 선택 항목도 확인하세요.

마지막 업데이트: 2026년 10월 24일. 기능과 버전 정보는 Apple의 Xcode 27 출시 안내, Xcode 27 릴리스 노트, Xcode 시스템 요구사항에서 확인했습니다.

Xcode 27.1 Markdown 편집기의 역할

Markdown은 제목이나 목록 같은 표기를 일반 텍스트에 덧붙여 문서 구조를 만드는 형식입니다. 예를 들어 README에 # 프로젝트 안내라고 쓰면, 미리보기에서는 이를 제목처럼 읽을 수 있습니다. Xcode 27의 릴리스 안내에는 프로젝트 안의 Markdown 파일을 표시 형태로 보고 편집하며, Canvas에서 미리보는 기능이 소개되어 있습니다. Apple의 기능 설명을 기준으로 삼되, 화면의 세부 이름과 배치는 현재 설치된 버전에서 확인하세요.

이 기능은 README 같은 프로젝트 문서를 다루는 방법입니다. Swift 코드를 입력하거나 프로젝트를 실행하는 기능과는 목적이 다릅니다. Markdown 표기 규칙의 기본은 CommonMark 명세에서 확인할 수 있지만, 처음부터 문법 전체를 외울 필요는 없습니다.

README 읽기: 표시 화면과 프로젝트 파일

먼저 Xcode에서 수업 프로젝트를 열고 프로젝트 탐색기에서 README 또는 이름이 비슷한 Markdown 파일을 찾습니다. Apple의 프로젝트 파일 관리 안내는 프로젝트 안의 파일을 살펴보고 관리하는 기준을 설명합니다. 파일이 보이지 않는다면 프로젝트가 아니라 다른 폴더를 열었는지, 수업 저장소에 문서가 포함되어 있는지부터 확인하세요.

읽기와 편집 중 어느 화면을 쓸지 헷갈릴 때는 다음 기준으로 선택하면 됩니다.

Apple은 WWDC의 Xcode 소개에서도 Markdown 작업과 미리보기를 다룹니다. 다만 버전에 따라 화면 배치가 달라질 수 있습니다. 원하는 표시가 보이지 않으면 메뉴 이름을 추측해 변경하기보다 릴리스 안내와 현재 편집기 화면을 함께 대조하세요.

README 고치기: 원문과 결과 화면

과제에서 허용한다면 프로젝트가 무엇을 하는지, 어떤 순서로 실행을 시도하는지 README에 보탤 수 있습니다. 아래 예시는 문서의 원문입니다.

# 단어 카드 앱

단어를 저장하고 복습하는 수업 프로젝트입니다.

## 실행 안내

- 프로젝트를 Xcode에서 엽니다.
- 수업 안내에 따라 실행 방법을 확인합니다.

자세한 내용은 [과제 설명](https://example.com/course)을 참고하세요.

미리보기에서는 첫 줄이 제목으로 보이고, 실행 안내는 작은 제목 아래 목록으로 나타나야 합니다. 링크도 누를 수 있는 문서 링크로 표시되는지 확인합니다. 이 예시는 형식을 보여 주기 위한 것이므로, 실제 과제에서는 강의 자료나 저장소에 적힌 링크와 절차만 사용하세요. Markdown 명세는 제목, 목록, 링크 같은 표기가 어떻게 해석되는지 설명합니다.

원문은 문구와 기호를 수정할 때, 표시 형태는 독자가 읽게 될 결과를 확인할 때 편리합니다. 수정한 뒤 Canvas에서 제목 단계, 목록 간격, 링크와 코드 구역이 예상한 모습인지 살펴보세요. 공식 기능 설명에서 Canvas 미리보기를 언급하더라도, 현재 화면에서 보이는 이름이나 진입 방법은 설치된 Xcode의 안내를 우선해야 합니다.

주의: 미리보기에 README가 잘 나타나도 Swift 코드가 컴파일되었다는 뜻은 아닙니다. Xcode의 빌드 시스템은 프로젝트의 빌드 작업을 처리하며, 빌드 시스템 안내에 설명된 대상과 절차는 문서 미리보기와 별개입니다.

과제 제출 전 문서 점검

README를 고친 뒤에는 아래 순서로 변경 범위를 확인하세요. 수업에서 요구하지 않은 항목을 임의로 필수라고 판단하지 말고, 과제 설명과 저장소의 안내를 기준으로 삼습니다.

1. 수정한 파일이 수업 프로젝트 안의 README인지 확인합니다.
2. 프로젝트 소개와 실행 안내가 과제에서 요구하는 내용과 맞는지 대조합니다.
3. 표시 화면에서 제목 단계, 목록, 링크, 코드 구역이 읽기 쉬운지 살펴봅니다.
4. 파일을 저장한 뒤 원문을 다시 열어 의도한 문장이 남아 있는지 확인합니다.
5. 제출 전에 변경 내용을 검토하고, 과제에서 요구한 파일과 절차에 맞춰 제출합니다.

변경 사항은 다음처럼 확인할 수 있습니다. 아래 명령은 프로젝트 폴더에서 실행하며, Git 저장소로 관리하지 않는다면 사용할 수 없습니다.

git diff -- README.md

출력에는 README에서 바뀐 줄이 표시됩니다. 아무 내용도 나오지 않으면 파일이 저장되지 않았거나, 변경 대상의 이름이 다르거나, Git에서 추적하지 않는 파일일 수 있습니다. 무엇을 제출해야 하는지는 강의 안내와 프로젝트 저장소의 요구사항을 기준으로 판단하세요.

편집기 선택과 Mac 환경 판단

Markdown 문서 수정과 Apple 플랫폼 프로젝트 빌드는 서로 다른 작업입니다. 아래 비교로 필요한 환경을 먼저 가려 보세요.

Xcode 27.1을 사용할 수 있는 macOS 버전은 바뀔 수 있으므로 설치 전 Apple의 현재 시스템 요구사항을 확인하세요. 프로젝트에 여러 빌드 방식이 포함되었거나 실행 설정이 중요한 과제라면 빌드 구성 안내도 참고할 수 있습니다.

이전에 사용하던 Windows 도구로 문서를 고치는 것만으로 과제가 끝난다면, 굳이 Mac을 마련할 이유는 적습니다. 반면 수업에서 Xcode로 빌드하거나 실행하라고 했다면 문서 편집기만으로는 요구를 충족하지 못합니다. 개인 Mac을 사면 초기 지출과 관리 부담이 생기고, 학교 장비는 사용 시간이나 설치 권한이 제한될 수 있습니다. 원격 Mac은 네트워크 연결에 영향을 받으며, 물리 기기 연결이 필요한 실습에는 맞지 않을 수 있습니다.

먼저 Mac 환경 선택 기준 비교를 살펴보고 과제 요구와 대조하세요. 잠깐 Xcode 실습 환경이 필요하고 물리 장치 연결이 필수가 아니라면, OakVM의 원격 Mac을 대안으로 검토할 수 있습니다. 반대로 README 정리만 하거나 장기간 꾸준히 무거운 작업을 해야 한다면 현재 컴퓨터를 쓰거나 직접 Mac을 마련하는 편이 더 적합할 수 있습니다. 환경 요구가 불분명하다면 OakVM에 사용 가능 여부를 문의한 뒤 결정하세요.

자주 묻는 질문

Xcode 27.1에서 Markdown 파일을 열고 미리보려면 어떻게 하나요?
프로젝트 탐색기에서 README 같은 Markdown 파일을 찾아 엽니다. Xcode 27의 새 Markdown 편집기는 문서를 읽기 쉬운 표시 형태로 보여 주며, Canvas에서 미리보기를 확인할 수 있다고 Apple이 안내합니다. 화면 배치나 메뉴 이름은 설치된 버전과 편집기 상태에 따라 다를 수 있으므로, 보이지 않으면 공식 릴리스 설명과 현재 화면을 함께 확인하세요.

Xcode에서 README의 편집 화면과 원문은 어떻게 구분하나요?
표시 화면은 제목과 목록이 어떻게 읽히는지 확인할 때 편리하고, 원문은 별표나 대괄호 같은 Markdown 표기를 직접 고칠 때 적합합니다. Xcode 27의 안내에는 표시 형태로 문서를 편집하고 Canvas에서 미리보는 기능이 소개되어 있습니다. 실제 전환 위치는 현재 버전의 화면을 기준으로 확인하고, 편집 전후에는 원문을 다시 살펴보세요.

수업 프로젝트 README를 Xcode 27.1에서 직접 수정해도 되나요?
프로젝트 안의 Markdown 파일이 수정 가능하고 과제 규칙이 편집을 막지 않는다면, README에 프로젝트 설명이나 실행 안내를 보완할 수 있습니다. 다만 수업에서 요구하는 항목은 강의 안내와 저장소 설명을 먼저 따르세요. 수정 전에는 파일이 원래 프로젝트에 포함되어 있는지 확인하고, 제출하기 전에는 변경 내용을 검토해 의도하지 않은 코드나 문서까지 바뀌지 않았는지 확인하는 편이 안전합니다.

Markdown 미리보기와 파일 내용이 다르게 보일 때는 무엇을 확인하나요?
먼저 별표, 괄호, 대괄호처럼 Markdown 표기에 필요한 문자가 빠졌거나 짝이 맞지 않는지 확인합니다. 그다음 제목 표시, 목록 들여쓰기, 링크 주소, 코드 구역의 시작과 끝을 원문에서 점검하세요. 미리보기는 문서 표시 결과를 확인하는 기능이지 Swift 코드나 앱 실행 결과를 검증하지 않습니다. 저장한 파일을 다시 열어 확인하면 편집 내용과 미리보기 상태를 구분하기 쉽습니다.

자주 묻는 질문