Как изменить внешний вид notepad

• [pulldown]: Set the language for the Notepad++ user interface.
  • This copies one of the XML files from the localization folder to nativeLang.xml.
  • To make changes to your localization, edit the language file localization<languagename>.xml, as per the instructions in the Binary Translation section.
  • NOTE: After making changes to the XML file in the localization directory, or after upgrading to a new version of Notepad++, you need to refresh the nativeLang.xml: use the Localization drop-down to change the Localization to another language then change it back immediately to your preferred language, or skip the «another language» step and just click on the preferred language — either way ends up with copying the file to nativeLang.xml and immediately updating Notepad++’s text for menus and dialogs. (Unlike many configuration files, exiting Notepad++ and restarting the application will not bring in the new settings from an edited localization<languagename>.xml; you must re-choose the desired Localization for the changes to be applied.)

• ☐ Hide: the icon-based toolbar will be hidden
• There is a radio-button set of choices for the icons (updated v8.0.0)
  • Fluent UI: small: uses small versions of the Fluent UI icons
  • Fluent UI: large: uses large versions of the Fluent UI icons
  • Filled Fluent UI: small: uses small versions of the Fluent UI icons, in a filled (or reverse-video) style
  • Filled Fluent UI: large: uses large versions of the Fluent UI icons, in a filled (or reverse-video) style
  • Standard icons: small: these are the small version of the traditional (pre-v8.0.0) icons

• ☐ Disable extension column: Prior to v8.1.5, if checked, the Document List panel will not have the second column showing extensions (instead, the extension will be part of the Name column); in v8.1.5, this is controlled by right-clicking in the headers of the Document List panel.
• ☐ Show: Prior to v8.1.3, this checkmark would toggle the Document List panel; in v8.1.3 and after, this is now controlled by the View menu’s «Document List» entry

• ☐ Hide: the tab bar for the open files will not be visible
• ☐ Multi-line: if there are enough tabs, they will wrap to a second line
• ☐ Vertical: have the tabs on their side on the left, rather than along the top
• ☐ Reduce: make the tab bar vertical region and font size smaller
• ☐ Alternate icons: change the «saved»/»edited»/»read-only» icons from blue/red/grey disk-icons to checkmark/pencil/lock symbols, respectively
  • The alternate icons option is designed to improve the user experience for visually-impaired users, and any who prefer different symbols rather than different colors to distinguish the status of each file.
  • Note: In Dark Mode, the «saved» symbol (either the blue disk or the green checkmark) will not be shown; the «edited» and «read-only» icons will be.
• ☐ Lock (no drag and drop): prevent the reordering of tabs by drag-and-drop on the tab bar (unselected, drag-and-drop on the tab bar will reorder tabs)
• ☐ Darken inactive tags: change the fill-color on inactive tabs to a darker color
• ☐ Draw a coloured bar on active tab: indicate the active tab by adding a colored bar
• ☐ Show close button on each tab: add the close button to each tab’s entry on the tab bar
• ☐ Double click to close document: allows double-clicking on the tab to close the file
• ☐ Exit on close the last tab: if the last tab is closed, Notepad++ will exit (unselected, Notepad++ instead has one new file open)

• ☐ Hide menu bar (use Alt or F10 key to toggle): sets the main menu bar (File, Edit, Search, …) invisible; once invisible, it can be made temporarily visible by using the Alt or F10 key
• ☐ Hide right shortcuts ＋ ▼ ✕ from the menu bar (Need to restart Notepad++): makes the ＋ ▼ ✕ resources invisible (new to v8.4.5). Use this if you find the menu bar too «cluttered», or find those commands redundant.

• Width: [pulldown] Sets the width and shape of the typing caret:
  • 1, 2, 3: Width (in pixels) of the vertical-bar-style typing caret.
  • 0: Width of caret is 0 pixels, which means there is no visible caret.
  • Block: the caret will be a full-character-width rectangle; while typing, the caret block will appear where the next character will be typed; while selecting text, the caret block will be on the last character of the selection (so if you have text ABC: and select from A to C, the caret block will be on the C).
  • Block After: the caret will be a full-character-width rectangle; while typing, the caret block will appear where the next character will be typed; while selecting text, the block will be after the character position of the selection (so if you have text ABC: and select from A to C, the caret block will be on the :).
• Blink Rate: [slider] Adjust the rate at which the caret blinks, faster when moved left (F), slower when moved right (S)

• ☐ Default: wraps from the last visible column to the first visible column
• ☐ Aligned: wraps from the last visible column to the same indent as the start of the unwrapped line
• ☐ Indent: wraps from the last visible column to the next level of indent compared to the start of the unwrapped line

• ☐ None : no indicator for which line is the current line.
• ☐ Highlight Background : indicate the current line by highlighting the normal background color with the Settings > Style Configurator > Global Styles > Current line background color style’s Background colour
• ☐ Frame : indicate the current line by drawing a rectangle frame around the text of the current line, using the color defined by Settings > Style Configurator > Global Styles > Current line background color style’s Background colour, and with the rectangle-line thickness defined by the Width slider
  • Width: slider is used to set the width (in pixels) for the lines of the rectangle Frame for the current line
• (In v8.4 and earlier, this multi-control section was just listed as ☐ Enable current line highlighting in the list of checkboxes, and was the equivalent of ☐ being None and ☑ being Highlight Background.)

• Default: old behavior (CR and LF in reverse-video boxes)
• Plain Text«: Looks like normal text for CR, LF, and CRLF
• Custom Color: Opens the Style Configurator dialog to edit Global Styles > EOL custom color

• When you enable Dark Mode:
  • it will change the active theme to your previously-selected Dark mode theme (new to v8.4.8; previously it always switched to DarkModeDefault)
    • Reminder: changing the theme does not change your UDL colors, as discussed in the UDL and Themes section. If your UDL was colored to match some other theme, the colors will likely mismatch, and you will need to edit the UDL colors to make it match the DarkModeDefault theme.
  • it will change the coloring of the menu bar and toolbar (if visible)
    • Note: In v8.0 — v8.1.1, you must exit Notepad++ completely and restart for full Dark Mode. In v8.1.2 and newer, that is no longer necessary.
  • it may change your General > Toolbar settings to use one of the Fluent UI icon sets: if you already had a Fluent icon set selected, it will keep it; if you had the Standard icons: small selected, it will change to Fluent UI: small icons. Starting in v8.4.8, it will remember this the next time you switch to Dark Mode.
  • When you run in Dark Mode, the saved-file icon will not show up on your Tab Bar, whether or not you have Alternate Icons checked. However, a read-only file or an edited file will still show their icons (either different colored disks, or the lock icon and pencil icon, depending on Alternate Icons setting).
• When you enable Light Mode:
  • it will change the active theme to your previously-selected Light Mode theme (new to v8.4.8; previously it always switched to Default (stylers.xml))
    • Note: prior to v8.4.8, this was true even if you previously had a different theme selected before trying out Dark Mode. In older versions, if you would like a different theme, you will have to manually change to that theme after changing from Dark Mode to Light Mode.
  • it will change the coloring of the menu bar and toolbar (if visible)
    • Note: You must exit Notepad++ completely and restart in order to get the rest of the UI (like the top title bar) to be fully out of Dark Mode.
  • Prior to v8.4.8, it would leave your Toolbar settings with the same icon set as you had when you were in Dark Mode
• Notepad++ will track Settings > Preferences > General settings for the Tool Bar and Tab Bar separately for Light Mode and Dark Mode, as well as Settings > Style Configurator > Theme to allow you to have different tool bar icons or tab bar settings and themes in the different modes, so you can switch between them without having to manually make those changes (new to v8.4.8)

• Note: Dark Mode Tones affect most of the user interface, including main menus and toolbars and most of the dialogs, as of v8.1.3. (In v8.1.2, the Tones affected the menus and the Find/Replace/Mark dialog, but not the other dialogs.) The menu pulldown controls, as well as Windows-defined dialog boxes like Open and Save, have their colors defined by operating system settings, and Notepad++ Dark Mode settings will not affect them.
• ☐ Black tone, ☐ Black tone, ☐ Black tone, ☐ Black tone, ☐ Black tone, ☐ Black tone, ☐ Black tone => The dark color has a hint of that colored tone
• ☐ Customized tone => allows you to configure the tones of the individual components of the Dark Mode (even to the point of not being Dark anymore):
  • Top => choose the color of the menu bar and tool bar
  • Menu hot track => choose the color of the active menu bar entry
  • Active => choose the color of the active tab on the tab bar
  • Main => choose the color of the inactive tab(s) on the tab bar, as well as background colors for most dialog boxes
  • Error => choose the color for the error indicator on the Incremental Search bar
  • Text => choose the color for the menu bar entry names, and other normal text for most dialog boxes
  • Darker text => choose the color for the darker text for most dialog boxes
  • Disabled text => choose the color for disabled items in most dialog boxes (often referred to as «greyed out» or «disabled»)
  • Edge => choose the color for the vertical separator bars on tab bars (in the main window and in dialogs), and other edges (like the boxes around color selectors)
  • Link => choose the color for link text in dialog boxes (for example the hyperlink URL in the User Defined Languages dialog) (new to v8.1.3)

• ☐ Simple: shows a - if that section is not folded, or a + if it is.
• ☐ Arrow: shows a ▼ if that section is not folded, or a ▶ if it is.
• ☐ Circle tree: shows a ⊖ with a line to the end of the section if that section is not folded, or a ⊕ if it is folded
• ☐ Box tree: shows a ⊟ with a line to the end of the section if that section is not folded, or a ⊞ if it is folded
• ☐ None: shows no symbols and hides that column, even for lexers that allow code folding
  • The View menu folding commands still work, even when the Folder Margin Style is set to None

• [number-slider]: sets the width (in pixels) of the border around each view’s text editor; technically, it’s the gap between the light and dark portions of the sunken border, so a width of 0 will still have the light and dark lines for the sunken edge
• ☐ No edge: will remove the entire border, including the light and dark bars, so it no longer appears sunken

• This will allow one or more vertical edges to be displayed while editing your file, to help with line lengths or positioning text. This edge indicator can either be a vertical line, or a background shading beyond the edge. The color of the line or background shading will be taken from Settings > Style Configurator > Global Styles > Edge Color: Foreground colour.
• Multiple Vertical Edges: There is one box, which accepts zero or more numbers (as of v7.8.6):
  • If the box is empty, there are no vertical edges.
  • If there is one number ℕ in the box, there will be one vertical edge, after the column for the ℕth character.
  • If there is more than one number (separated by whitespace), then there will be a vertical edge at each of the given character columns.
  • ☐ Background mode: the vertical edge is usually a vertical line; if this option is checked, the vertical edge will be indicated by styling the background of the text to the right of the edge.
• Single Vertical Edge: in older versions of Notepad++, there was only a single vertical edge available, with more toggled options (v7.8.5 and earlier):
  • ☐ Show vertical edge: shows a vertical edge at the specified location, often used to indicate the right margin for manually setting the number of characters per line
  • ☐ Line mode: the vertical edge is indicated by a solid vertical line
  • ☐ Background mode: the vertical edge is indicated by styling the background of the text to the right of the edge
  • Number of columns: __ : sets where the vertical edge will be, in numbers of columns (characters) from the left edge of the page

• ☐ Display: shows the line numbers to the left of the text (renamed in v7.9.2, known as Editing > ☐ Display line number)
• ☐ Dynamic width: the line number display will adjust its width based on the number of digits needed (this matches the behavior prior to v7.9.2)
• ☐ Constant width: the line number display will have enough width for any line number in the document (new to v7.9.2)

• Left will add N pixels of padding between the left edge of the editor pane and the actual text (this is beyond the space allocated for the line numbering, and beyond the space allocated for the folding column). A bigger number leaves more of a gap, and thus less room for actual text.
• Right will add N pixels of padding between the right edge of the editor pane and the actual text. A bigger number leaves more of a gap, and thus less room for actual text.
• The Distraction Free setting changes the borders when Distraction Free Mode is active; a bigger number means more of the screen width is allocated to distraction free text, and a smaller number means less of the screen width is allocated to distraction free text.

• Windows (CR LF) / Unix (LF) / Macintosh (CR): newly-created files will use the normal Windows-style line ending, Unix/Linux/*nix-style line ending, or old Mac-style line ending. (Please note that modern MacOS X uses Unix-style line endings.)

• ANSI: characters are represented by a single 8-bit byte, and there are only 256 available code points
• UTF-8: this can encode any of the Unicode characters; it uses a single 8-bit byte for codepoints under 128, and two or more bytes for other characters
  • ☐ Apply to opened ANSI files: if you open an ANSI file, this allows it to be «upgraded» to UTF-8
• UTF-8 with BOM: this is the same as UTF-8 encoding, but saves the file with an extra Unicode character U+FEFF (which is encoded as 3 bytes in the file), which some applications use as an indication that it’s a UTF-8 file
• UTF-16 Big Endian with BOM: this encodes characters (even those with codepoints under 128) with exactly two bytes. «Big Endian» refers to the order the two bytes will be written to disk (with most-signficant byte first) (Prior to v8.0.0, it was shown as UCS-2)
• UTF-16 Little Endian with BOM: this encodes characters (even those with codepoints under 128) with exactly two bytes. «Little Endian» refers to the order the two bytes will be written to disk (with least-signficant byte first) (Prior to v8.0.0, it was shown as UCS-2)
• The final drop-down allows picking one of the old-style character sets (similar to using the main Notepad++ menu to select Encoding > character sets …)
• Note: the MISC > Autodetect character encoding option will also affect Encoding of existing files

• Follow current document: open/save dialogs will default to the current directory for the current file
• Remember last used directory: open/save dialogs will remember the last directory you used in the dialog on subsequent uses of the dialogs (regardless of where the current file is located). Note: the last used directory will only be updated when the Open or Save option is selected; if you Cancel or escape out of dialog, the last used directory will not be updated and will keep its previous value. Also, note that the last used directory is not remembered across runs of Notepad++: if you restart Notepad++, when you first initiate a Save As, it will prompt with the directory the notepad++.exe file is in.
• ___ ...: this entry box with no label allows you to browse to a default directory, and all open/save dialogs will start in that directory

• this is useful if you have files on a network drive which intermittently isn’t visible, and want files to remain in the Recent Files History list
• this is also useful if you like knowing what files were previously edited, even after you’ve deleted those files from the folder

• ☐ Make language menu compact will make submenus for languages that start with the same letter
  • Under normal circumstances, this makes the list of items in the Language menu much shorter: the standard 80+ languages will be reduced to about 20 submenus and a few standalone Language menu entries
  • For example, Perl and Python syntax highlighting would be selected through Language > P submenu, rather than directly from the language menu
• Available items ⇄ Disabled items: by moving a language into the Disabled items column, it will no longer show up in the Language menu list
  • If you have moved items to Disabled Items and have checked ☑ Make language menu compact, there may end up being empty letter-based subfolders in the Language Menu

• [Default] sets the tab behavior for the «default» condition
• normal sets the tab behavior for plain text
• other selections will choose which syntax-language the tab settings are being changed
• ☐ Use default value: not visible on the [Default] selection. For other languages, will use the values from the [Default] selection for that particular language
• Tab size : ___: sets the width of the tab stop. If the text uses literal TAB characters (Replace by space is turned off), pressing the Tab key will insert one TAB character in the file, but Notepad++ will display that character as a gap with a width of up to that many space characters. If the text is replacing TABs with spaces, pressing the Tab key will insert enough literal spaces so that the next character will start at the beginning of the next tab stop.
• ☐ Replace by space: when set, hitting the TAB key will insert that number of spaces; when not set, the TAB key will insert the literal ASCII TAB character
• For example: if Tab size is set to 4, and your line starts with one character, hitting the Tab key will either insert the single TAB character in the file which will be displayed as a gap the equivalent width of 3 spaces to bring the total characters up to a multiple of the tab size (tab size of 4, minus a single real character already there, means 3 character positions left to fill with the gap of this single TAB character), or (if Replace by space is turned on) will insert 3 literal space characters instead of the TAB character; either way, the next character on the line will start in the 5th column of the line.

• Note: this section of the preferences was renamed v8.1.4; it was known as Mark All in v8.0 — v8.1.3
• ☐ Match case: Mark All will be case-sensitive
• ☐ Match whole word only: Mark All will require a whole «word» (sequence of «word characters», as defined in the Delimiter preferences)
• This setting section applies to the Search menu’s Mark All submenu entries, and the equivalent right-click Context Menu’s Style all occurrences of token submenu entries, for applying «Style Tokens» to specific text.

• ☐ Enable: if you select a piece of text, Smart Highlighting will color all matching pieces of text. It will use the style defined in Style Configurator > Global Styles > Smart Highlighting
• ☐ Highlight another view: Smart Highlighting will also apply to the other «view» (when you have documents open in both of Notepad++ view panes)
• Matching: ☐ Match case: Smart Highlighting will be case-sensitive
• Matching: ☐ Match whole word only: Smart Highlighting will require a whole «word» (sequence of «word characters», as defined in the Delimiter preferences)
• Matching: ☐ Use Find dialog settings

• ☐ Enable: in HTML/XML files, clicking in or highlighting in an opening or closing tag (between the angle brackets) will highlight both the opening and closing tag. It will use the style defined in Style Configurator > Global Styles > Tags match highlighting
• ☐ Highlight tag attributes: any attributes inside the active tag will be highlighted using the style defined in Style Configurator > Global Styles > Tags attribute
• ☐ Highlight comment/php/asp zone

• ☐ WYSIWYG: same colors will apply to printing as you see in the editor
• ☐ Invert: black prints as white, light color prints as dark, and vice versa
• ☐ Black on White: prints black text on white background, no highlighting
• ☐ No background colour: same as WYSIWYG, except no background color is printed

• Click in one of the Left part, middle part, or right part for header or footer;
• either type in text for literal text, or use the Variable: drop-down and Add button to add one of the variables at the current caret position
  • Add Full file name path ⇒ $(FULL_CURRENT_PATH) in the input box ⇒ will print something like c:pathtofile.txt
  • Add File name ⇒ $(FILE_NAME) in the input box ⇒ will print something like file.txt
  • Add File directory ⇒ $(CURRENT_DIRECTORY) in the input box ⇒ will print something like c:pathto
  • Add Page ⇒ $(CURRENT_PRINTING_PAGE) in the input box ⇒ will print the current page number. (Sorry, there is no total-number-of-pages variable, so you cannot do page # of #.)
  • Add Short date format ⇒ $(SHORT_DATE) in the input box ⇒ will print something like m/dd/yyyy (possibly locale-dependent)
  • Add Long date format ⇒ $(LONG_DATE) in the input box ⇒ will print something like Day, Month ##, YYYY (possibly locale-dependent)
  • Add Time ⇒ $(TIME) in the input box ⇒ will print something like HH:MM AM (possibly locale-dependent)
• Font pulldown: use selected font for the header or footer (if left blank, use document’s default font)
• Font size pulldown: define font size for header or footer

• ☐ Fill find field in Find dialog with selected word: When checkmarked, invoking the Find Dialog will fill the Find What field with the currently-selected text; when not checkmarked, invoking the Find Dialog will not change the contents of the Find What field (reworded in v8.4.5; previously was Don't fill find field...)
  • ☐ Select Word Under Caret when Nothing Selected: When checkmarked, invoking the Find Dialog with no active selection will fill the Find What field with the text under the caret; when not checkmarked, invoking the Find Dialog with no active selection will not change the contents of the Find What field; if the option above is not checkmarked, this option will be un-checkmarked and cannot be toggled. (new to v8.4.5)

• ☐ Remember current session for next launch: the current session is the current list of open files. The next time you run Notepad++, it will open with that same list of files
• ☐ Enable session snapshot and periodic backup: this will auto-save your changed file once every N seconds to the listed directory (default to %AppData%Notepad++backup).
  • It is not possible to select this option without ☐ Remember current session ... also being active
  • This is also how you enable Notepad++ to remember unsaved changes
  • This will allow you to exit Notepad++ and resume, remembering changes to files that hadn’t been intentionally saved
  • When you exit Notepad++ with unsaved changes, Notepad++ will not ask you to save changes. It will just keep the periodic backup file, and reload from there rather than from the normal disk location for the file
  • If you want Notepad++ to ask to you save edited files every time you close the file or exit Notepad++, do not enable this option.
  • This is not a long-term backup option.
    • Every time you do a manual save, or every time you close the file while leaving Notepad++ open, this periodic backup of the file will be deleted
    • If there is a Notepad++ crash or Windows crash, it is possible for you to lose data
  • Periodic Backup file naming:
    • For named files (existing or saved files that have recent edits): the name of the backup file (in the listed directory) is filename.ext@yyyy-mm-dd_hhmmss, where filename.ext is from the main file. As soon as you manually save the file (so it’s written to disk in the real location), the backup goes away, because the purpose of the periodic backup is to save a copy of a file that you’ve edited but not saved. The timestamp part of the periodic-backup-name is based on the first automatic save after the last manual save. Example: if you saved a file at 8:10:00am, the backup would go away; then, at 8:12:30am, you type something but don’t save, so sometime within N seconds of that (8:12:30+N) it will periodic-backup-save and make a file with a timestamp about then – something like filename.ext@2021-06-23_081234. If you left for a while (or exited Notepad++ and reloaded) and came back at 12:34:56pm and typed another character, it would do it’s periodic-backup-save on that file again so the last-modified time of the backup would be updated), but the name of the periodic-backup file will remain the same.
    • For unnamed files (new files that haven’t been saved): the name of the backup file (in the listed directory) is new NNN@yyyy-mm-dd_hhmmss, where new NNN matches the name listed in the tab title. Since new NNN files are by definition not manually saved, the timestamp in the periodic-backup filename is based on when it did the first periodic-backup-save for that unnamed file.

• ☐ None: no additional backup will be performed when the file is saved
• ☐ Simple backup: it will save a copy of the file, with the same name and extension, but with .bak appended.
  • if the Custom Backup Directory is turned on and defined, it will save the simple backup in that defined directory; for example, if it is set as c:myCustomBackupFolder, then the file c:pathtofile.txt will save its simple backup as c:myCustomBackupFolderfile.txt.bak
    • Note: if you are editing two files with the same name which are in separate directories (like c:patha.txt and c:othera.txt), the Custom Backup directory will only contain one backup file (a.txt.bak) , with the contents of whichever file was saved most recently. Turning off Custom Backup Directory will eliminate this problem, because then the backup of a file will reside in the same directory as the original, so there will not be name conflicts on the backups.
  • if the Custom Backup Directory is not turned on and defined, it will save the simple backup in the same directory as the original file; for example, saving c:pathtofile.txt will save its simple backup as c:pathtofile.txt.bak
• ☐ Verbose backup: it will save a copy of the file, with a date-and-timestamp added to the filename (in the format yyyy-mm-dd_hhmmss) as well as the .bak extension.
  • if the Custom Backup Directory is turned on and defined, it will save it in that directory; for example, if it is set as c:myCustomBackupFolder, then the file c:pathtofile.txt file would be backed up as c:myCustomBackupFolderfile.txt.2021-06-28_073650.bak
    • Note: if you are editing multiple files with the same name which are in separate directories (like c:patha.txt and c:othera.txt), the Custom Backup directory will contain verbose backup files for nearly all individual saves; however, if it happens that both files were saved within the same second (by being really fast, or using Save All), then only_one_ backup file will exist with that timestamp (a.txt.2021-06-28-073722.bak), with the contents of whichever file happened to be saved last in that second. Turning off Custom Backup Directory will eliminate this problem, because then the backups of a file will reside in the same directory as the original, so there will not be name conflicts on the backups.
  • if the Custom Backup Directory is not turned on and defined, it will save it in .nppBackup subdirectory of the file’s current directory; for example, saving c:pathtofile.txt will create a backup called c:pathtonppBackupfile.txt.2021-06-28_073650.bak
• ☐ Custom Backup Directory: leave blank to put the backup in the same directory as the file; set to a directory to have all files backed up to one directory

• ☐ Enable auto-completion on each input: a dropdown selection will appear as you type; arrow keys will select various choices, TAB or ENTER will accept a choice, ESC will cancel auto-completion
  • ☐ Function completion: will auto-complete function names only, based on the keywords in the active auto-completion file
  • ☐ Word completion: will auto-complete words only, based on words that already exist in the current file
  • ☐ Function and word completion: will auto-complete both function names and words
• From the _n_th character: must type at least n characters before the auto
  • if ☐ Enable auto-completion on each input is checked, the _n_th character entry will be disabled (greyed out)
• ☐ Ignore numbers: won’t try to auto-complete when typing numbers
• Insert Selection: v8.2.1 added a new section
  • ☐ TAB: toggles whether or not TAB will accept your choice
  • ☐ ENTER: toggles whether or not ENTER will accept your choice
  • v8.2 and earlier behaved as if both have checkmarks; v8.2.1 and later defaults to having TAB checkmarked but ENTER not checkmarked, so the default behavior has changed.
• ☐ Function parameters hint on input: for applicable programming languages, will provide hints on what to type in a function parameter list
• Please note that if you use Edit > Auto-Completion > … menu entries to activate the completion features, you can force function or word or parameter completion, even when those checkboxes are turned off in the settings, and even if there aren’t enough characters typed to trigger the auto-completion.

• Will automatically insert the closing item for any of the checked pairs, or the three manually-chosen matched pairs
  • ☐ ()
  • ☐ []
  • ☐ {}
  • ☐ ""
  • ☐ ''
  • ☐ html/xml close tag
  • Matched pair [1,2,3]: __ __: define the open and close character(s) for three user-defined pairs

• ☐ Use default Word character list as it is: for Smart Highlighting (see above) or the Normal search mode in the Find and Replace dialogs, will use the normal alphanumeric rules for determining what constitutes a word for «Match Whole Word Only»
  • The default «word characters» include anything that Unicode considers alphanumeric, plus the underscore «_» character.
    • Includes: standard Latin characters, accented characters, letter-like symbols, superscript digits, and enclosed (circled) digits
    • Excludes: punctuation, mathematical operators, box drawing, arrows, emoji, or other such symbols.
• ☐ Add your character as part of word: sometimes, the default «word character list» isn’t sufficient for you; if you want other characters to be considered in «whole word only», add them here
  • The value should be a string consisting of all the additional characters you would like to be included as a «word character».
  • Spaces are liable to cause problems, and are not recommended to be present in this entry. If you try to add a space, the dialog box will show a warning message.
  • If you have characters in this box, then later come and delete them all out, it will not fully stop using those extra characters as delimiters until you switch the preference back to using the default word character list, or restart Notepad++.

• If you define open and close characters, Ctrl + MouseDoubleClick will select everything inside that delimiter pair
• ☐ Allow on several lines: Ctrl + MouseDoubleClick will work across multiple lines, instead of just on a single line

• ?: This box provides some helpful hover text (the introductory paragraphs in this manual section were derived from this hover text).
• ☐ Enable Large File Restriction (no syntax highlighting): when checked, there will be no syntax highlighting for large files, and the other options below will come into effect; when unchecked, there will be no Large File Restrictions active, and Notepad++ will apply all syntax highlighting and other features, even on large files, despite any performance degredation.
• Define Large File Size: ___ MB: Put in «size limit» which will trigger Large File Restrictions.
• ☐ Deactivate Word Wrap globally: When checked, Notepad++ will deactivate the Word Wrap feature for all files (whether large or small); when unchecked, Word Wrap features will not be affected when a large file is open.
• ☐ Allow Auto-completion: When checked, Auto-completion will still be available for large files. When unchecked, large files will not allow Auto-completion.
• ☐ Allow Smart Highlighting: When checked, Smart Highlighting will still be available for large files. When unchecked, large files will not allow Smart Highlighting.
• ☐ Allow Brace Match: When checked, the Brace Match feature will still be available for large files. When unchecked, large files will not allow Brace Match.
• ☐ Allow URL Clickable Link: When checked, the text that looks like a URL will be presented as a clickable link. When unchecked, large files will not turn URL text into a clickable link.

Settings on cloud: Allows saving your settings to the cloud instead of in the normal %AppData% or program-install folders. More information can be found in the Config files location

• ☐ No Cloud: saves settings in the normal location
• ☐ Set your cloud location path here: settings will go in the given directory, which is assumed to be in a folder that’s synced to your cloud-provider

Clickable Link Settings: Affects behavior of URLs in your document. (Moved in v7.9.2; previously in the Misc settings)

• ☐ Enable: text that appears to be a URL will allow you to double-click to open that URL in your default browser. When you hover over the URL, it will change to the style defined in Style Configurator > Global Styles > URL hovered
• ☐ No underline: will remove the underline normally present on a link
• ☐ Enable fullbox mode: the background color and foreground color will change on hoverover; when unchecked, just the foreground color will change (new to v7.9.2)
• URI Customized Schemes: Space-separated list of additional schemes to recognize as URLs (new to v7.9.2). The schemes ftp:// http:// https:// mailto: file:// are always recognized, no matter what the contents of this setting, so they do not need to be included in this entry box.

• ☐ Enable: hitting Ctrl+TAB will allow you to easily switch through all the open documents
• ☐ Enable MRU behavior: it will default to selecting the most-recently-used file (or «MRU», for short) in the Ctrl+TAB list
  • When checkmarked: Ctrl+TAB will take you to the most recently used document. Also, if you close the active tab, it will activate the most recently used tab.
  • When not checkmarked: Ctrl+TAB will take you to the next tab in the Document Switcher menu (the tab to the right). Also, if you close the active tab, it will activate the next tab in the Document Switcher menu (the tab to the right) or the last tab in the Document Switcher menu if the closed tab used to be the last tab.

• ☐ Peek on tab: if you hover over an inactive tab, it will give you a tiny «peek» at the document (a ultra-tiny font preview, similar to the document map), in a small popup near the tab bar
• ☐ Peek on document map: if you hover over an inactive tab, it will change the Document Map (View > Document Map) pane to show the preview of that tab, rather than of the active document

• [pulldown]
  • Enable: for the active file only, will check periodically to see if the file has been updated on disk, and will prompt to ask if you want to reload the file from the disk, or keep the version that’s currently in Notepad++
  • Enable for all open files: for all active files, check periodically to see if the file has been updated on disk
  • Disable: will not check to see if the file has been updated on disk
• ☐ Update silently: instead of prompting, will automatically reload the file from disk
• ☐ Scroll to the last line after update: will scroll to the end of the file after reloading from disk (otherwise, the caret and scrolled-location stays where it was before the update)

• DirectWrite will help in displaying characters even if the active font doesn’t have a glyph
• The modified rendering may affect the clarity or readability of the characters for some users or systems (for some users, it increases readability; for others, it decreases readability).

• Global override takes precedence over any other color or font defined elsewhere, and will mask any per-language settings.
• Unless you want to turn off all syntax highlighting for all the programming languages, you likely don’t want to use the Global override settings.
• Do not use this if all you are trying to do is set the color for Normal Text files (.txt): for those, use the Default style below.

• As described previously, Default Style is used to set the color for Normal Text (.txt files, and anything else that isn’t highlighted by a lexer).
• Also, as described a few paragraphs earlier, the highlighters for specific languages will inherit from this Default Style for things like font and possibly color, if there is no value defined for that language.

Settings > Import > Import Plugins… will ask you to navigate to a plugin DLL anywhere on your filesystem; it will then copy that DLL into the appropriate folder so that the next time you run Notepad++, the application will load that DLL as a plugin (assuming it is a valid plugin DLL). This is an alternate way to install a single-DLL plugin, rather than the other installation methods of using Plugins Admin or manually putting the DLL and associated files in the right location. (This menu entry will not work on its own if the plugin requires more files than just its DLL.)

Settings > Import > Import Style Themes… will ask you to navigate to a style theme XML file, and will put it in the appropriate folder so that the next time you run Notepad++, the application will include it when you use the Style Configurator, the new theme will be listed in the «Select theme:» pulldown.

Settings > Edit popup ContextMenu will open the contextMenu.xml configuration file, so that you can edit your context menu, following the advice for editing configuration files.

The Save Session dialog will have a ☐ Save Folder as Workspace checkbox, which will be active (able to be toggled) when you have a Folder as Workspace opened. If the checkbox is checked, the current Folder as Workspace will be included in the saved session; otherwise, the session will not include any Folder as Workspace information. (Requires Notepad++ v7.9.3 or newer.)

When saving a new file or otherwise running the Save As dialog, there is an ☐ Append extension checkbox. If checked, Notepad++ will automatically append the first extension listed in the selected Save as type; otherwise, the extension must be manually included in the File name field. (This toggle is new to v8.0.0, and replaces the Preferences > MISC > ☐ Set Save dialog file extension filter to *.* or Set Save dialog file extension filter to .* for Normal Text preferences for setting the save dialog file extension to *.* that were present in prior v7.9.1-v7.9.5; in v7.9.1, that *.* option replaced the setting in the Default Directory section called Use new style dialog which influenced how extensions were added or not as it toggled the Save As dialog from an ancient Windows Save-As dialog to a somewhat more modern dialog.)

Change the number of expressions that can be saved in the Find/Replace dialog’s Find, Replace, Filters, and Directory fields. They are set in the <FindHistory ...> tag inside config.xml, using the attributes:

• nbMaxFindHistoryFind => changes the number of Find what entries that are saved in the history (0 .. 30, default = 10)
• nbMaxFindHistoryReplace => changes the number of Replace with entries that are saved in the history (0 .. 30, default = 10)
• nbMaxFindHistoryPath => changes the number of Directory entries that are saved in the history (0 .. 30, default = 10)
• nbMaxFindHistoryFilter => changes the number of Filter(s) entries that are saved in the history (0 .. 20, default = 10)

Changing the command-line interpreter used: by default, File > Open Containing Folder > cmd will launch the cmd.exe command-line interpreter. If you have a preferred command-line interpreter (such as powershell), you can add another <GUIConfig...> tag inside the <GUIConfigs> section:

• [pulldown]: Set the language for the Notepad++ user interface.
  • This copies one of the XML files from the localization folder to nativeLang.xml.
  • To make changes to your localization, edit the language file localization<languagename>.xml, as per the instructions in the Binary Translation section.
  • NOTE: After making changes to the XML file in the localization directory, or after upgrading to a new version of Notepad++, you need to refresh the nativeLang.xml: use the Localization drop-down to change the Localization to another language then change it back immediately to your preferred language, or skip the «another language» step and just click on the preferred language — either way ends up with copying the file to nativeLang.xml and immediately updating Notepad++’s text for menus and dialogs. (Unlike many configuration files, exiting Notepad++ and restarting the application will not bring in the new settings from an edited localization<languagename>.xml; you must re-choose the desired Localization for the changes to be applied.)

• ☐ Hide: the icon-based toolbar will be hidden
• There is a radio-button set of choices for the icons (updated v8.0.0)
  • Fluent UI: small: uses small versions of the Fluent UI icons
  • Fluent UI: large: uses large versions of the Fluent UI icons
  • Filled Fluent UI: small: uses small versions of the Fluent UI icons, in a filled (or reverse-video) style
  • Filled Fluent UI: large: uses large versions of the Fluent UI icons, in a filled (or reverse-video) style
  • Standard icons: small: these are the small version of the traditional (pre-v8.0.0) icons

• ☐ Disable extension column: Prior to v8.1.5, if checked, the Document List panel will not have the second column showing extensions (instead, the extension will be part of the Name column); in v8.1.5, this is controlled by right-clicking in the headers of the Document List panel.
• ☐ Show: Prior to v8.1.3, this checkmark would toggle the Document List panel; in v8.1.3 and after, this is now controlled by the View menu’s «Document List» entry

• ☐ Hide: the tab bar for the open files will not be visible
• ☐ Multi-line: if there are enough tabs, they will wrap to a second line
• ☐ Vertical: have the tabs on their side on the left, rather than along the top
• ☐ Reduce: make the tab bar vertical region and font size smaller
• ☐ Alternate icons: change the «saved»/»edited»/»read-only» icons from blue/red/grey disk-icons to checkmark/pencil/lock symbols, respectively
  • The alternate icons option is designed to improve the user experience for visually-impaired users, and any who prefer different symbols rather than different colors to distinguish the status of each file.
  • Note: In Dark Mode, the «saved» symbol (either the blue disk or the green checkmark) will not be shown; the «edited» and «read-only» icons will be.
• ☐ Lock (no drag and drop): prevent the reordering of tabs by drag-and-drop on the tab bar (unselected, drag-and-drop on the tab bar will reorder tabs)
• ☐ Darken inactive tags: change the fill-color on inactive tabs to a darker color
• ☐ Draw a coloured bar on active tab: indicate the active tab by adding a colored bar
• ☐ Show close button on each tab: add the close button to each tab’s entry on the tab bar
• ☐ Double click to close document: allows double-clicking on the tab to close the file
• ☐ Exit on close the last tab: if the last tab is closed, Notepad++ will exit (unselected, Notepad++ instead has one new file open)

• ☐ Hide menu bar (use Alt or F10 key to toggle): sets the main menu bar (File, Edit, Search, …) invisible; once invisible, it can be made temporarily visible by using the Alt or F10 key
• ☐ Hide right shortcuts ＋ ▼ ✕ from the menu bar (Need to restart Notepad++): makes the ＋ ▼ ✕ resources invisible (new to v8.4.5). Use this if you find the menu bar too «cluttered», or find those commands redundant.

• Width: [pulldown] Sets the width and shape of the typing caret:
  • 1, 2, 3: Width (in pixels) of the vertical-bar-style typing caret.
  • 0: Width of caret is 0 pixels, which means there is no visible caret.
  • Block: the caret will be a full-character-width rectangle; while typing, the caret block will appear where the next character will be typed; while selecting text, the caret block will be on the last character of the selection (so if you have text ABC: and select from A to C, the caret block will be on the C).
  • Block After: the caret will be a full-character-width rectangle; while typing, the caret block will appear where the next character will be typed; while selecting text, the block will be after the character position of the selection (so if you have text ABC: and select from A to C, the caret block will be on the :).
• Blink Rate: [slider] Adjust the rate at which the caret blinks, faster when moved left (F), slower when moved right (S)

• ☐ Default: wraps from the last visible column to the first visible column
• ☐ Aligned: wraps from the last visible column to the same indent as the start of the unwrapped line
• ☐ Indent: wraps from the last visible column to the next level of indent compared to the start of the unwrapped line

• ☐ None : no indicator for which line is the current line.
• ☐ Highlight Background : indicate the current line by highlighting the normal background color with the Settings > Style Configurator > Global Styles > Current line background color style’s Background colour
• ☐ Frame : indicate the current line by drawing a rectangle frame around the text of the current line, using the color defined by Settings > Style Configurator > Global Styles > Current line background color style’s Background colour, and with the rectangle-line thickness defined by the Width slider
  • Width: slider is used to set the width (in pixels) for the lines of the rectangle Frame for the current line
• (In v8.4 and earlier, this multi-control section was just listed as ☐ Enable current line highlighting in the list of checkboxes, and was the equivalent of ☐ being None and ☑ being Highlight Background.)

• Default: old behavior (CR and LF in reverse-video boxes)
• Plain Text«: Looks like normal text for CR, LF, and CRLF
• Custom Color: Opens the Style Configurator dialog to edit Global Styles > EOL custom color

• When you enable Dark Mode:
  • it will change the active theme to your previously-selected Dark mode theme (new to v8.4.8; previously it always switched to DarkModeDefault)
    • Reminder: changing the theme does not change your UDL colors, as discussed in the UDL and Themes section. If your UDL was colored to match some other theme, the colors will likely mismatch, and you will need to edit the UDL colors to make it match the DarkModeDefault theme.
  • it will change the coloring of the menu bar and toolbar (if visible)
    • Note: In v8.0 — v8.1.1, you must exit Notepad++ completely and restart for full Dark Mode. In v8.1.2 and newer, that is no longer necessary.
  • it may change your General > Toolbar settings to use one of the Fluent UI icon sets: if you already had a Fluent icon set selected, it will keep it; if you had the Standard icons: small selected, it will change to Fluent UI: small icons. Starting in v8.4.8, it will remember this the next time you switch to Dark Mode.
  • When you run in Dark Mode, the saved-file icon will not show up on your Tab Bar, whether or not you have Alternate Icons checked. However, a read-only file or an edited file will still show their icons (either different colored disks, or the lock icon and pencil icon, depending on Alternate Icons setting).
• When you enable Light Mode:
  • it will change the active theme to your previously-selected Light Mode theme (new to v8.4.8; previously it always switched to Default (stylers.xml))
    • Note: prior to v8.4.8, this was true even if you previously had a different theme selected before trying out Dark Mode. In older versions, if you would like a different theme, you will have to manually change to that theme after changing from Dark Mode to Light Mode.
  • it will change the coloring of the menu bar and toolbar (if visible)
    • Note: You must exit Notepad++ completely and restart in order to get the rest of the UI (like the top title bar) to be fully out of Dark Mode.
  • Prior to v8.4.8, it would leave your Toolbar settings with the same icon set as you had when you were in Dark Mode
• Notepad++ will track Settings > Preferences > General settings for the Tool Bar and Tab Bar separately for Light Mode and Dark Mode, as well as Settings > Style Configurator > Theme to allow you to have different tool bar icons or tab bar settings and themes in the different modes, so you can switch between them without having to manually make those changes (new to v8.4.8)

• Note: Dark Mode Tones affect most of the user interface, including main menus and toolbars and most of the dialogs, as of v8.1.3. (In v8.1.2, the Tones affected the menus and the Find/Replace/Mark dialog, but not the other dialogs.) The menu pulldown controls, as well as Windows-defined dialog boxes like Open and Save, have their colors defined by operating system settings, and Notepad++ Dark Mode settings will not affect them.
• ☐ Black tone, ☐ Black tone, ☐ Black tone, ☐ Black tone, ☐ Black tone, ☐ Black tone, ☐ Black tone => The dark color has a hint of that colored tone
• ☐ Customized tone => allows you to configure the tones of the individual components of the Dark Mode (even to the point of not being Dark anymore):
  • Top => choose the color of the menu bar and tool bar
  • Menu hot track => choose the color of the active menu bar entry
  • Active => choose the color of the active tab on the tab bar
  • Main => choose the color of the inactive tab(s) on the tab bar, as well as background colors for most dialog boxes
  • Error => choose the color for the error indicator on the Incremental Search bar
  • Text => choose the color for the menu bar entry names, and other normal text for most dialog boxes
  • Darker text => choose the color for the darker text for most dialog boxes
  • Disabled text => choose the color for disabled items in most dialog boxes (often referred to as «greyed out» or «disabled»)
  • Edge => choose the color for the vertical separator bars on tab bars (in the main window and in dialogs), and other edges (like the boxes around color selectors)
  • Link => choose the color for link text in dialog boxes (for example the hyperlink URL in the User Defined Languages dialog) (new to v8.1.3)

• ☐ Simple: shows a - if that section is not folded, or a + if it is.
• ☐ Arrow: shows a ▼ if that section is not folded, or a ▶ if it is.
• ☐ Circle tree: shows a ⊖ with a line to the end of the section if that section is not folded, or a ⊕ if it is folded
• ☐ Box tree: shows a ⊟ with a line to the end of the section if that section is not folded, or a ⊞ if it is folded
• ☐ None: shows no symbols and hides that column, even for lexers that allow code folding
  • The View menu folding commands still work, even when the Folder Margin Style is set to None

• [number-slider]: sets the width (in pixels) of the border around each view’s text editor; technically, it’s the gap between the light and dark portions of the sunken border, so a width of 0 will still have the light and dark lines for the sunken edge
• ☐ No edge: will remove the entire border, including the light and dark bars, so it no longer appears sunken

• This will allow one or more vertical edges to be displayed while editing your file, to help with line lengths or positioning text. This edge indicator can either be a vertical line, or a background shading beyond the edge. The color of the line or background shading will be taken from Settings > Style Configurator > Global Styles > Edge Color: Foreground colour.
• Multiple Vertical Edges: There is one box, which accepts zero or more numbers (as of v7.8.6):
  • If the box is empty, there are no vertical edges.
  • If there is one number ℕ in the box, there will be one vertical edge, after the column for the ℕth character.
  • If there is more than one number (separated by whitespace), then there will be a vertical edge at each of the given character columns.
  • ☐ Background mode: the vertical edge is usually a vertical line; if this option is checked, the vertical edge will be indicated by styling the background of the text to the right of the edge.
• Single Vertical Edge: in older versions of Notepad++, there was only a single vertical edge available, with more toggled options (v7.8.5 and earlier):
  • ☐ Show vertical edge: shows a vertical edge at the specified location, often used to indicate the right margin for manually setting the number of characters per line
  • ☐ Line mode: the vertical edge is indicated by a solid vertical line
  • ☐ Background mode: the vertical edge is indicated by styling the background of the text to the right of the edge
  • Number of columns: __ : sets where the vertical edge will be, in numbers of columns (characters) from the left edge of the page

• ☐ Display: shows the line numbers to the left of the text (renamed in v7.9.2, known as Editing > ☐ Display line number)
• ☐ Dynamic width: the line number display will adjust its width based on the number of digits needed (this matches the behavior prior to v7.9.2)
• ☐ Constant width: the line number display will have enough width for any line number in the document (new to v7.9.2)

• Left will add N pixels of padding between the left edge of the editor pane and the actual text (this is beyond the space allocated for the line numbering, and beyond the space allocated for the folding column). A bigger number leaves more of a gap, and thus less room for actual text.
• Right will add N pixels of padding between the right edge of the editor pane and the actual text. A bigger number leaves more of a gap, and thus less room for actual text.
• The Distraction Free setting changes the borders when Distraction Free Mode is active; a bigger number means more of the screen width is allocated to distraction free text, and a smaller number means less of the screen width is allocated to distraction free text.

• Windows (CR LF) / Unix (LF) / Macintosh (CR): newly-created files will use the normal Windows-style line ending, Unix/Linux/*nix-style line ending, or old Mac-style line ending. (Please note that modern MacOS X uses Unix-style line endings.)

• ANSI: characters are represented by a single 8-bit byte, and there are only 256 available code points
• UTF-8: this can encode any of the Unicode characters; it uses a single 8-bit byte for codepoints under 128, and two or more bytes for other characters
  • ☐ Apply to opened ANSI files: if you open an ANSI file, this allows it to be «upgraded» to UTF-8
• UTF-8 with BOM: this is the same as UTF-8 encoding, but saves the file with an extra Unicode character U+FEFF (which is encoded as 3 bytes in the file), which some applications use as an indication that it’s a UTF-8 file
• UTF-16 Big Endian with BOM: this encodes characters (even those with codepoints under 128) with exactly two bytes. «Big Endian» refers to the order the two bytes will be written to disk (with most-signficant byte first) (Prior to v8.0.0, it was shown as UCS-2)
• UTF-16 Little Endian with BOM: this encodes characters (even those with codepoints under 128) with exactly two bytes. «Little Endian» refers to the order the two bytes will be written to disk (with least-signficant byte first) (Prior to v8.0.0, it was shown as UCS-2)
• The final drop-down allows picking one of the old-style character sets (similar to using the main Notepad++ menu to select Encoding > character sets …)
• Note: the MISC > Autodetect character encoding option will also affect Encoding of existing files

• Follow current document: open/save dialogs will default to the current directory for the current file
• Remember last used directory: open/save dialogs will remember the last directory you used in the dialog on subsequent uses of the dialogs (regardless of where the current file is located). Note: the last used directory will only be updated when the Open or Save option is selected; if you Cancel or escape out of dialog, the last used directory will not be updated and will keep its previous value. Also, note that the last used directory is not remembered across runs of Notepad++: if you restart Notepad++, when you first initiate a Save As, it will prompt with the directory the notepad++.exe file is in.
• ___ ...: this entry box with no label allows you to browse to a default directory, and all open/save dialogs will start in that directory

• this is useful if you have files on a network drive which intermittently isn’t visible, and want files to remain in the Recent Files History list
• this is also useful if you like knowing what files were previously edited, even after you’ve deleted those files from the folder

• ☐ Make language menu compact will make submenus for languages that start with the same letter
  • Under normal circumstances, this makes the list of items in the Language menu much shorter: the standard 80+ languages will be reduced to about 20 submenus and a few standalone Language menu entries
  • For example, Perl and Python syntax highlighting would be selected through Language > P submenu, rather than directly from the language menu
• Available items ⇄ Disabled items: by moving a language into the Disabled items column, it will no longer show up in the Language menu list
  • If you have moved items to Disabled Items and have checked ☑ Make language menu compact, there may end up being empty letter-based subfolders in the Language Menu

• [Default] sets the tab behavior for the «default» condition
• normal sets the tab behavior for plain text
• other selections will choose which syntax-language the tab settings are being changed
• ☐ Use default value: not visible on the [Default] selection. For other languages, will use the values from the [Default] selection for that particular language
• Tab size : ___: sets the width of the tab stop. If the text uses literal TAB characters (Replace by space is turned off), pressing the Tab key will insert one TAB character in the file, but Notepad++ will display that character as a gap with a width of up to that many space characters. If the text is replacing TABs with spaces, pressing the Tab key will insert enough literal spaces so that the next character will start at the beginning of the next tab stop.
• ☐ Replace by space: when set, hitting the TAB key will insert that number of spaces; when not set, the TAB key will insert the literal ASCII TAB character
• For example: if Tab size is set to 4, and your line starts with one character, hitting the Tab key will either insert the single TAB character in the file which will be displayed as a gap the equivalent width of 3 spaces to bring the total characters up to a multiple of the tab size (tab size of 4, minus a single real character already there, means 3 character positions left to fill with the gap of this single TAB character), or (if Replace by space is turned on) will insert 3 literal space characters instead of the TAB character; either way, the next character on the line will start in the 5th column of the line.

• Note: this section of the preferences was renamed v8.1.4; it was known as Mark All in v8.0 — v8.1.3
• ☐ Match case: Mark All will be case-sensitive
• ☐ Match whole word only: Mark All will require a whole «word» (sequence of «word characters», as defined in the Delimiter preferences)
• This setting section applies to the Search menu’s Mark All submenu entries, and the equivalent right-click Context Menu’s Style all occurrences of token submenu entries, for applying «Style Tokens» to specific text.

• ☐ Enable: if you select a piece of text, Smart Highlighting will color all matching pieces of text. It will use the style defined in Style Configurator > Global Styles > Smart Highlighting
• ☐ Highlight another view: Smart Highlighting will also apply to the other «view» (when you have documents open in both of Notepad++ view panes)
• Matching: ☐ Match case: Smart Highlighting will be case-sensitive
• Matching: ☐ Match whole word only: Smart Highlighting will require a whole «word» (sequence of «word characters», as defined in the Delimiter preferences)
• Matching: ☐ Use Find dialog settings

• ☐ Enable: in HTML/XML files, clicking in or highlighting in an opening or closing tag (between the angle brackets) will highlight both the opening and closing tag. It will use the style defined in Style Configurator > Global Styles > Tags match highlighting
• ☐ Highlight tag attributes: any attributes inside the active tag will be highlighted using the style defined in Style Configurator > Global Styles > Tags attribute
• ☐ Highlight comment/php/asp zone

• ☐ WYSIWYG: same colors will apply to printing as you see in the editor
• ☐ Invert: black prints as white, light color prints as dark, and vice versa
• ☐ Black on White: prints black text on white background, no highlighting
• ☐ No background colour: same as WYSIWYG, except no background color is printed

• Click in one of the Left part, middle part, or right part for header or footer;
• either type in text for literal text, or use the Variable: drop-down and Add button to add one of the variables at the current caret position
  • Add Full file name path ⇒ $(FULL_CURRENT_PATH) in the input box ⇒ will print something like c:pathtofile.txt
  • Add File name ⇒ $(FILE_NAME) in the input box ⇒ will print something like file.txt
  • Add File directory ⇒ $(CURRENT_DIRECTORY) in the input box ⇒ will print something like c:pathto
  • Add Page ⇒ $(CURRENT_PRINTING_PAGE) in the input box ⇒ will print the current page number. (Sorry, there is no total-number-of-pages variable, so you cannot do page # of #.)
  • Add Short date format ⇒ $(SHORT_DATE) in the input box ⇒ will print something like m/dd/yyyy (possibly locale-dependent)
  • Add Long date format ⇒ $(LONG_DATE) in the input box ⇒ will print something like Day, Month ##, YYYY (possibly locale-dependent)
  • Add Time ⇒ $(TIME) in the input box ⇒ will print something like HH:MM AM (possibly locale-dependent)
• Font pulldown: use selected font for the header or footer (if left blank, use document’s default font)
• Font size pulldown: define font size for header or footer

• ☐ Fill find field in Find dialog with selected word: When checkmarked, invoking the Find Dialog will fill the Find What field with the currently-selected text; when not checkmarked, invoking the Find Dialog will not change the contents of the Find What field (reworded in v8.4.5; previously was Don't fill find field...)
  • ☐ Select Word Under Caret when Nothing Selected: When checkmarked, invoking the Find Dialog with no active selection will fill the Find What field with the text under the caret; when not checkmarked, invoking the Find Dialog with no active selection will not change the contents of the Find What field; if the option above is not checkmarked, this option will be un-checkmarked and cannot be toggled. (new to v8.4.5)

• ☐ Remember current session for next launch: the current session is the current list of open files. The next time you run Notepad++, it will open with that same list of files
• ☐ Enable session snapshot and periodic backup: this will auto-save your changed file once every N seconds to the listed directory (default to %AppData%Notepad++backup).
  • It is not possible to select this option without ☐ Remember current session ... also being active
  • This is also how you enable Notepad++ to remember unsaved changes
  • This will allow you to exit Notepad++ and resume, remembering changes to files that hadn’t been intentionally saved
  • When you exit Notepad++ with unsaved changes, Notepad++ will not ask you to save changes. It will just keep the periodic backup file, and reload from there rather than from the normal disk location for the file
  • If you want Notepad++ to ask to you save edited files every time you close the file or exit Notepad++, do not enable this option.
  • This is not a long-term backup option.
    • Every time you do a manual save, or every time you close the file while leaving Notepad++ open, this periodic backup of the file will be deleted
    • If there is a Notepad++ crash or Windows crash, it is possible for you to lose data
  • Periodic Backup file naming:
    • For named files (existing or saved files that have recent edits): the name of the backup file (in the listed directory) is filename.ext@yyyy-mm-dd_hhmmss, where filename.ext is from the main file. As soon as you manually save the file (so it’s written to disk in the real location), the backup goes away, because the purpose of the periodic backup is to save a copy of a file that you’ve edited but not saved. The timestamp part of the periodic-backup-name is based on the first automatic save after the last manual save. Example: if you saved a file at 8:10:00am, the backup would go away; then, at 8:12:30am, you type something but don’t save, so sometime within N seconds of that (8:12:30+N) it will periodic-backup-save and make a file with a timestamp about then – something like filename.ext@2021-06-23_081234. If you left for a while (or exited Notepad++ and reloaded) and came back at 12:34:56pm and typed another character, it would do it’s periodic-backup-save on that file again so the last-modified time of the backup would be updated), but the name of the periodic-backup file will remain the same.
    • For unnamed files (new files that haven’t been saved): the name of the backup file (in the listed directory) is new NNN@yyyy-mm-dd_hhmmss, where new NNN matches the name listed in the tab title. Since new NNN files are by definition not manually saved, the timestamp in the periodic-backup filename is based on when it did the first periodic-backup-save for that unnamed file.

• ☐ None: no additional backup will be performed when the file is saved
• ☐ Simple backup: it will save a copy of the file, with the same name and extension, but with .bak appended.
  • if the Custom Backup Directory is turned on and defined, it will save the simple backup in that defined directory; for example, if it is set as c:myCustomBackupFolder, then the file c:pathtofile.txt will save its simple backup as c:myCustomBackupFolderfile.txt.bak
    • Note: if you are editing two files with the same name which are in separate directories (like c:patha.txt and c:othera.txt), the Custom Backup directory will only contain one backup file (a.txt.bak) , with the contents of whichever file was saved most recently. Turning off Custom Backup Directory will eliminate this problem, because then the backup of a file will reside in the same directory as the original, so there will not be name conflicts on the backups.
  • if the Custom Backup Directory is not turned on and defined, it will save the simple backup in the same directory as the original file; for example, saving c:pathtofile.txt will save its simple backup as c:pathtofile.txt.bak
• ☐ Verbose backup: it will save a copy of the file, with a date-and-timestamp added to the filename (in the format yyyy-mm-dd_hhmmss) as well as the .bak extension.
  • if the Custom Backup Directory is turned on and defined, it will save it in that directory; for example, if it is set as c:myCustomBackupFolder, then the file c:pathtofile.txt file would be backed up as c:myCustomBackupFolderfile.txt.2021-06-28_073650.bak
    • Note: if you are editing multiple files with the same name which are in separate directories (like c:patha.txt and c:othera.txt), the Custom Backup directory will contain verbose backup files for nearly all individual saves; however, if it happens that both files were saved within the same second (by being really fast, or using Save All), then only_one_ backup file will exist with that timestamp (a.txt.2021-06-28-073722.bak), with the contents of whichever file happened to be saved last in that second. Turning off Custom Backup Directory will eliminate this problem, because then the backups of a file will reside in the same directory as the original, so there will not be name conflicts on the backups.
  • if the Custom Backup Directory is not turned on and defined, it will save it in .nppBackup subdirectory of the file’s current directory; for example, saving c:pathtofile.txt will create a backup called c:pathtonppBackupfile.txt.2021-06-28_073650.bak
• ☐ Custom Backup Directory: leave blank to put the backup in the same directory as the file; set to a directory to have all files backed up to one directory

• ☐ Enable auto-completion on each input: a dropdown selection will appear as you type; arrow keys will select various choices, TAB or ENTER will accept a choice, ESC will cancel auto-completion
  • ☐ Function completion: will auto-complete function names only, based on the keywords in the active auto-completion file
  • ☐ Word completion: will auto-complete words only, based on words that already exist in the current file
  • ☐ Function and word completion: will auto-complete both function names and words
• From the _n_th character: must type at least n characters before the auto
  • if ☐ Enable auto-completion on each input is checked, the _n_th character entry will be disabled (greyed out)
• ☐ Ignore numbers: won’t try to auto-complete when typing numbers
• Insert Selection: v8.2.1 added a new section
  • ☐ TAB: toggles whether or not TAB will accept your choice
  • ☐ ENTER: toggles whether or not ENTER will accept your choice
  • v8.2 and earlier behaved as if both have checkmarks; v8.2.1 and later defaults to having TAB checkmarked but ENTER not checkmarked, so the default behavior has changed.
• ☐ Function parameters hint on input: for applicable programming languages, will provide hints on what to type in a function parameter list
• Please note that if you use Edit > Auto-Completion > … menu entries to activate the completion features, you can force function or word or parameter completion, even when those checkboxes are turned off in the settings, and even if there aren’t enough characters typed to trigger the auto-completion.

• Will automatically insert the closing item for any of the checked pairs, or the three manually-chosen matched pairs
  • ☐ ()
  • ☐ []
  • ☐ {}
  • ☐ ""
  • ☐ ''
  • ☐ html/xml close tag
  • Matched pair [1,2,3]: __ __: define the open and close character(s) for three user-defined pairs

• ☐ Use default Word character list as it is: for Smart Highlighting (see above) or the Normal search mode in the Find and Replace dialogs, will use the normal alphanumeric rules for determining what constitutes a word for «Match Whole Word Only»
  • The default «word characters» include anything that Unicode considers alphanumeric, plus the underscore «_» character.
    • Includes: standard Latin characters, accented characters, letter-like symbols, superscript digits, and enclosed (circled) digits
    • Excludes: punctuation, mathematical operators, box drawing, arrows, emoji, or other such symbols.
• ☐ Add your character as part of word: sometimes, the default «word character list» isn’t sufficient for you; if you want other characters to be considered in «whole word only», add them here
  • The value should be a string consisting of all the additional characters you would like to be included as a «word character».
  • Spaces are liable to cause problems, and are not recommended to be present in this entry. If you try to add a space, the dialog box will show a warning message.
  • If you have characters in this box, then later come and delete them all out, it will not fully stop using those extra characters as delimiters until you switch the preference back to using the default word character list, or restart Notepad++.

• If you define open and close characters, Ctrl + MouseDoubleClick will select everything inside that delimiter pair
• ☐ Allow on several lines: Ctrl + MouseDoubleClick will work across multiple lines, instead of just on a single line

• ?: This box provides some helpful hover text (the introductory paragraphs in this manual section were derived from this hover text).
• ☐ Enable Large File Restriction (no syntax highlighting): when checked, there will be no syntax highlighting for large files, and the other options below will come into effect; when unchecked, there will be no Large File Restrictions active, and Notepad++ will apply all syntax highlighting and other features, even on large files, despite any performance degredation.
• Define Large File Size: ___ MB: Put in «size limit» which will trigger Large File Restrictions.
• ☐ Deactivate Word Wrap globally: When checked, Notepad++ will deactivate the Word Wrap feature for all files (whether large or small); when unchecked, Word Wrap features will not be affected when a large file is open.
• ☐ Allow Auto-completion: When checked, Auto-completion will still be available for large files. When unchecked, large files will not allow Auto-completion.
• ☐ Allow Smart Highlighting: When checked, Smart Highlighting will still be available for large files. When unchecked, large files will not allow Smart Highlighting.
• ☐ Allow Brace Match: When checked, the Brace Match feature will still be available for large files. When unchecked, large files will not allow Brace Match.
• ☐ Allow URL Clickable Link: When checked, the text that looks like a URL will be presented as a clickable link. When unchecked, large files will not turn URL text into a clickable link.

Settings on cloud: Allows saving your settings to the cloud instead of in the normal %AppData% or program-install folders. More information can be found in the Config files location

• ☐ No Cloud: saves settings in the normal location
• ☐ Set your cloud location path here: settings will go in the given directory, which is assumed to be in a folder that’s synced to your cloud-provider

Clickable Link Settings: Affects behavior of URLs in your document. (Moved in v7.9.2; previously in the Misc settings)

• ☐ Enable: text that appears to be a URL will allow you to double-click to open that URL in your default browser. When you hover over the URL, it will change to the style defined in Style Configurator > Global Styles > URL hovered
• ☐ No underline: will remove the underline normally present on a link
• ☐ Enable fullbox mode: the background color and foreground color will change on hoverover; when unchecked, just the foreground color will change (new to v7.9.2)
• URI Customized Schemes: Space-separated list of additional schemes to recognize as URLs (new to v7.9.2). The schemes ftp:// http:// https:// mailto: file:// are always recognized, no matter what the contents of this setting, so they do not need to be included in this entry box.

• ☐ Enable: hitting Ctrl+TAB will allow you to easily switch through all the open documents
• ☐ Enable MRU behavior: it will default to selecting the most-recently-used file (or «MRU», for short) in the Ctrl+TAB list
  • When checkmarked: Ctrl+TAB will take you to the most recently used document. Also, if you close the active tab, it will activate the most recently used tab.
  • When not checkmarked: Ctrl+TAB will take you to the next tab in the Document Switcher menu (the tab to the right). Also, if you close the active tab, it will activate the next tab in the Document Switcher menu (the tab to the right) or the last tab in the Document Switcher menu if the closed tab used to be the last tab.

• ☐ Peek on tab: if you hover over an inactive tab, it will give you a tiny «peek» at the document (a ultra-tiny font preview, similar to the document map), in a small popup near the tab bar
• ☐ Peek on document map: if you hover over an inactive tab, it will change the Document Map (View > Document Map) pane to show the preview of that tab, rather than of the active document

• [pulldown]
  • Enable: for the active file only, will check periodically to see if the file has been updated on disk, and will prompt to ask if you want to reload the file from the disk, or keep the version that’s currently in Notepad++
  • Enable for all open files: for all active files, check periodically to see if the file has been updated on disk
  • Disable: will not check to see if the file has been updated on disk
• ☐ Update silently: instead of prompting, will automatically reload the file from disk
• ☐ Scroll to the last line after update: will scroll to the end of the file after reloading from disk (otherwise, the caret and scrolled-location stays where it was before the update)

• DirectWrite will help in displaying characters even if the active font doesn’t have a glyph
• The modified rendering may affect the clarity or readability of the characters for some users or systems (for some users, it increases readability; for others, it decreases readability).

• Global override takes precedence over any other color or font defined elsewhere, and will mask any per-language settings.
• Unless you want to turn off all syntax highlighting for all the programming languages, you likely don’t want to use the Global override settings.
• Do not use this if all you are trying to do is set the color for Normal Text files (.txt): for those, use the Default style below.

• As described previously, Default Style is used to set the color for Normal Text (.txt files, and anything else that isn’t highlighted by a lexer).
• Also, as described a few paragraphs earlier, the highlighters for specific languages will inherit from this Default Style for things like font and possibly color, if there is no value defined for that language.

Settings > Import > Import Plugins… will ask you to navigate to a plugin DLL anywhere on your filesystem; it will then copy that DLL into the appropriate folder so that the next time you run Notepad++, the application will load that DLL as a plugin (assuming it is a valid plugin DLL). This is an alternate way to install a single-DLL plugin, rather than the other installation methods of using Plugins Admin or manually putting the DLL and associated files in the right location. (This menu entry will not work on its own if the plugin requires more files than just its DLL.)

Settings > Import > Import Style Themes… will ask you to navigate to a style theme XML file, and will put it in the appropriate folder so that the next time you run Notepad++, the application will include it when you use the Style Configurator, the new theme will be listed in the «Select theme:» pulldown.

Settings > Edit popup ContextMenu will open the contextMenu.xml configuration file, so that you can edit your context menu, following the advice for editing configuration files.

The Save Session dialog will have a ☐ Save Folder as Workspace checkbox, which will be active (able to be toggled) when you have a Folder as Workspace opened. If the checkbox is checked, the current Folder as Workspace will be included in the saved session; otherwise, the session will not include any Folder as Workspace information. (Requires Notepad++ v7.9.3 or newer.)

When saving a new file or otherwise running the Save As dialog, there is an ☐ Append extension checkbox. If checked, Notepad++ will automatically append the first extension listed in the selected Save as type; otherwise, the extension must be manually included in the File name field. (This toggle is new to v8.0.0, and replaces the Preferences > MISC > ☐ Set Save dialog file extension filter to *.* or Set Save dialog file extension filter to .* for Normal Text preferences for setting the save dialog file extension to *.* that were present in prior v7.9.1-v7.9.5; in v7.9.1, that *.* option replaced the setting in the Default Directory section called Use new style dialog which influenced how extensions were added or not as it toggled the Save As dialog from an ancient Windows Save-As dialog to a somewhat more modern dialog.)

Change the number of expressions that can be saved in the Find/Replace dialog’s Find, Replace, Filters, and Directory fields. They are set in the <FindHistory ...> tag inside config.xml, using the attributes:

• nbMaxFindHistoryFind => changes the number of Find what entries that are saved in the history (0 .. 30, default = 10)
• nbMaxFindHistoryReplace => changes the number of Replace with entries that are saved in the history (0 .. 30, default = 10)
• nbMaxFindHistoryPath => changes the number of Directory entries that are saved in the history (0 .. 30, default = 10)
• nbMaxFindHistoryFilter => changes the number of Filter(s) entries that are saved in the history (0 .. 20, default = 10)

Changing the command-line interpreter used: by default, File > Open Containing Folder > cmd will launch the cmd.exe command-line interpreter. If you have a preferred command-line interpreter (such as powershell), you can add another <GUIConfig...> tag inside the <GUIConfigs> section: