커스텀 글머리 설정

2.17.2311 버전부터 지원합니다.

editor.list.customList를 사용하여 커스텀 글머리를 구성합니다.

설정(config) 구성하기

• 커스텀 글머리는 최대 9단계까지 지원합니다.
• 9단계를 초과하여 정의된 항목은 표시되지 않습니다.
• 배열이 비어 있으면([]), 커스텀 글머리 기능이 동작하지 않습니다.
• 9개 미만의 항목이 설정된 경우, 정의된 항목이 자동으로 반복되어 9단계를 모두 채웁니다.
• 설정(config)에서 runStyle이 설정된 경우, 편집 중 사용자가 적용한 스타일보다 runStyle 설정이 우선 적용됩니다.

format

format에 사용할 수 있는 글머리 기호 형식은 다음과 같습니다:

levelText

format이 bullet일 때만 유효합니다.

'editor.list.customList': [
    { format: 'decimal' },
    { format: 'bullet', levelText: '□' },
    { format: 'bullet', levelText: '♧' },
    { format: 'decimalEnclosedCircle' }
]

runStyle

3.2.2509 버전부터 지원, 2.20.2509 버전부터 지원합니다.

runStyle 속성을 추가하면 글머리 기호에 사용자 정의 스타일을 적용할 수 있습니다.

'editor.list.customList': [
    {
        format: 'bullet',
        levelText: '★',
        runStyle: {
            color: 'yellow',
            fontSize: { value: 12, unit: 'pt' },
            underline: true,
            italic: true,
            strike: true,
            fontWeight: 700,
            backgroundColor: { r: 135, g: 206, b: 250 }
        }
    }
]

distance

3.3.1 버전부터 지원, 2.21.1 버전부터 지원합니다.

distance 값을 설정하면 글머리 기호와 텍스트 사이의 간격을 조정할 수 있습니다. (기본값: -10)

distance는 문단의 시작점(0)을 기준으로 글머리 기호의 위치를 나타냅니다. 값이 더 음수일수록 글머리 기호가 왼쪽으로 더 이동하여, 글머리 기호와 텍스트 사이의 간격이 넓어집니다.

• 음수 값은 글머리 기호와 텍스트 사이의 간격을 넓힙니다.
• 양수 값은 글머리 기호와 텍스트가 서로 겹치게 만듭니다.

'editor.list.customList': [
    { format: 'bullet', levelText: '★', distance: -20 },
    { format: 'bullet', levelText: '★', distance: -10 },
    { format: 'bullet', levelText: '★', distance: 0 },
    { format: 'bullet', levelText: '★', distance: 20 },
]

distance: -10 (기본값)	distance: -5	distance: 0

적용 예시

글머리 기호 구성 예시

'editor.list.customList': [
    { format: 'decimal' },
    { format: 'bullet', levelText: '□' },
    { format: 'bullet', levelText: '♧' },
    { format: 'decimalEnclosedCircle' }
]

스타일 구성 예시

3.2.2509 버전부터 지원, 2.20.2509 버전부터 지원합니다.

'editor.list.customList': [
        {
            format: 'bullet',
            levelText: '★',
            distance: -10, // 3.3.1, 2.21.1 and above
            runStyle: {
                color: 'yellow',
                fontSize: { value: 12, unit: 'pt' },
                underline: true,
                italic: true,
                strike: true,
                fontWeight: 700,
                backgroundColor: { r: 135, g: 206, b: 250 }
            }
        },
        {
            format: 'bullet',
            levelText: '＠',
            distance: -5, // 3.3.1, 2.21.1 and above
            runStyle: {
                color: { r: 255, g: 123, b: 45 },
                fontSize: { value: 24, unit: 'pt' },
                italic: true,
                strike: true,
                backgroundColor: { r: 235, g: 55, b: 12 }
            }
        },
        {
            format: 'bullet',
            levelText: '#',
            distance: 0, // 3.3.1, 2.21.1 and above
            runStyle: {
                color: { r: 45, g: 255, b: 45 },
                fontSize: { value: 32, unit: 'pt' },
                italic: true,
                strike: true,
                backgroundColor: 'red'
            }
        },
        {
            format: 'bullet',
            levelText: '♤',
            distance: -5, // 3.3.1, 2.21.1 and above
            runStyle: {
                color: '#634948',
                fontSize: { value: 40, unit: 'pt' },
                italic: true,
                strike: true,
                backgroundColor: { r: 55, g: 12, b: 235 }
            }
        },
    ]

관련 정보

• 글머리표 번호 설정