BBEdit 13.1.2 Release Notes

Note: BBEdit 13.1.1 was released only into the Mac App Store to address a specific issue encountered by Mac App Store users with active subscriptions.

For details on all the new features and enhancements available in BBEdit 13.1, please see the release notes for BBEdit 13.1.

Because BBEdit 13.1 builds on features that were added in BBEdit 13.0, please take a few moments to review the release notes for BBEdit 13.0, as well as its updates. Those notes are available in the release notes archive.

For detailed information on using any of BBEdit's features, please refer to the user manual (choose "User Manual" from BBEdit's Help menu).


BBEdit 13 requires Mac OS X 10.14.2 or later, and is compatible with macOS 10.15 "Catalina".

If you are using macOS 10.14 "Mojave", please make sure that you have updated to the latest available OS version (10.14.6 or later).

If you are using macOS 10.15 "Catalina", please make sure that you have updated to the latest available OS version (10.15.5 or later).


If you have been using BBEdit 13.0 in Free Mode, starting BBEdit 13.1 will reset your 30-day evaluation period, so that you can have a full trial of the new features.

If you have previously purchased a license from us for BBEdit 12 or older, you will have a full 30-day evaluation period in which to try out BBEdit 13's new features. License upgrades are available at a discount for existing customers. Please see the BBEdit upgrades page for information and instructions.


This update contains only fixes for reported issues.


  • Fixed bug in which the YAML coloring would get confused by the use of "&value" or "*value".

  • Open File by Name will now search for files in nested Xcode projects referenced by the currently active project (if there is one).

  • Fixed crash which would sometimes occur when closing a document containing a character set declaration that didn't match its actual text encoding, and opting to save, and clicking the "Save Anyway" button, and with the "Restore unsaved changes" application preference turned off.

  • Fixed bug in which the "#TITLE#" placeholder didn't get replaced with the title entered from the "New Document" dialog, when using a page template other than "Default Page".

  • Fixed bug in Unix shell script coloring in which "<<" followed by a number would be treated as the start of a heredoc (which was not likely to ever end).

  • Made a change to the Markdown syntax coloring so that a line break in the middle of an "inline code" run (i.e. "...") no longer causes confusion.

  • Fixed bug in the Unix Shell Script language module, in which backslashed characters were not correctly handled within parenthesis expressions. This would lead to unexpected syntax coloring and (occasionally) function scanning/folding behavior.

  • Made a change to improve performance for certain display calculations involving large quantities of display ranges (such as highlighted matches) and/or complicated documents.

  • Fixed bug in which indented heredoc delimiters in the Unix shell script module weren't handled correctly.

  • Made a change so that Shift-Tab will left-shift the line containing the insertion point (or sub-line selection range) when the "Allow Tab key to indent text blocks" preference is turned on.

  • Increased the default sidebar width slightly.

  • Corrected reporting of errors related to missing Canonize data files (and other related errors) while running a "Canonize" operation in a text factory.

  • Removed file references from the built-in Python tags file, since there's no guarantee that they'll be valid on any given system. Therefore, those symbols will still be colored, but are not included in "Find Definition" results.

  • Fixed bug in which the bbfind tool would not output its search results.

  • Fixed a bug in which the range of tick mark highlights in the vertical scrollbar was not laid out correctly over the entire height of the scrollbar.

  • Fixed bug in which live-match highlighting via the Find window would sometimes draw in the wrong place, when the window being searched had either soft-wrapped lines or folded lines, and a selection range.

  • Fixed bug in which Esc-backspace didn't function correctly to delete a word.

  • Fixed bug in which Esc-< and Esc-> would select the range of text from the current selection to beginning/end of file, rather than moving the insertion point there.

  • Made a change so that the selection range remains visible when it overlaps a difference range on display in a Differences window.

  • Fixed bug in which certain template string forms would break folding in JavaScript files.

  • The JavaScript language module will now generate folds for strings that cross line boundaries.

  • Fixed a bug which prevented certain startup-time notifications (such as "The Shift key was held down") from appearing.

  • Fixed bug in which selector completion in CSS documents did not include many selectors that should have been present.

  • Updated the JavaScript function scanner to support "modern" callouts:

    /* MARK this is a named marker */
    /* FIXME this needs to be fixed */
    /* FIX-ME is treated like FIXME */
    /* NOTE is a note for the reader */
    /* NYI stands for "not yet implemented" and is treated as a to-do */
    /* REVIEW means someone needs to look at this */
    /* TODO when I get around to it */
    /* XXX is another form of NOTE */
    /* ??? I have a question here */
    /* !!! I smell a wumpus */

    Callouts are case-sensitive and must be all upper case in order to be detected.

  • Fixed a bug in which the entry for the "Run Unix Command" submenu was not present in the Menus & Shortcuts preferences, so that item could not be hidden if desired.

  • Fixed bug in which opening a suffix-less file using the built-in FTP/SFTP support would open it outside of the application, or into a text window without recognizing that it had been opened from a remote source.

  • Restored the ability of the Unix Shell Script language module to guess the language when the filename extension is absent or insufficient.

  • Fixed bug in which quoted PHP heredoc, and PHP nowdoc delimiters would interfere with correct folding.

  • Fixed bug in PHP syntax coloring when processing quoted PHP heredoc (and nowdoc) delimiters.

  • Fixed bug in Unix Shell Script language support, in which strings containing variable expansions would end prematurely if the expansion was immediately followed by an escaped quotation mark.

  • Added some armor plating at the site of a nonreproducible crash during "Find in Reference".

  • Improved behavior in the Multi-File Search window: if you check the "Open Text Documents" or "Open Editing Windows" item, BBEdit remembers that you did so, and on subsequent invocations of the search window, the top-level item itself is checked.

  • If you check an item under "Open Text Documents" in the Multi-File Search window, on subsequent invocations in the window, the appropriate item under "Open Text Documents" will be checked (assuming the document is still open), rather than under "Open Editing Windows".

  • Fixed bug in which trying to save a local copy of a "synthetic" document (one opened from a source not actually backed by a disk file, such as the result of using an https URL with the bbedit tool or Open File by Name) would fail.

  • Fixed bug in which the Live Search status would indicate "Searching..." after clearing the search string.

  • Made a change so that if the SFTP service unexpectedly quits while BBEdit is waiting to receive data, the application will no longer stall forever while waiting for data to arrive. (There is a specific error code for this case.)

  • Fixed a case in which the application could conceivably wait forever for a response from an SFTP server while sending or waiting for data.

  • Restored completion in the Unix Shell Script language module to working order.

  • Fixed a bug in which absolute references to page resources were not resolved correctly (relative to the site root) when using "Preview in BBEdit" with a correctly configured project.

  • Fixed bug in which folder-backed menu items which were symlinks to items outside of their respective support folders would fail to display their paths in the "Go" command window.

  • Fixed bug in the lipsum generator in which generating paragraphs with <p> separators would subsequently cause individual word or sentence generation to have each element wrapped in <p> separators as well.

  • The Open File by Name window now makes more of an effort to display an appropriate icon in the list when entering a remote URL in the search box.

  • Although you're unlikely to ever need it, there's an expert preference for suppressing tick marks in the scrollbar for differences:

    defaults write com.barebones.bbedit ShowTickMarksForDifferences -bool NO

    This takes effect for the next Differences operation.

  • Fixed bug in which the project sidebar list didn't provide appropriate data to the OS Services system during a contextual menu operation.

  • Added credit to the About box for HTML Tidy.

  • Fixed bug in which the sidebar width saved using "Save Default Text Window" was not applied correctly when creating a new text window.

  • Fixed a reported crash when a Multi-File Search results window closed itself automatically after dismissing the "no results found" sheet.

  • Fixed bug in which opening the Find window would sometimes fail with a -1708 error, after having recently closed it. This would happen most often when a very large document was the search target when the Find window was closed after making changes to the search string or options.

  • Cleaned up the behavior of "Find in Reference" with Python symbols for which no reference information was available.

  • Updated the Support folder “Read Me.txt” file to fix a formatting goof and https-ify some links.

  • The "run" commands on the #! menu are disabled for shell worksheets, in order to avoid confusion (worksheets are an interactive execution environment, not suitable for script authoring).

  • Made a change to prevent the application from stalling when the system recent-files limit is set to an abusively large number.

  • Fixed bug in which the summary text in the Multi-File Search window didn't update when bringing the window to the front after changing the relative ordering of any two open projects.

  • Fixed bug in which a custom name ("Rename in Project") for an FTP/SFTP item would be lost when saving the associated file.

  • Fixed a crash in the crash reporter which would occur if you denied it access to Contacts when prompted.

  • Fixed bug in which in-application notifications weren't presented.

  • BBEdit will now report a specific error if you try to connect via SFTP and your network connection is down or disconnected (based on an "unknown error: 0" being reported by SSH).

  • Fixed bug in which manually reloading a live preview window didn't allow JavaScript alerts to present.

  • Fixed a bug in which JavaScript string prompt dialog boxes were not run as sheets on the parent window, as had been intended.

  • Made a change so that "auto" and "none" are usable as synonyms for "(automatic)" and "(none)" for language names in the AppleScript interface and on the command line (for the -m flag to bbedit).

  • Made a change to limit the quantity of text that BBEdit provides to language modules for guessing. This improves performance when opening very large files with unmapped file name extensions.

  • Made a change to significantly improve performance when opening very large files with few (or no) line breaks.

  • Fixed bug in which closing a document via the scripting interface from outside of the application didn't immediately release certain resources that were in use.

  • Put some code in to guard against a reported (but not reproducible) crash after dragging items into collections in a project document's sidebar.

  • Fixed bug in which saving a document via the confirmation panel would put up a system Save panel when you clicked "Save", in the case of switching to another document in a Disk Browser window that was browsing a Zip archive or tarball.

back to top