Handle various types of line endings in CotEditor on Mac

CotEditor can handle various types of line endings. In general, it uses a single line-ending type consistently throughout a document

CotEditor treats the following characters as line ending delimiters:

LabelUnicode nameCode pointMetacharacterDescription
LF Line Feed U+000A \n

The standard line endings in UNIX and modern macOS.

CR Carriage Return U+000D \r

The line ending used in classic Mac OS.

CRLF U+000D U+000A \r\n

The combination of CR and LF line endings. Used mainly in Windows.

NEL Next Line U+0085

A legacy line ending character used mainly in EBCDIC, a kind of character encoding by IBM. Hidden by default.

LS Line Separator U+2028

A control character indicating the separator of lines in Unicode. Hidden by default.

PS Paragraph Separator U+2029

A control character indicating the separator of paragraphs in Unicode. Hidden by default.

The latter three types, NEL, LS, and PS, are hardly used in the real world as line ending delimiters. Therefore, CotEditor hides them by default in the line ending choices.

Note: Although VT (U+000B) and FF (U+000C) also visually break lines in CotEditor, they aren’t regarded as line endings characters.

Set default line endings

  1. Go to the CotEditor app on your Mac.

  2. Choose CotEditor > Settings, then click Format.

  3. Select the “Default line endings.”

The default line endings setting is used for new documents and when the existing document doesn’t have any line endings.

Detect line endings in a document

CotEditor detects the line ending used in a document automatically. When you open an existing document, the app sets the detected line ending as the line ending for further editing.

You can inspect the type of line endings used in the document either in the following area:

If a document has inconsistent line endings, CotEditor automatically alerts and highlights them. For details, see Find inconsistent line endings.

Change the document line ending

  1. In the CotEditor app on your Mac, open a document.

  2. Open the Line Endings menu either in the status bar or in the Format menu.

  3. Select a line ending.

    To convert the document line endings to a hidden one, such as NEL, LS, or PS, open the Line Endings menu by pressing the Option key.

Insert line endings different from document line ending

In general, CotEditor uses only the document line ending when breaking lines so that you don’t need to care about the difference in the line endings types. Even if you insert text with different line endings in some way, such as by CotEditor script or text replacement using regular expressions, CotEditor implicitly converts all line endings in the text to insert to the line ending in the document.

CotEditor provides the following two ways to insert line endings different from the document’s line ending:

See also