본문으로 건너뛰기
실습하기

python-docx로 목록(List) 작성하기

문서에서 목록(List)은 정보를 구조화하고 명확하게 전달하는 데 중요한 역할을 합니다.

python-docx를 사용하면 워드 문서에 손쉽게 순서 있는 목록과 순서 없는 목록을 추가할 수 있습니다.

이번 수업에서는 python-docx를 활용해 목록을 작성하고, 이를 다양한 스타일로 설정하는 방법을 알아보겠습니다.


순서 없는 목록 (불릿 목록) 작성하기​

순서 없는 목록은 각 항목 앞에 불릿 기호가 표시되는 목록입니다.

python-docx에서 add_paragraph() 메서드와 ListBullet 스타일을 사용하여 순서 없는 목록을 작성할 수 있습니다.

순서 없는 목록 작성하기
from docx import Document

# 새 워드 문서 생성
doc = Document()

# 순서 없는 목록 추가
doc.add_paragraph('첫 번째 항목', style='ListBullet')
doc.add_paragraph('두 번째 항목', style='ListBullet')
doc.add_paragraph('세 번째 항목', style='ListBullet')

# 문서 저장
doc.save('output_file.docx')

  • add_paragraph('텍스트', style='ListBullet')는 불릿 스타일을 적용한 단락을 추가합니다.

  • 위 코드에서는 '첫 번째 항목', '두 번째 항목', '세 번째 항목'을 불릿 목록으로 표시합니다.

이 코드를 실행하면 각 항목 앞에 불릿 기호가 있는 순서 없는 목록이 생성됩니다.


순서 있는 목록 (번호 목록) 작성하기​

순서 있는 목록은 각 항목이 번호로 표시되는 목록입니다.

python-docx에서는 ListNumber 스타일을 사용하여 순서 있는 목록을 쉽게 만들 수 있습니다.

순서 있는 목록 작성하기
# 순서 있는 목록 추가
doc.add_paragraph('첫 번째 항목', style='ListNumber')
doc.add_paragraph('두 번째 항목', style='ListNumber')
doc.add_paragraph('세 번째 항목', style='ListNumber')

# 문서 저장
doc.save('output_file.docx')

  • add_paragraph('텍스트', style='ListNumber')는 번호 목록 스타일을 적용한 단락을 추가합니다.

  • 위 코드에서는 '첫 번째 항목', '두 번째 항목', '세 번째 항목'이 번호로 표시됩니다.

이 코드를 실행하면 각 항목 앞에 번호가 표시된 순서 있는 목록이 생성됩니다.


다단계 목록 작성하기​

python-docx를 사용하면 다단계 목록, 즉 하위 항목이 포함된 목록도 작성할 수 있습니다.

이를 위해 동일한 스타일을 사용하면서 단락을 들여쓰기로 구분합니다.

다단계 목록 작성하기
# 다단계 목록 추가
doc.add_paragraph('주 항목 1', style='ListNumber')
doc.add_paragraph('   하위 항목 1.1', style='ListNumber')
doc.add_paragraph('   하위 항목 1.2', style='ListNumber')
doc.add_paragraph('주 항목 2', style='ListNumber')
doc.add_paragraph('   하위 항목 2.1', style='ListNumber')

# 문서 저장
doc.save('output_file.docx')

  • 각 단락 앞에 공백을 추가하여 들여쓰기를 표현합니다.

  • 주 항목 1과 주 항목 2 아래에 들여쓰기된 하위 항목 1.1, 하위 항목 1.2와 같은 하위 항목이 포함됩니다.

이 코드를 실행하면 다단계 번호 목록이 생성됩니다.

다음 내용이 궁금하다면?

코드프렌즈 PLUS 멤버십 가입 or 강의를 등록해 주세요!