일반 OCR이 코드를 망가뜨리는 이유
일반적인 텍스트 인식은 글을 읽도록 만들어졌습니다. 줄 앞의 공백을 잡음으로 여기고, 이어지는 것처럼 보이는 줄을 하나로 합치며, 보이는 따옴표를 그대로 넘깁니다. 문단이라면 괜찮지만 코드에서는 문제가 됩니다. Python은 들여쓰기가 사라지면 실행되지 않고, YAML은 의미가 달라지며, 발표 슬라이드에서 복사한 둥근 따옴표 하나 때문에 문자열이 문법 오류로 바뀝니다.
코드 모드는 이미지를 다르게 읽습니다.
- 들여쓰기와 공백을 줄마다 유지하므로 중첩된 블록이 그대로 중첩된 채 나옵니다.
- 둥근 따옴표를 곧은 따옴표로 바꾸므로
“hello”와‘a’가"hello"와'a'로 돌아옵니다. - 언어를 알아보면 이름을 알려 줍니다. 예를 들어 “Python 코드 스크린샷으로 보입니다”라는 라벨이 뜨는데, 이미지에 맞는 모드라는 신호이기도 합니다.
Markdown 파일로 다운로드하면 코드가 코드 블록(펜스) 안에 들어가므로 README, 위키 페이지, 노트에 바로 넣을 수 있습니다.
다크 테마와 색이 들어간 구문
요즘 에디터와 터미널은 대부분 다크 테마를 쓰지만, OCR 엔진은 밝은 배경 위의 어두운 글자를 가장 잘 읽습니다. 자동 보정은 어두운 배경 위의 밝은 글자를 감지해 인식 전에 반전하므로, 다크 모드 스크린샷이라도 따로 손볼 필요가 없습니다.
색이 들어간 구문도 대개 문제없습니다. 가장 약한 부분은 테마에서 대비가 낮은 곳, 예를 들어 짙은 회색 배경 위의 회색 주석이나 흐릿한 공백 표시입니다. 이런 부분이 깨져 나온다면 조정에서 회색조를 켜고 대비를 조금 높인 뒤, 보정본 표시로 바꿔 빠진 내용이 없는지 확인하세요.
다시 확인해야 할 문자
코딩용 글꼴 중에는 거의 똑같이 생긴 문자가 많고, 스크린샷이 작으면 더 헷갈립니다. 자주 틀리는 문자는 다음과 같습니다.
- 0과 O. 특히 변수 이름과 16진수 값 안에서
- 1, l, I. 글꼴에 따라 픽셀 하나 차이밖에 나지 않습니다
- 괄호.
{와(,]와), 그리고 제네릭과 HTML 태그의 꺾쇠괄호 - 문장 부호.
;와:,,와., 그리고 곧은 따옴표로 읽힌 백틱 - 붙어 보이는 글자.
rn이m으로,cl이d로 읽히는 경우 - 밑줄.
user_id같은 이름에서 사라지거나 공백으로 바뀌는 경우
합자(ligature)를 지원하는 에디터 글꼴은 !=, =>, >=를 기호 하나로 그리기 때문에 입력한 문자 그대로 읽히지 않을 수 있습니다. 내 에디터에서 찍는 스크린샷이라면 캡처하기 전에 합자를 끄세요.
가장 빠른 확인 방법은 린터나 컴파일러가 있는 에디터에 코드를 붙여 넣는 것입니다. 짝이 맞지 않는 괄호나 엉뚱한 문자가 몇 초 만에 드러납니다.
Python과 YAML의 들여쓰기 확인하기
들여쓰기가 의미를 갖는 언어에서는 한 단계 어긋난 줄이 실행은 되더라도 다른 동작을 할 수 있습니다. 린터가 항상 잡아내지는 못하므로 반복문의 본문이나 설정 파일의 중첩된 키처럼 중요한 블록은 스크린샷과 중첩 구조를 비교해 보세요.
결과에서 한 줄을 클릭하면 이미지에서 그 줄의 위치가 표시되므로, 줄이 실제로 어디서 시작했는지 빠르게 확인할 수 있습니다. 블록 전체가 밀려 있다면 한 줄씩 고치기보다 에디터에서 블록 들여쓰기로 한 번에 고치는 편이 대개 빠릅니다.
더 깔끔한 스크린샷 찍기
나중에 문자를 하나하나 고치는 것보다 스크린샷을 다시 찍는 편이 더 나은 결과를 주는 경우가 많습니다.
- 캡처하기 전에 확대하세요. 글자가 클수록 글자당 픽셀이 많아지고, 특히 문장 부호에서 효과가 큽니다.
- 코드만 캡처하세요. 사이드바, 탭, 미니맵은 빼야 코드 줄에 다른 내용이 섞이지 않습니다.
- 자동 줄바꿈을 끄세요. 에디터에서 두 줄로 접힌 긴 줄은 두 줄로 읽힙니다.
- 탭과 공백에 주의하세요. 이미지로는 원본이 어느 쪽을 썼는지 알 수 없으므로, 프로젝트에서 탭을 쓴다면 붙여 넣은 뒤 포매터를 실행하세요.
채팅이나 오류 대화 상자 같은 일반 스크린샷은 스크린샷 텍스트 추출 페이지와 스크린샷에서 텍스트를 추출하는 방법 가이드에서 기본을 다룹니다. 코드가 긴 문서 페이지의 일부라면 이미지 Markdown 변환에서 글과 코드를 별도의 스크린샷으로 나누는 방법을 확인하세요.