사쿠라에디터 실무 가이드
사쿠라에디터 아웃라인 추출: 규칙, 탐색, 텍스트 출력
사쿠라에디터의 아웃라인 추출은 제목, 함수, 라벨을 트리로 만들고 해당 줄로 이동하게 합니다. 먼저 파일 형식과 적용 중인 아웃라인 규칙을 확인하세요. 아웃라인은 화면 탐색이고 태그 점프 목록은 키워드 검색이며, 어느 목록을 저장하는 일도 별도의 작업입니다.
업데이트: 2026-10-18
결론: 구조는 아웃라인, 검색은 태그 점프, 출력은 별도 확인
아웃라인 추출을 찾는 사용자는 탐색 가능한 트리나 제목·행 번호 목록을 원할 수 있습니다. 아웃라인 분석은 편집기 안에서 계층을 보여 주고, 키워드 태그 점프는 일치하는 위치를 보여 줍니다. Markdown이나 CSV가 자동으로 만들어진다고 가정하지 말고 원하는 출력 형식을 먼저 정한 뒤 복사, 매크로, 외부 처리를 선택하세요.
| 목적 | 먼저 사용할 기능 | 판단 기준 |
|---|---|---|
| 문서 구조를 훑기 | 아웃라인 / 토픽 트리 | 제목이나 함수를 계층으로 보고 싶을 때 |
| 정의나 라벨로 이동 | 키워드 태그 점프 | 종류, 행, 파일 정보가 필요할 때 |
| 목록을 다른 파일에 저장 | 복사, 매크로, 외부 처리 | 출력 형식을 통제해야 할 때 |
| 빈 트리 원인 찾기 | 파일 형식과 규칙 파일 | 확장자, 형식, 규칙, 샘플 순으로 확인 |
아웃라인 추출과 태그 점프의 차이
아웃라인은 현재 문서의 두 번째 보기입니다. 제목, 함수, 라벨, 로그 구간을 트리로 보여 주고 항목을 선택하면 원래 줄로 이동합니다. 탐색 방법을 바꾸는 기능이며 문서를 다시 쓰거나 텍스트 파일을 자동 생성하지는 않습니다.
키워드 태그 점프 목록은 검색 결과입니다. 키워드, 종류, 행 번호, 파일 이름을 보고 원하는 위치를 엽니다. 공식 도움말에서도 태그 점프는 계층형 아웃라인을 만드는 기능과 다르게 설명합니다. 문서 지도를 볼 때는 아웃라인, 정의나 라벨을 찾을 때는 태그 점프를 선택하세요.
| 비교 | 아웃라인 | 태그 점프 목록 |
|---|---|---|
| 입력 | 열린 문서와 형식별 규칙 | 키워드와 태그 검색 조건 |
| 표시 | 중첩 트리 | 종류·행·파일이 있는 행 목록 |
| 적합한 작업 | 제목, 함수, 장 구조 | 정의, 라벨, 특정 용어 |
| 저장 | 표시와 저장은 별도 | 행을 선택하거나 복사 |
먼저 파일 형식과 아웃라인 규칙 확인하기
아웃라인이 비어 있으면 바로 규칙 파일을 고치지 말고 현재 문서에 적용된 타입별 설정부터 확인하세요. 확장자가 다르거나 일반 텍스트 타입으로 남아 있거나 언어 규칙이 없으면 빈 트리가 될 수 있습니다. 제목이나 함수를 두세 개만 넣은 작은 복사본으로 문제를 재현하는 것이 안전합니다.
공식 도움말은 파일 형식별 키워드, 색상, 아웃라인 규칙을 사용합니다. C++ 함수 규칙이 Markdown 제목을 자동으로 이해하지는 않습니다. 다른 PC로 옮기기 전에 확장자, 선택한 타입, 규칙 이름을 기록하세요.
- 1. 작은 복사본 만들기실제 문서 대신 목표 줄이 몇 개만 있는 샘플을 사용합니다.
- 2. 타입 맞추기확장자와 타입별 설정이 언어 또는 문서 종류와 맞는지 봅니다.
- 3. 보기 열기아웃라인 또는 토픽 트리를 표시하고 노드가 생기는지 확인합니다.
- 4. 규칙 기록하기사용된 규칙 이름과 위치를 적은 뒤 사용자 규칙을 추가합니다.
규칙 파일로 아웃라인 항목 조정하기
기본 규칙이 필요한 항목을 찾지 못하면 파일 형식과 적용 타입을 확인하세요. 규칙은 어떤 줄을 제목·함수·라벨로 볼지 결정하며 문서를 편집하는 매크로와는 다릅니다. 기존 예제를 복사해 수정하고 원본을 되돌릴 수 있게 보관하세요.
패턴을 한 번에 하나씩 추가하고 계층, 표시 이름, 이동 행을 확인합니다. 너무 넓은 표현식은 엉뚱한 줄을 잡거나 분석을 느리게 할 수 있습니다. 규칙 파일 위치와 적용 타입을 설정 백업과 함께 기록하세요.
[outline-rule]
name=제목
pattern=^#{1,6}\s+(.+)$
level=1
제목·함수·라벨이 있는 작은 샘플
맞는 타입에 하나의 패턴 적용
계층과 이동 위치를 함께 확인
아웃라인 목록을 텍스트로 출력한다는 뜻
아웃라인 목록 텍스트 출력이라는 검색어에는 화면 캡처, 제목 복사, 행 번호가 있는 보고서가 섞여 있습니다. 아웃라인 화면이 Markdown이나 CSV를 자동으로 만든다고 가정하지 마세요. 선택 가능한 범위, 태그 점프 행 복사, 매크로는 서로 다른 결과를 만들 수 있습니다.
한 번 기록하는 목적이면 캡처나 수동 복사로 충분할 수 있습니다. 반복 목록이 필요하면 문법을 정하고 매크로나 스크립트로 추출한 뒤 원본 복사본과 차이를 확인하세요. 편집 후 행 번호가 바뀌므로 생성일과 파일 버전도 함께 남깁니다.
| 필요한 출력 | 실용적인 방법 | 주의점 |
|---|---|---|
| 시각적 구조 | 아웃라인 화면 또는 캡처 | 저장된 텍스트 트리가 아님 |
| 제목만 | 선택, 검색, 매크로 | 계층과 중복 확인 |
| 위치가 있는 행 | 태그 점프 행 복사 | 편집 뒤 행 번호가 낡음 |
| 반복 보고서 | 고정 규칙과 외부 스크립트 | 인코딩·줄바꿈·버전 기록 |
아웃라인이 비거나 내용이 다를 때
트리가 비어 있으면 확장자와 타입, 규칙 파일 위치, 대상 줄의 문법 순서로 확인합니다. 제목은 보이는데 함수가 안 보이면 함수 문법이 기본 패턴 밖에 있거나 잘못된 언어 타입일 수 있습니다. 작은 복사본을 닫았다가 다시 열어 변경 범위를 줄이세요.
중복 노드, 잘못된 계층, 깨진 기호가 보이면 레벨 설정, 캡처 범위, 파일 인코딩을 확인합니다. 먼저 기본 규칙으로 되돌리고 사용자 패턴은 한 줄만 추가해야 원인을 분리할 수 있습니다.
| 증상 | 확인 순서 | 다음 행동 |
|---|---|---|
| 빈 트리 | 확장자 → 타입 → 규칙 | 작은 샘플 다시 열기 |
| 일부 항목 누락 | 문법 → 패턴 | 패턴 하나 추가 후 비교 |
| 중복·계층 오류 | 레벨 → 캡처 범위 | 기본 규칙으로 복귀 |
| 이동 위치 오류 | 행 번호 → 저장 상태 | 저장된 복사본으로 재현 |
정리: 목적에 맞게 기능을 나누기
사쿠라에디터 아웃라인 추출은 제목, 함수, 라벨을 트리로 만들어 문서 안에서 이동하는 기능입니다. 사용자 규칙을 만들기 전에 타입과 기본 규칙을 맞추세요. 태그 점프는 별도의 키워드 검색이며 두 기능 모두 텍스트 출력이 보장되는 기능은 아닙니다.
저장할 보고서가 필요하다면 형식, 행 번호 정책, 인코딩, 원본 버전을 정합니다. 복사본에서 시험하고 diff를 확인한 뒤 작업 파일에 규칙이나 자동화를 적용하세요.
자주 묻는 질문
자주 묻는 질문
사쿠라에디터 아웃라인 추출이란 무엇인가요?
열린 문서의 제목, 함수, 라벨을 분석해 트리로 표시하고 원래 줄로 이동하는 기능입니다. 자동 텍스트 출력과는 다릅니다.
아웃라인 목록을 텍스트로 출력할 수 있나요?
항상 한 번에 내보내는 버튼이 있다고 가정하지 마세요. 선택 복사, 태그 점프 행 복사, 매크로나 외부 스크립트를 사용하고 복사본에서 결과를 확인합니다.
아웃라인이 비어 있는 이유는 무엇인가요?
확장자와 타입 불일치, 언어 규칙 부재, 잘못된 규칙 경로, 패턴 밖 문법이 흔한 원인입니다. 타입, 규칙, 샘플 순서로 확인하세요.
아웃라인과 태그 점프의 차이는 무엇인가요?
아웃라인은 문서 구조를 계층으로 보여 주고 태그 점프는 키워드나 태그의 위치를 목록으로 찾습니다. 문서 지도와 정의 검색 중 목적에 맞게 선택합니다.
규칙 파일을 고치기 전 무엇을 확인해야 하나요?
원본을 복사하고 타입과 위치를 확인한 뒤 패턴 하나를 추가해 노드와 이동 위치를 비교합니다.
개념도는 공식 화면인가요?
아닙니다. 원문·규칙·트리 관계를 설명하는 보조 그림입니다. 공식 화면은 캡션에 표시했으며 실제 버전의 이름은 공식 도움말을 따르세요.