Markdown Mode 2.0 Release Notes
Markdown Mode version 2.0 was released on March 24, 2013. This
is a major new stable release with many new features, including some
changes to keybindings for element insertion and outline navigation.
This new stable version can be downloaded from the
Markdown Mode homepage. Below is a description of significant or
user-visible enhancements or bug fixes. See the Git repository
for a complete history of changes.
New Features
Keybinding Changes
Physical styles: element insertion commands prefixed by C-c
C-p have been removed in favor of their logical style
counterparts prefixed by C-c C-s.
Shift is now the preferred way to distinguish keybindings for two
similar elements:
Insert an inline link with C-c C-a l or a reference
link with C-c C-a L. The latter keybinding is new
and preferred over C-c C-a r, which is deprecated.
Insert an inline image with C-c C-a l or a reference
image with C-c C-a L. The latter keybinding and
insertion functionality is new.
The new automatic header insertion function (more below) is
bound to C-c C-t h, with C-c C-t H being a
variant that indicates a preference for Setext headings.
Insert an ATX level-one heading with C-c C-t 1 or a
Setext level-one heading with C-c C-t ! (!
is S–1). The latter keybinding is new and is
preferred over C-c C-t t, which is deprecated.
Insert an ATX level-two heading with C-c C-t 2 or a
Setext level-two heading with C-c C-t @ (@
is S–2). The latter keybinding is new and is preferred
over C-c C-t s, which is deprecated.
Footnotes:
Insert new footnote: C-c C-f n has been changed to
C-c C-a f.
Jump to footnote text: C-c C-f g has been superceded
by C-c C-j (markdown-jump).
Jump to footnote marker: C-c C-f b has been
superceded by C-c C-j (markdown-jump).
Kill footnote: C-c C-f k has been superceded by
C-c C-k (markdown-kill-thing-at-point).
Several other new keybdings have been introduced and are described
in more detail below.
Smarter Markup Insertion
Fast heading insertion with a single command which automatically
calculates the type (atx or setext) and level (which can now be
cycled quickly, see below). Prefix with C-u to promote
the heading by one level or C-u C-u to demote the
heading by one level. Headings with a specific level or type
can still be inserted quickly with specific keybindings.
ATX heading insertion will use current line as heading text if not
blank and there is no active region.
Setext heading insertion will prompt for heading title when there is
no active region.
When the point is at a heading, the heading insertion commands will
replace the heading at point with a heading of the requested level
and type.
When there is no active region, the bold, italic, code, link, and
image insertion commands will operate on the word at point, if any,
so that you don’t have to have an active selection for simple
modifications.
Repeating the bold, italic, or code insertion commands when the
point is at an element of the corresponding type will remove the
markup.
Smart list item insertion with M-RET, with indentation
and marker determined by the surrounding context. Prefix with
C-u to decrease the indentation by one level or
C-u C-u to increase the indentation one level.
Indentation of preformatted text and blockquotes will be adjusted
automatically in contexts where more indentation is required, as in
nested lists. (For example, in Markdown, a preformatted text block
inside a first-level list item must have eight spaces of
indentation.)
Improved reference link insertion with label completion.
Use word at point as link text, if possible, when there is no
active region.
Tab completion of reference labels from the set of currently
defined references.
Reference link insertion no longer prompts for
a URL or title if the label is already defined.
If no URL is given, create an empty reference definition
and move the point there.
Customizable reference link location via
markdown-reference-location.
Basic reference-style image markup insertion.
Multiple horizontal rule styles, customizable as a list of strings,
which can be cycled through.
New URL insertion command for inserting plain URLs delimited by
angle brackets (C-c C-a u). Works on URL at point, if any,
when there is no active region.
Generally improved insertion commands with respect to insertion of
surrounding whitespace and point position after insertion
(e.g., ensuring blank lines before and after newly inserted headings
and horizontal rules).
Markup Removal
Easily kill an element (e.g., a link or reference definition) at the
point and store the most important part in the kill ring (e.g., the
link text or URL).
Markup Completion
Completion (C-c C-]) normalizes the markup for an
element:
balancing hash marks and removing extra whitespace for atx
headings,
equating the length of the underline with the text for setext
headings, and
ensuring that horizintal rule strings are chosen from a
pre-defined list of strings (markdown-hr-strings).
Markup Promotion and Demotion
Markup promotion and demotion via C-c C— and C-c
C-=, respectively. The sequences M-<up> and
M-<down> may also be used.
Certain types of markup may be promoted or demoted: atx headings,
setext headings, horizontal rules, and list items.
Bold and italic also be toggled between asterisks and
underscores.
Promotion and demotion commands also cycle when level boundaries are
reached (e.g. when demoting a level six heading, it cycles back a
level one heading).
List and Region Editing
Move list items uper and more
accurate. The pre block matching routines have been completely
rewritten, with unit tests. The previous implementation was
incorrect in some cases and generally slow. This should be much
faster and more accurate for pre blocks inside nesterule for nested list items:
in a list item of level n, preformatted text must be indented at
least 4(n + 1) spaces.
Font lock for title strings in inline links.
Subtle syntax highlighting for hard line breaks.
More inclusive blockquote regular expressiofor more accurate syntax highlighting.
New and Improved Movement Commands
Jumping:
Quickly jump between reference definitions and reference-style links
and between footnote markers and footnote text with
C-c C-j.
Create undefined references when jumping from a reference link.
When jumping from a reference definition used by multiple
reference links, show a temporary buffer with buttons for
selecting which link to jump to. Possible locations may be
cycled with TAB and S-TAB.
Revised outline navigation commands, following org-mode. This
frees up the sexp navigation keys C-M-f and
C-M-b which can be useful in Markdown documents which
have many matching delimiters, as well as the defun navigation keys
C-M-a and C-M-e.
Previous/next section movement with C-M-a and
C-M-e (in Emacs parlance, this is movement by defun).
Mark the current section with C-M-h.
Previous/next paragraph movement via M-{ and M-}.
Previous/next block movement with C-u M-{ and C-u M-}.
Link Following and Movement
Unified link following: open links in a browser and wiki links in a
new buffer with the same keybinding (C-c C-o). This
supercedes the separate wiki link following command
(C-c C-w).
Generalized link movement and following: move between and open all
link types (inline, reference, wiki, angle URIs) using the same key
bindings (M-n and M-p). Previously, these
commands only moved between wiki links, but with the above following
enhancement, moving between hyperlinks of all types is more useful.
Remove wiki link following with RET and
markdown-follow-wiki-link-on-enter setting.
Other Enhancements
Respect hard line breaks when filling paragraphs.
A downside of this is that paragraph movement commands will also
stop at hard line breaks, thus slightly changing the definition of
“paragraph” in this mode. In those cases, use the new block
movement commands instead.
Use adaptive filling for list items and blockquotes.
Treat all list items (any marker type) the same way with respect
to filling.
Retain the > prefix when filling blockquotes.
Fill list items inside of blockquotes.
Add indentation positions: preceding list markers and pre block position.
imenu support.
Added before and after export hooks.
markdown-before-export-hook can make changes to the source
buffer (e.g., preprocessing the Markdown source before running
Markdown). Any changes made will be kept until the file is
exported, so they will be incorporated into the resulting XHTML
output, and the buffer will be restored to it’s original state
after exporting.
markdown-after-export-hook may modify the resulting output
buffer after export but before the output file is saved (e.g.,
postprocessing the XHTML output).
Added a library of regression tests which currently contains 1cks for older Emacsen and Xemacs.
Numerous other internal improvements to make the code base more robust.
Use button-map for navigating undefined references, so that
references can be navigated via the keyboard by pressing
TAB and S-TAB.
Clean up whites:
Dynamic loading and unloading for math support with
refontification.
Allow underscores and colons in equation labels.
GFM (GitHub Flavored Markdown) Mode Improvements
Changes italic font lock behavior to match GFM specification
regarding underscores in words.
Syntax highlighting for GFM quoted code blocks with an optional
language keyword.
Insertion command (C-c C-s P) for GFM quoted code blocks.
Bug Fixes
Fix bug in heading visibility cycling introduced in version 1.9
where the level of headings was being calculated incorrectly.
Fix problems inserting ATX headings at end of buffer.
Support small Setext headings (with fewer than three characters).
Several improvements to inline code syntax highlighting.
No need to prohibit spaces after the leading backquotes.
Markdown allows more than two leading backquotes (but the same number
must appear at the end to close the code tag).
Ensure following character is not a backquote.
Fix a bug where code fragments separated by a single character
were not highlighted correctly. (This is difficult or impossible
to do with regular expressions in Emacs, which do not support
negative lookahead or negative lookbehind, so a matching function
is used now.)
Fix some edge cases regarding escaping, spaces, etc. for bold and
italic font lock.
Prohibit newlines and tabs immediately after opening bold and italic
delimiters. This fixes a bug where italics would not be
highlighted following a horizontal rule
Improved multi-line font lock performance for large files.
Improved multi-line font lock at beginning of buffer.
List items with any of the three markers are filled in the same way
(previously list items starting with + were not filled with
hanging indentation).
Fix end detection for empty list items. Don’t skip over the
whitespace following the marker on the same line. Previously, empty
list items were not being detected properly by
markdown-cur-list-item-bounds as a result of this.
Don’t exclude [^], which is a valid reference tag (but let’s
please stick to alphanumeric characters).
No longer highlight escaped wiki links.
Fix line number buttons for reference checking and make all buttons
clickable.
Fix killing of footnotes with no text.
Fix escaping in markdown-xhtml-standalone-regexp.
Fix a font-lock edge case involving footnote markers preceding
inline links.
More accurate font-lock for ATX headings in edge cases.
Fix killing of footnotes from footnote text.
1.9
markdown-mode 1.9
markdown-mode version 1.9 was released on
January 25, 2013. This is a major new stable release with important
bug fixes.
New features:
Support for setext-style headers in outline-mode.
Thanks to Shigeru Fukaya.
Font lock for tilde-fenced code blocks.
Reference link insertion (C-c C-a r).
Support both forms of aliased wiki links:
[[link text|PageName]] and [[PageName|link text]]
(markdown-wiki-link-alias-first).
Footnote support: font lock and insertion, deletion, and
navigation functions for footnotes (prefixed by C-c C-f;
following for wiki links is now C-c C-w).
Thanks to Joost Kremers.
Improved preview and export commands.
Thanks to Donald Ephraim Curtis.
imenu support. Thanks to Akinori Musha.
Added autoload token for gfm-mode.
Thanks to Max Penet and Peter Eisentraut for the suggestion.
Optional character set declaration in XHTML output.
Thanks to François Gannaz for the suggestion.
Smart unindentation when pressing delete at the beginning of a
line. Thanks to Zhenlei Jia.
Optional prefix argument to C-c C-w for opening wiki links
in another window.
Open inline and reference links and inline URIs in browser
(C-c C-o). Thanks to Peter Jones.
Open files in a standaline previewer or editor (C-c C-c o).
Clean up numbered/ordered lists (C-c C-c n).
Thanks to Donald Ephraim Curtis.
Save Markdown output to kill ring (copy to clipboard) (C-c C-c w).
Thanks to Donald Ephraim Curtis.
Bug fixes:
Fixed a bug which caused unusual behavior in functions performing
search, replace, and/or matching operations.
Thanks to Christopher J. Madsen for the patch.
Fixed a bug which caused an incompatibility with orgtbl-mode.
Thanks to Vegard Vesterheim for the report and to Carsten Dominik
for a patch.
Fixed a bug where reference links at the beginning of a line
would be mistaken for reference definitions.
Improved font lock for headers.
Improved font lock for reference definitions. Thanks to Ian Yang.
Avoid byte compiler warning about region-exists-p in GNU Emacs.
Additional key bindings for cross-platform header cycling
compatibility.
Fix problem with externally modified files on disk where the user
would get stuck in a loop answering “really edit the buffer?”
Thanks to Bryan Fink for a detailed report.
Other improvements:
Improve markdown-mode-hook docstring.
Thanks to Shigeru Fukaya for the more precise description.
Don’t require Common Lisp extensions at run time.
Thanks to Shigeru Fukaya.
Prefer visual-line-mode, the replacement for longlines-mode,
when in gfm-mode. Thanks to Christopher J. Madsen.
Proper GitHub wiki link handling in gfm-mode. Thanks to Kevin
Porter.
XEmacs compatibility:
Avoid malformed list errors during font definitions.
Handle replace-regexp-in-string.
Use text properties instead of overlays.
Fall back to set-buffer-modified-p when
restore-buffer-modified-p is unavailable.
Many additional fixes. Thanks to Michael Sperber.
Handle wiki links in buffers not associated with a file.
Update autoload documentation to support byte compilation.
Option to use - instead of _ for wiki links in gfm-mode.
Add two tab stops to possible indentation positions following list
items.
Minor bug fixes:
Font lock fix for URLs with underscores.
Escape shell commands to handle filenames with spaces, etc.
Thanks to Marcin Kasperski for a patch.
Use :slant instead of unsupported :italic in font spec.
Fix typo in paragraph-fill regexp.
9ab6c1ea40