본문으로 건너뛰기

사용 가이드

Mac의 GitHub 이슈에서 받아쓰기

이슈 본문은 공개되고 사람들에게 알림이 갑니다. 그래서 GitHub는 잘못 받아 적힌 단어에 독자가 생기는 유일한 텍스트 상자입니다.

마지막 업데이트: 2026-08-29

이슈 본문은 글입니다. 무엇이 고장 났는지, 무엇을 기대했는지, 무엇을 봤는지를 적습니다. 받아쓰기가 잘 맞습니다. 다만 GitHub의 댓글 상자는 플랫폼의 다른 기능과 연결되어 있어서, 말로 한 문자 두 개가 텍스트 밖에서 결과를 만듭니다.

GitHub만의 함정: 받아쓴 'at'이 누군가에게 알림을 보냅니다

이슈 본문에서 "@"를 입력하면 사용자 멘션 자동 완성이 열립니다. 이메일 주소나 핸들을 받아쓰거나 "at the same time" 같은 표현을 말하다가 "at"이라고 하면, 텍스트 위로 선택창이 열립니다. 더 나쁜 경우는 다음에 받아쓴 단어가 우연히 사용자 이름과 일치하는데 Return을 누르는 것입니다. 그러면 GitHub가 실제 멘션을 삽입합니다. 그 멘션을 게시하면 모르는 사람에게 알림이 가고, 그 사람의 받은 편지함에 내 버그 리포트가 도착합니다.

  • 받아쓰기를 이어 가기 전에 Esc를 눌러 선택창을 닫으세요.
  • 제출하기 전에 미리보기에서 의도하지 않은 파란색 @ 링크가 있는지 확인하세요. 미리보기 탭은 멘션을 링크로 표시하므로 찾기 쉽습니다.
  • 받아쓴 "hash"나 "number sign"도 마찬가지입니다. 이슈 및 풀 리퀘스트 선택창이 열려 관련 없는 이슈에 교차 링크가 걸릴 수 있습니다.

두 번째 함정: Command+Return을 누르면 제출됩니다

Command+Return은 댓글을 게시합니다. Command 기반의 받아쓰기 단축키를 쓰면 반쯤 받아쓴 이슈가 공개 저장소에 제출될 수 있습니다. 받아쓰기를 Command가 들어가지 않는 키에 지정하거나, 임시 파일에 초안을 쓴 뒤 붙여 넣으세요.

이슈 받아쓰기

  1. 받아쓰기를 한 번 켭니다: 시스템 설정 → 키보드 → 받아쓰기. 자세한 단계는 macOS에서 받아쓰기 켜기에 있습니다.
  2. 새 이슈 양식을 열고 본문 입력란을 클릭합니다. 제목은 별도의 입력란이며 음성으로 이동할 수 없습니다.
  3. 아래 구조를 사용해 글을 한 번에 받아씁니다.
  4. 멈춘 뒤, 음성이 틀리기 쉬운 부분은 직접 입력합니다. 파일 경로, 식별자, 버전 문자열, 코드 블록에 들어갈 내용입니다.
  5. 미리보기 탭을 열어 제출하기 전에 읽어 봅니다.

깔끔하게 받아쓸 수 있는 구조

받아쓰기는 말하는 동안 머릿속에 담을 수 있는 틀에서 잘 됩니다. 이 구조는 편집 단계 전까지 서식이 필요 없습니다.

  1. 무엇이 고장 났는지 한 문장.
  2. 단계를 순서대로 말하기: 먼저, 그다음, 그다음.
  3. 기대한 것, 그리고 실제로 일어난 것. 두 문장.
  4. 환경: OS 버전, 앱 버전, 브라우저.
  5. 이미 배제한 원인. 리뷰어가 가장 중요하게 여기는 부분이지만 타이핑할 때는 흔히 빠뜨립니다.

아무것도 입력되지 않을 때

  • GitHub는 브라우저에서 실행되므로 마이크 권한은 브라우저와 받아쓰기 도구에 있으며, 시스템 설정 → 개인 정보 보호 및 보안 → 마이크에서 확인합니다.
  • 포커스가 댓글 상자를 벗어나면 GitHub 자체의 한 글자 단축키가 작동해, 받아쓴 글자가 화면 이동을 일으키기 시작합니다.
  • GitHub만이 아니라 어디서도 받아쓰기가 되지 않을 때: Mac에서 받아쓰기가 동작하지 않을 때.

편집기와 브라우저에서 쓰는 하나의 단축키

Voice Type은 키 입력을 흘려 보내는 대신 키를 놓을 때 완성된 텍스트를 입력하므로, 멘션 선택창과 이슈 선택창이 문장 중간에 열리지 않습니다. 버그를 발견한 편집기에서도 같은 단축키를 그대로 쓸 수 있습니다: Mac용 음성 입력.

더 알아보기

출처

Voice Type 사용해 보기 (7일 무료 체험)

실제 업무로 써 보세요

Voice Type은 macOS용 기기 내 받아쓰기입니다. 단축키를 누르고 말하면 입력 중인 앱에 텍스트가 들어갑니다. 음성은 Mac 밖으로 나가지 않습니다. 7일 무료, 이후 19.99달러(USD) 한 번 결제 로 Mac App Store에서 구매합니다. 구독도 계정도 필요 없습니다.

무료 체험 시작