Version History (Testing Channel)

• Add auto-complete support for Guillemets (Pull 973)
• Improve Touch Bar (Pull 978)
• Implement x-macdown URL scheme (Pull 985)
• Add note on turning on Webkit developer extras (Pull 1005)
• Check for .md file existence on link click (Pull 1086)
• Upgrade Mermaid (Pull 1137)

• Fixes the preference pane bug.

This is (almost) the same as 0.7.2d137. New features introduced in testing channel now land on stable channel, including

• Toolbar support.
• MacBook Pro Touchbar support.
• Allow images to be dropped directly into the editor. This will insert the image syntax ![]() with the image’s local path.
• Graphviz graph support.
• Translation of new languages.

New features

• Retina-ready touchbar support.

Enhancements

• Improved styling in printed output (including PDF).

Bug fixes

• Mermaid graphs duplicate in render result.

New features

• Graphviz graph support.
• Allow images to be dropped directly into the editor. This will insert the image syntax ![]() with the image’s local path.

Enhancements

• Scrolling sync is greatly improved to the header level.
• Speed boost.

Bug fixes

• HTML can now be correct copied.
• Large document with many LaTeX equations no longer crash MacDown.

New features

• Experiemental toolbar and new MacBook Pro Touchbar support! Please try them out and tell us what you think on Gitter and/or GitHub.
• Many new languages! I lost count of them already, just try and see for yourself. :p

Enhancements

• Lots of cleanup on editor initiailsation to make it load faster and reduce flicker.
• $ is now (finally!) escapable in editor.
• Sublist items now line up better in the editor.

Bug fixes

• Obscure crash when highlighting the editor.

Fix some over-translation issues with package meta-data. This prevents the About dislog showing incorrect information in translated UI.

MacDown now has i18n! Thanks to all people giving feedback on this issue, and all our contributors on Transifex. Visit our project page if you would like to help translating MacDown to your language:

https://www.transifex.com/macdown/macdown/

Bug fixes

• Some usability issues with the CLI utility.
• A missing resource in the bundle.
• Unhideable panes on new window after a panel is hidden, the window closes, and a new window is opened.
• New file not created when being opened.
• The preference window layout is broken if the font selector gets too large.
• MathJax CDN shut down in May 2017. Math support is now provided via CDNJS.

Enhancements

• UI for CLI utility installation. This is super handy! Kudos to @niklasberglund.
• Piping to the CLI utility now creates a new document with the piped content.
• Do not select ext in save dialog if possible. This also makes the “hide extension” checkbox work.
• Suggest filename only when doc have no fileURL is set. This fixes a problem with the CLI utility if you provide a non-standard extension.
• Launching files from CLI does not always open a new document now. A new document is created only when necessary.
• Image caches are now less an issue in the preview. This is done by disabling WebCache’s caching via private API. See #746 and #747 for discussions about a more long-term solution to this.

Misc

• Bumped various dependencies to fix upstream bugs. The build process is also improved by this so you can clone and build from source more easily.

MacDown now support translation! Visit our Transifex project to request for new languages, and contribute on translations.

Bug fixes

• Suggest extension completion on save only if none is set.
• Panes in new windows could become hideable under certain circumstances.
• CLI utility shows wrong usage example.

New features and improvements

• Preference pane to inspect CLI utility installation status, and a shortcut for quickly installing it to a default location.
• Image caching in preview is disabled to make it able to reflect external image modification.
• Save dialog now only selects the stem by default, making it easier to modify the file name.
• Support piping text to the CLI utility to create file.

Same as 0.6.3, but disable the DOM-replacing thing. Sorry for the trouble. :(

Bug fixes

• Crash when inserting colon in reference (ported from ali-rantakari/peg-markdown-highlight).
• Crash when asset path is not valid.
• Crash when certain editor theme is used.
• Non-existing documents not being launched by CLI utility when MacDown is running.
• Document being opened again and again when using CLI utility.

New features

• Improve rendering performance and caching by dynamic DOM-replacing instead of reloading the page.
• Avoid presenting a save dialog when closing an unnamed, empty file.
• Add meta tag to make HTML output responsive on mobile.
• Improve hard line break syntax example in help file.

Fixed command line utility to correctly load file contents.

Bug fixes

• Front-matter detection for file using line endings other than LF.
• Code blocks with certain languages causes exceptions when being highlighted.

Minor features

• Styling for <kbd> tags are added to all themes.

  Important Note: You need to manually remove previous CSS files from ~/Library/Application Support/MacDown/Styles for the new style files to be applied.

• You can now configure a preferred marker for the unordered list hotkey (⇧⌘U).

• The error message is now clearer when clicking on a hyperlink to a non-existent target in the preview pane.

• MacDown now handles files with .markdown extension.

• MathJax processing messages are now hidden in the preview pane.

Major features

• Experimental auto-reload feature when file is changed in another MacDown document, or outside MacDown.

Minor features

• Styling for <kbd> tags are added to all themes.

  Important Note: You need to manually remove previous CSS files from ~/Library/Application Support/MacDown/Styles for the new style files to be applied.

• You can now configure a preferred marker for the unordered list hotkey (⇧⌘U).

• The error message is now clearer when clicking on a hyperlink to a non-existent target in the preview pane.

• MacDown now handles files with .markdown extension.

• MathJax processing messages are now hidden in the preview pane.

This update adds new functionalities to MacDown, and provides fixes to bugs and usability issues, etc. Recommended for all users.

Major features

• Experimental plug-in architecture. MacDown can now accept plug-in bundles to add functionalities at runtime.
• Scripting support. You can now use AppleScript and JavaScript (JXA) to automate interaction with MacDown programmatically.

Resolved bugs

• Fixed a crash in the command line utility if filenames contain special characters.
• Fixed strange behaviours when toggling block syntaxes in a document caused by unintended integer overflow and underflow.

Minor features and enhancements

• MacDown now updates the document content when file is edited with an external application. This prevents you from accidentally saving an older version of the document.
• Convert lines to ordered list.
• The save dialog now always appends .md automatically when saving an untitled file. You can still change the extension if you want.
• The editor is now read-only when you hide it. Hotkeys still work (this is considered a bug that should be fixed in the future).
• The HTML document is now rendered through Handlebars.

• Add scripting API for AppleScript and JavaScript for basic OS X automation support.
• Add Format → Ordered List.
• Fixed: Update document on save to prevent overwriting external modifications.
• Fixed: Check for over and underflows to avoid unexpected behaviours when applying block syntaxes.
• Fixed: Percent-escape command arguments to fix crashes when paths contain URL-reserved characters.
• Enhancement: Include .md extension when saving untitled files.

• Fixed crashes when the editor font is invalid.
• Sparkle is re-bundled to make sure we're using 1.13.1.

IMPORTANT SECURITY RELEASE; PLEASE UPGRADE NOW.

This update addresses the security issue found in Sparkle, the automatic upgrade framework used by MacDown. Please upgrade as the earliest possible chance.

You can read more about the security issue at https://github.com/sparkle-project/Sparkle/releases/tag/1.13.1.

• Fixed a bug causing text being incorrectly trimmed when toggling block syntaxes.
• Fixed a bug causing crashes when entering Versions.
• Fixed accessory display in highlighted code blocks.
• Tried to fix automatic updates again.
• Spelling fixes.
• Updated Prism to 73b7135 with a lot of new languages.

• Fixed: Could not load HTTPS images.
• Enhancement: Allow YAML front-matter to end with ....
• Upgraded Prism to 05a2a15.

• Fixed: Preview not rendering under OS X 10.11 (El Capitan).
• Enhancement: Better editor font size calculation.
• Upgraded Prism to 1ab4619.

• Enhancement: Math block highlighting in editor.
• Fixed 10.11 El Capitan compatibility.
• Updated syntax highlighting (Prism @ 513137c).

• Fixed: Line numbers in code blocks not showing without a language tag.
• Fixed: Out-of-bounds read when toggling markup in an empty line.
• Fixed: Delete selection behaviour is shadowed by unindentation.
• Enhancement: Make table-of-content rendering preference global.
• Enhancement: Implement accessory view for code blocks.
• Enhancement: More consistent behaviour when toggling block-level markup.
• Update Prism to ee463e8:
  • Make line numbers plugin work without highlighting.
  • Misc. rendering glitches fixed.
  • Syntax improvements.

• Fixed: Preview becoming plain text when clicking on hyperlinks.
• Fixed: Incorrect CLI utility behaviour when a MacDown instance is running.
• Fixed: Crash on resource lookup failures.
• Enhancement: Blockquote and indentation shortcuts now work for empty lines.
• Enhancement: Add a class attribute to the TOC HTML list for styling.
• Enhancement: Always add a language-* class to code blocks, even if syntax is not specified (language-none), as recommended by Prism.

Freeze Sparkle under 1.8 for compatibility.

• Add toggle to zoom preview content based on editor font size.
• Disable horizontal scrolling in editor to prevent word wrapping from failing.
• Upgrade Hoedown to 3.0.3, fixing incorrect parsing in tables and comments.
• Upgrade Sparkle to 1.10. May fix multiple issues with the updater window. Feedback needed.
• Upgrade Prism to f28a3e0.
  • The following new syntaxes are included:
    • Brainfuck
    • Keyman
    • Makefile
    • REST
    • SASS
    • Smalltalk
    • Stylus
    • VHDL
    • Wiki
    • YAML
  • Syntax alias "sass" has been removed in favour of the SASS syntax.
• Other dependency upgrades.

• Add toggle to zoom preview content based on editor font size.
• Disable horizontal scrolling in editor to prevent word wrapping from failing.

Fix crashing on OS X 10.8 by disabling preview pane tracking.

• Better bundled documentation. Thanks to @ohthetrees!
• Bug: Editor size limiting breaks if window resizes.
• Enhancement: Preview position is now kept when re-rendering.

• Revised help file from @ohthetrees.
• Proposed fix for scrolling issues Retina Macs (revised from v0.4.3d13).
• Fixed: Preview content flickers constantly.
• Fixed: Editor font and line spacing configs are not applied properly.
• Fixed: Divider between panes is obscure if the background colours are too similar.
• Enhancement: Unknown document’s window now adapts sizes of untitled documents.
• Enhancement: It is now possible to disable auto line prefix insertion in Preferences.

• Proposed fix for laggy scrolling on Retina screens.
• Fixed: Preview content flickers constantly.
• Fixed: Editor font and line spacing configs are not applied properly.
• Fixed: Divider between panes is obscure if the background colours are too similar.
• Enhancement: Unknown document’s window now adapts sizes of untitled documents.
• Enhancement: It is not possible to disable auto line prefix insertion in Preferences.

• Fixed: Anchor links with the current document as target do not work in preview pane.
• Fixed: Incorrect containing directory when saving an auto-created unsaved documents with fileURL set.
• Fixed: Editor width limits are not applied correctly on launch.
• Fixed: JavaScript exception in exported HTML files.
• Fixed: Re-rendering not triggered when certain options change.
• Enhancement: Contents in code blocks are now excluded from word counts (but not character counts). A inline code span now counts as one single word.
• Enhancement: Optionally show line numbers in highlighted code blocks.
• Enhancement: Automatically create non-exited document instead of showing an error when clicking on links.
• Enhancement: Appearance of the divider between editor and preview pane is now more subtle, and hides itself when either editor or preview is hidden.
• Enhancement: Better word counter behaviour on launch.
• Enhancement: More new languages in code blocks with Prism update. New language alias: jl for julia.
• Performance improvements.

• Fixed: Math syntax preference change does not trigger re-parsing.
• Enhancement: The divider between editor and preview is now drawn according to the editor or preview’s background.
• Enhancement: Minor re-phrasing of some preference options.

• Fixed: Scroller sync does not work in documents.

This is a feature update that adds additional functionalities and fixes problems in previous versions. Recommended for all users.

See blog post for detailed descriptions about new features.

• Upgrade to Hoedown 3.
• Enhancements and bugfixes with PAPreferences 0.4 upgrade.
• New syntax highlighting languages from Prism upgrade.
• Command line utility inside SharedSupport directory.
• Fixed: Segmentation fault when saving a blank document with "add newline at EOF" turned on.
• Fixed: Cursor moves when inserting trailing newline.
• Fixed: Conflicts between input methods and auto-completion.
• Fixed: New document windows always open maximised.
• Fixed: Exported PDF cuts out contents.
• Enhancement: Allow completion even if a matching character follows.
• Enhancement: Option to disable auto blank document creation when launching without open documents.

• Command line utility at MacDown.app/Contents/SharedSupport/bin/macdown. Works like subl in Sublime Text:

  • Open documents in MacDown with filenames passed to it. If a file with the name does not exist yet, a new document is created; you can then save it to the destination (MacDown sets the path for you based on the argument passed).

• Fixed: Segmentation fault when saving a blank document with “add newline at EOF” turned on.

• Enhancements and bugfixes with PAPreferences 0.4 upgrade.

• Upgrade to Hoedown 3.
  • Fixes escaping in math equations.
  • Fixes unescapable sequences including ==highlight== and others.
  • Many more.
  • Backward-incompatibility: inline $$ pairs will now be parsed as inline math automatically based on context. You must put the $$ pair in its own block if you need block math now.
• Fixed: Conflicts between input methods and auto-completion.
• Enhancement: Allow completion even if a matching character follows. Previously if you insert ( between a () pair, the inner paranthesis is not auto-completed. Now it is.

This version fixes various bugs and adds functionalities. Recommended for all users.

Thanks to Alexander Käßner for both the new document icons and improved Retina preference pane icons.

• Fixed: Broken TOC support.
• Fixed: Aut-completion causes later delete operations to act erroneously.
• Fixed: Programmatic text replacemenet (including insertion and deletion) breaks undo chain.
• Fixed: Word counts are not calculated correctly when first becoming visible.
• Fixed: Unintuitive cmd-return behaviour.
• Fixed: Crashes caused by unbalanced flushing in preview pane.
• Fixed: Cyclic referencing in blocks causing memory leaks.
• Enhancement: New documents are now shown maximised on creation.
• Enhancement: Scroll past end support.
• Enhancement: Auto-numbering in ordered list can now be disabled.
• Enhancement: Optional "ensure newline at end on save" support.
• Updated Prism with Scheme and better NSIS support.

• Fixed: Overly-narrow page margins and cut-off contents when exporting to PDF.
• Fixed: Broken internal links in TOC.
• Fixed: Unintuitive cmd-return behaviour.
• Updated Prism with Scheme and better NSIS support.

• Fixed: Broken TOC support.
• Fixed: Aut-completion causes later delete operations to act erroneously.
• Fixed: Programmatic text replacemenet (including insertion and deletion) breaks undo chain.
• Fixed: Word counts are not calculated correctly when first becoming visible.
• Fixed: Crashes caused by unbalanced flushing in preview pane.
• Fixed: Cyclic referencing in blocks causing memory leaks.
• Enhancement: New documents are now shown maximised on creation.
• Enhancement: Scroll past end support.
• Enhancement: Auto-numbering in ordered list can now be disabled.
• Enhancement: Optional “ensure newline at end on save” support.

This is a bug-fixing version. Recommended for all users.

• Fixed: Preview “jumps” when math is turned on.
• Fixed: Text in <title> tag is included in word counts.

This is a bugfix version. Recommended for all users.

• Fixed: Deeply nested constructs are not rendered correctly.
• Fixed: Preview pane accepts drag-n-drop into it.
• Fixed: Editor auto-completion conflicts with built-in quote substitution.
• Fixed: Word counter does not update if preview is hidden.
• Fixed: High CPU usage under certain circumstances.
• Fixed: Inline styles and scripts are malformed in exported HTML.
• Fixed: Hugh margin when printing and exporting to PDF.
• Enhancement: Performance boost when resizing by eliminate unnecessary rendering.
• Enhancement: “Toggle editor pane.”
• Enhancement: Remapped keyboard shortcuts that do not conflict with system shortcuts.
• Enhancement: Prism update.
  • Better support to SQL.
  • New syntaxes: Git and Apache conf.
  • General bug-fixes and enhancements.
• Enhancement: Claim .md extension with UTI export.

• Fixed: Window moving/resizing is very slow.
• Fixed: Poor performance on Retina displays.
• Fixed: Poor performance when switch word counter and/or editor styles.
• Fixed: CSS and JavaScript assets miss trailing braces when exporting.

This is a bugfix version. Recommended for all users.

• Fixed: Window moving/resizing is very slow.
• Fixed: Crash if the document window is moved/resized when preview is loading.
• Fixed: Background glitch at the bottom of the editor is scrolled very quickly to the bottom.
• Fixed: HTML copy when preview is hidden yields incorrect results.
• Fixed: URLs in image constructs (![]()) are highlighted as links.
• Fixed: Preview does not refresh with MathJax on if the Internet is slow or unavailable.
• Enhancement: Reject files that cannot be decoded with UTF-8.

This is a bugfix version. Recommended for all users.

• Fixed: Copy-pasting to non-Safari browsers loses format.
• Fixed: Math syntax causes preview to jump on re-rendering.
• Fixed: TOC links do not work.
• Fixed: List item completion is broken.
• Fixed: Cmd-Left jumps to logical instead of graphical line start.
• Fixed: Printing does not work if document is longer than two pages.
• Fixed: Editor does not load large document on app startup.
• Enhancement: “Export as PDF” function.
• Enhancement: Suggest file name based on front-matter is possible.
• Enhancement: Reload preview and editor when theme/CSS is reloaded.
• Enhancement: “Limit editor width” option switch.
• Enhancement: Solarized editor themes and preview styles.
• Enhancement: Update Sparkle to 1.7.
• Enhancement: Update Prism to 2014-08-17.

This is a bugfix version. Recommended for all users.

• Fixed: Endless recursion on editor bound changes, causing editor flickering and/or application crash.
• Fixed: Auto link detection misjudges certain patterns as links and cannot be turned off.
• Fixed: Contents in <script> and <style> HTML tags are treated as text by the word counter.
• Fixed: ⌘← jumps to logical line start instead of visual left end of line.
• Fixed: List item auto-completion misjudges tab indents.
• Enhancement: Experimental table of content support.
• Enhancement: Revised “Hide Preview Panel” behaviour.
• Enhancement: Editor-preview ratio can now be restored after preview is hidden.
• Enhancement: Files can now be saved in arbitrary extensions.
• Enhancement: Pressing tab when selecting text now acts the same as ⌘].
• Enhancement: Replace : and / with - when auto-detecting file names.
• Various bug fixes and minor enhancement.

This is a development update. Update at your own risks!!

• Fixed: Crash due to repeated bound change notifications.
• Fixed: Phantom word count when MathJax is configured with $...$ support.
• Enhancement: Experimental TOC rendering support.
• Enhancement: Disable underscore when MathJax is on to avoid syntax conflicts.

This is a development update. Update at your own risks!!

• Fixed: Intentation error when completing list items.
• Fixed: Inline formatting and other errors in help.md.
• Fixed: Erroneous link detection in editor.
• Enhancement: Preview geometry restoration after hiding.
• Enhancement: Better menu item behaviour.
• Enhancement: Tab indents selection.
• Enhancement: “:” and “/” in suggested file name are now substituted with “-“.
• Enhancement: Allow files to be saved in arbitrary extensions.

This is a bugfix version. Recommended for all users.

• Fixed: Obsolete images in help.md

This version fixes various bugs and adds functionalities. Recommended for all users.

Thanks to Alexander Käßner for the new preference pane icons! See the blog post for information about selected new features.

Other updates include:

• You can now switch between stable and testing release channels in-app.
• Fixed: Crash during closing a document and/or quitting the application.
• Fixed: Printing produces blank documents.
• Fixed: Stucked scrollbars when navigatiing over very large blocks.
• Fixed: Unable to use as external editor of other applications.
• Fixed: <iframe> tags are handled incorrectly.
• Fixed: Auto link detection in editor destroys IME.
• Enhancement: Optional support for LaTeX-style $...$ inline math syntax.
• Enhancement: Experimental support for GFW-style tasklist syntax.
• Enhancement: Preview pane visibility, size, and position options.
• Enhancement: More language aliases for code block syntax highlighting.
• Enhancement: Autocomplete blockquotes.
• Enhancement: Word counts.
• Enhancement: Experimental support for Jekyll-style YAML front-matter.
• Various bugfixes and improvements.

This version fixes various bugs and adds functionalities. Recommended for all users.

We have new icons! Thanks to Matt Zanchelli for the beautiful Yosemite-style app icon and providing Retina resolutions to all icons.

Other notable updates include:

• Fixed: 10.8 Compatibility.
• Fixed: Text files cannot be opened.
• Fixed: Failure to render when texts are entered before preferences are loaded.
• Enhancement: Menu items and keyboard shorcuts to convert given line(s) to H1–H6 and regular paragraphs.
• Enhancement: Spelling, grammar and subtitution preferences of the editor are now persisted app-wise.
• Enhancement: New syntax highlighting language: Objective-C. Use objective-c, objectivec, obj-c, or objc to get it.
• Enhancement: New syntax aliases: You can now use html and xml as code block language IDs. They are mapped to markup.
• Enhancement: You can now customise the style of syntax highlighting as well as the overrall HTML style.
• Enhancement: Exported HTML are reduced by loading only necessary components of Prism.

This is a bugfix release to version 0.1. Recommended for all users.

• Fixed: UTI importing so that files with .md extension can be opened correctly.
• Fixed: various typos.
• Enhancement: Add option to disable auto-render.

First publicly released version. Visit the project site for more information.