Under development
-
Breaking changes:
- Rename internal
markdown-link-link
tomarkdown-link-url
for clarity. - The old inline image toggling command C-c C-i C-t should be considered deprecated by C-c C-x C-i and may be removed in the near future. Toggling keybindings are currently being grouped under C-c C-x.
markdown-blockquote-face
is now applied to the entire blockquote, including the leading>
, so it can be used to apply a background if desired.
- Rename internal
-
New features:
- Markup hiding: Add a custom variable
markdown-hide-markup
, which determines whether to hide or otherwise beautify Markdown markup. For example, for inline links the brackets, URL, and title will be hidden and only the (clickable) link text will remain. The URL can be seen by hovering with the mouse pointer and edited by deleting one of the invisible brackets or parentheses. This can be toggled interactively using C-c C-x C-m (markdown-toggle-markup-hiding
). This setting superceds URL hiding (below). - URL and reference label hiding: URLs for inline links and
labels for reference links are now hidden by default. This is
configurable via
markdown-hide-urls
. URLs will appear as[link](∞)
instead of[link](http://perhaps.a/very/long/url/)
. To change the placeholder character used, setmarkdown-url-compose-char
. This feature can be toggled using C-c C-x C-l (markdown-toggle-url-hiding
). If full markup hiding (above) is enabled, then URL hiding has no additional effect. - Native code block font-lock: Add a custom variable
markdown-fontify-code-blocks-natively
, which determines whether to fontify code in code blocks using the native major mode. This only works for fenced code blocks where the language is specified where we can automatically determine the appropriate mode to use. The language to mode mapping may be customized by setting the variablemarkdown-code-lang-modes
. (GH-123, GH-185) - Add command C-c C-x C-f for toggling native font lock
for code blocks (
markdown-toggle-fontify-code-blocks-natively
). - Add "page" movement, marking, and narrowing commands, where a
"page" in Markdown is defined to be a top-level subtree:
markdown-forward-page
(C-x ]),markdown-backward-page
(C-x [),markdown-mark-page
(C-x C-p), andmarkdown-narrow-to-page
(C-x n p). (GH-191) - Add subtree marking and narrowing functions:
markdown-mark-subtree
(C-c C-M-h) andmarkdown-narrow-to-subtree
(C-x n s). (GH-191) - Add plain text block movement commands: C-M-{
(
markdown-beginning-of-text-block
) and C-M-} (markdown-end-of-text-block
). To mark a plain text block, use C-c M-h (markdown-mark-text-block
). (GH-191) - Add
subtree
as a possible value formarkdown-reference-location
andmarkdown-footnote-location
. - Ask flyspell to ignore words in URLs, code fragments, comments, and reference labels.
- Make inline links, reference links, angle bracket URLs, and plain URLs clickable.
- Add an additional keybinding for toggling inline image display, C-c C-x C-i.
- Markup hiding: Add a custom variable
-
Improvements:
- Document customizable variables added in version 2.2 with
:package-version
tags. - Better consistency of function names: predicate functions
ending in
-p
shouldn't modify match data. - Generalize rebinding of block movement commands in case users
have customized
{forward,backward,mark}-paragraph
bindings. - Adjust point so that it is left at beginning of setext headings in heading navigation commands.
- Prevent inline link matching in code blocks.
- When inserting a new reference definition, don't add blank line after existing reference definitions.
markdown-toggle-inline-images
now displays the status in the minibuffer.
- Document customizable variables added in version 2.2 with
-
Bug fixes:
May 26, 2017
Version 2.2 is a major new stable release and all users are encouraged to upgrade. Thanks to everyone who submitted bug reports, feature suggestions, and especially patches.
-
Breaking changes:
- Now use C-c C-j for inserting list items, like
AUCTeX and similar to other programming modes. Since C-c
C-j was used for
markdown-jump
(for moving between reference link/footnote markers and their definitions), it has been changed to C-c C-l (think "leap" or "loop" instead of jump). It's also close to C-c C-o (used for opening links). (GH-26) - Insertion of
<kbd>
tags with C-c C-s k ormarkdown-insert-kbd
. - Add YAML metadata parsing. Also allow multiple Pandoc metadata, with tests. Thanks to Danny McClanahan and Syohei Yoshida. (GH-66, GH-91, GH-155, GH-156, GH-157)
- Change the behavior of C-c C-o
(
markdown-follow-link-at-point
) so that if a link is a complete URL, it will open in a browser. Otherwise, open it withfind-file
after stripping anchors and/or query strings. ([GH-132][]) - Make font lock for missing wiki links optional and disabled by
default. Add new custom variable
markdown-wiki-link-fontify-missing
to control this behavior. - The function
markdown-enable-math
has been made obsolete and renamed tomarkdown-toggle-math
. When called without an argument, the result is to toggle this extension rather than enable it.
- Now use C-c C-j for inserting list items, like
AUCTeX and similar to other programming modes. Since C-c
C-j was used for
-
New features:
- Filling for definition list items. (GH-13)
- Added option
markdown-gfm-downcase-languages
to use lowercase language name in GFM code blocks. (GH-71, GH-73) - Customizable live preview window split direction via
markdown-split-window-direction
. (GH-129, GH-188) - Variable-height headings via
markdown-header-scaling
. (GH-121) - Implement inline image previews via
markdown-toggle-inline-images
and C-c C-i C-t. Thanks to Syohei Yoshida. (GH-122, GH-128) - Added
markdown-wiki-link-search-subdirectories
to enable searching for wiki link files in subdirectories. (GH-174) - Added option to automatically continue lists when
RET
is pressed.markdown-indent-on-enter
now has three settings. (GH-179) - Match fenced code blocks with language and info strings. (GH-184)
- Add smart Markdown block navigation commands M-{ and M-}. These replace the regular-expression-based "paragraph" movement commands provided by Emacs, which do not recognize Markdown syntax (e.g., headings inside of code blocks). Also use M-h for marking a block and C-x n b to narrow to a block.
- Add
markdown-nested-imenu-heading-index
as a customizable option. It may be disabled to instead generate a flat imenu index. - Basic font lock and filling for definition lists. As a side effect, list item navigation and movement should also work.
- Add command for toggling GFM task list items via
C-c C-c C-x (
markdown-toggle-gfm-checkbox
). - Ability to toggle wiki link support via a new custom variable
markdown-enable-wiki-links
. This may be set in a file local variable. Also added functionmarkdown-toggle-wiki-links
and a menu item.
-
Improvements:
- Menubar reorganization. Grouped related actions together, added missing commands, and added several toggle options to the menu. (GH-147)
- Use
toggle
menu style for macOS compatibility. - Remove autoload for
.text
files. Thanks to Steve Purcell. ([GH-118][]) - Set own
adaptive-fill-regexp
so thatfill-paragraph
works for list items. Thanks to Syohei Yoshida for the patch. (GH-79, GH-80) - Suppress minibuffer output when generated HTML is small. Thanks to Syohei Yoshida. (GH-83, GH-86)
- Use GitHub fetcher for
markdown-mode
on MELPA. (GH-84) - Improve fenced code block parsing. Thanks to Danny McClanahan. (GH-85, GH-95)
- Markdown Mode is now automatically tested against Emacs 24.1-24.5 and 25.1-25.2. (GH-99)
- Make live-preview mode follow min or max point. Thanks to Danny McClanahan. (GH-102)
- Improved font-lock performance. (GH-119)
- Maintain cursor position when indenting instead of moving to the beginning of the line. Thanks to Isaac Hodes. (GH-125)
- Add used language names to front of list of known languages. (GH-135)
- Support basic TOML metadata. Thanks to Jorge Israel Peña. (GH-137)
- Prohibit setext heading text from starting with hyphens, spaces or tabs, so that there is no ambiguity between setext headings and in-progress lists. (GH-139, GH-143)
- Ignore heading lines in
fill-paragraph
. Thanks to Syohei Yoshida. (GH-159, GH-162) - Improve matching of multiple math blocks with non-math text in between. Thanks to Dave Kleinschmidt for a patch. (GH-168)
- Prevent
fill-paragraph
from filling lines in code blocks. (GH-169) - Fix font lock for links with URLs containing parentheses. (GH-170)
fill-paragraph
now respects paragraph boundaries within blockquotes. (GH-186)- Set mark when calling
markdown-up-heading
. - Improved font locking after empty GFM code block insertion.
- Fix spurious italics from underscores in URLs.
- Respect
font-lock-mode
being nil. Only callfont-lock-refresh-defaults
iffont-lock-mode
is non-nil to prevent it from being turned on when disabled by user. Thanks to Tom May for the patch. - Fix list item insertion on ordered lists with hash marks (Pandoc "fancy lists").
- Treat polymode blocks as code blocks when parsing the buffer.
- Require whitespace atx heading hashmarks, as required by the original atx specification (but not enforced by Markdown.pl). The benefit is that it prevents false positives for #hashtags and things like "Engine #1" when lines wrap.
- Complete heading markup when point is on an setext heading and
markdown-insert-header-dwim
is invoked (C-c C-t h). - Better point position after inserting asymmetric atx headings.
-
Bug fixes:
- Fix
scripts/get-recognized-gfm-languages.el
, which skipped languages with spaces. (GH-72, GH-82) README.md
specified Arch (AUR) package (emacs-goodies-el
), which did not exist. (GH-74)- Don't accidentally override user entries in
auto-mode-alist
. (GH-127) - Fix
markdown-cycle
issue with heading-like strings in code blocks. Thanks to Syohei Yoshida. (GH-75, GH-76) - Fix moving same level heading over code block issue. Thanks to Syohei Yoshida. (GH-77, GH-78)
- Don't insert empty title strings for links. Thanks to Sebastian Wiesner for the patch. (GH-89)
- Fix possible infinite loop in
markdown-cleanup-list-numbers
. Thanks to Danny McClanahan. (GH-98, GH-100) - Fix an args-out-of-range error due to the syntax-propertize
function returning point which is larger than
point-max
. Thanks to Syohei Yoshida. (GH-142) - Respect narrowed region in
markdown-find-previous-prop
. Thanks to Vitalie Spinu. (GH-109) - Move point at least 1 char in
markdown-match-propertized-text
to avoid possible infinite loop in font-lock. Thanks to Vitalie Spinu. (GH-110) - Fix issues where buffers could be marked as modified when no modifications were made. (GH-115, GH-116, GH-146)
- Fix an issue where comments of the form
<!-- > comment -->
were not correctly identified. (GH-117) - Prevent spurious bold fontification. Thanks to Kévin Le Gouguec. (GH-124)
- Keep metadata visible when cycling visibility. (GH-136)
markdown-syntax-propertize-extend-region
should not overwrite match-data, which caused issues withreplace-regexp
, etc. (GH-104, GH-105)- Don't list heading-like lines in code blocks or metadata in imenu. Thanks to Syohei Yoshida. (GH-145, GH-154)
- Fix an issue where fill paragraph wouldn't work following unclosed left square brackets. (GH-148, GH-161)
- Fix default language presented when inserting GFM code blocks. Thanks to Conal Elliot for a patch. (GH-152)
- Backspace now always deletes characters if a region is specified. Thanks to Syohei Yoshida. ([GH-166][], [GH-167][])
- Fix
markdown-header-face
inherit from nil error, e.g., when exporting HTML from an Org mode file containing a Markdown source block. Thanks to Moogen Tian for a patch. (GH-190, GH-193) - Inserting a reference link no longer causes an "args out of range" commit error when the existing reference label is a single commit character.
- Fix to honor location setting when inserting reference definitions.
- Fixed an issue where, if there is special markup at the end of the buffer, deleting a character backward would cause the font-lock faces to disappear.
- Fix incorrect matching of italic text due to underscores in math mode. Thanks also to Dave Kleinschmidt.
- Fix italic highlighting issue when each line or both lines are list.
- Handle false positive italics across list items.
- Fix
January 9, 2016
Version 2.1 is a major new stable release and all users are encouraged to upgrade. The many new features and bug fixes included are described below.
Markdown Mode is developed and tested primarily for compatibility with
GNU Emacs versions 24.3 and later. It requires cl-lib
version 0.5
or later. This library has been bundled with GNU Emacs since version
24.3. Users of GNU Emacs 24.1 and 24.2 can install cl-lib
using
M-x package-install RET cl-lib
.
This release of Markdown Mode contains patches written by many individuals including Masayuki Ataka, Jonas Bernoulli, Roger Bolsius, Daniel Brotsky, Julien Danjou, Samuel Freilich, David Glasser, Marijn Haverbeke, Antonis Kanouras, Keshav Kini, Vasily Korytov, Danny McClanahan, Matt McClure, Howard Melman, Makoto Motohashi, Jon Mountjoy, Pierre Neidhardt, Spanti Nicola, Paul W. Rankin, Christophe Rhodes, Tim Visher, and Syohei Yoshida. Many others also submitted bug reports. Thanks to everyone for your contributions.
-
Breaking changes:
- In GFM Mode,
visual-line-mode
is no longer enabled by default. Agfm-mode-hook
was added, which could be used to keepvisual-line-mode
on by default ingfm-mode
. (GH-31)
- In GFM Mode,
-
New features:
- Add automatically updating live preview functionality
(C-c C-c l) via the native
eww
browser. (GH-36, GH-53, GH-57, GH-58, GH-63) - Use
autoload
to enablemarkdown-mode
inauto-mode-alist
for files with.text
,.markdown
, and.md
extensions. - Use Travis CI for automated build testing.
- ATX heading subtree promotion and demotion via M-S-LEFT, and M-S-RIGHT.
- ATX heading subtree moving up and down via M-S-UP and M-S-DOWN.
- Convert inline links to reference links when
markdown-insert-reference-link-dwim
is used when the point is at an inline link. - Allow linking to multiple stylesheets in
markdown-css-paths
list. Use stylesheets for both preview and export. Previousmarkdown-css-path
(singular) is now deprecated. - Customizable default unordered list marker via
markdown-unordered-list-item-prefix
. - Add asymmetric ATX heading adornment option
markdown-asymmetric-header
. - Font lock for
<kbd>
tags. - Support GFM-style code blocks in
markdown-mode
(as well asgfm-mode
). (GH-2) - New function
markdown-electric-backquote
will prompt for a language name for GFM code blocks. This can be disabled by customizing the variablemarkdown-gfm-use-electric-backquote
. (GH-9) - Completion of programming language names for GFM code blocks.
A list of pre-defined languages is included, but this can be
augmented by setting
markdown-gfm-additional-languages
. (GH-38, GH-54, GH-59, GH-60, GH-64) - strikethrough support in
gfm-mode
. - Support for GFM toggling checkboxes
mouse-1
or RET. This is controlled by a new custom variable,markdown-make-gfm-checkboxes-buttons
. Thanks to Howard Melman for a patch. (GH-7) - Font lock and filling for Pandoc "fancy lists," which use
#
as the list marker. (GH-3) - Basic support for filling of definition lists. (GH-20)
- Support Ikiwiki-style search for wiki links that allows
links relative to parent directories. Enable this by setting
markdown-wiki-link-search-parent-directories
. (GH-8, GH-21)
- Add automatically updating live preview functionality
(C-c C-c l) via the native
-
Improvements:
- General font lock improvements for comments, code blocks, blockquotes, headings, horizontal rules, bold, and italics. (GH-67, GH-68)
- Separate highlighting for Markdown markup characters (asterisks, underscores, backquotes, etc.) to aid in readability.
- Font lock for bold, italics, and LaTeX math work inside block elements such as headings and blockquotes. (GH-39)
- Display a link to the GitHub repository in the MELPA description. (GH-37)
-
Bug fixes:
- Fix bug in
markdown-complete-region/buffer
where level-two Setext headings could be confused with horizontal rules. Includes a unit test. Thanks to Gunnar Franke for the report. - Fix filling when a decimal number appears at column zero, which could be confused with an ordered list item.
- Fix buffer-wide markup completion.
- Fix font-lock for GFM code blocks without language keywords.
- Improved Setext header insertion to support wide characters.
- Fix expensive
paragraph-separate
regular expression. - Make
comment-auto-fill-only-comments
a buffer-local variable, which allows for better default filling behavior in cases where the global variable is non-nil
. - Fix Emacs 23 compatibility by checking for
font-lock-refresh-defaults
before calling it. - Handle reference definitions when filling paragraphs.
- Improve filling of list items with indentation.
- Properly handle footnotes when filling.
- Fix issues with markdown-footnote-kill and related functions.
- Improve font lock for fenced code blocks.
- Avoid avoid overwriting source file when exporting if source
file has
.html
extension. - Fix and improve ordered list behavior to preserve digit spacing and avoid an infinite loop in certain cases. Adjust ordered list whitespace when marker digit count increases.
- Improve reference definition regular expression to avoid matching multiple reference links in one line.
- Allow spaces in fenced code language identifiers. (GH-22)
- Improve font lock for preformatted blocks and fenced code blocks.
- Fix out-of-order HTML output. (GH-14)
- Add console-friendly backspace and tab bindings. (GH-15)
- Better treatment of files without extensions for wiki links. When files have no extensions, don't append a lone period. (GH-23)
- Call
looking-back
with two arguments for compatibility with Emacs 25.1. - Make
(beginning-of-defun -1)
go to next title when point is at beginning of defun. (GH-34) - Ignore headings in code blocks for font lock, movement, and visibility cycling. (GH-27, GH-33, GH-35, GH-40, [GH-41][])
- Don't highlight wiki links in code blocks. (GH-17)
- Don't move to links in code blocks with C-c C-p and C-c C-n.
- Fix hanging indentation for list items and single-line preformatted blocks. (GH-16, GH-28, GH-30)
- Better rejection of false positives for italics with respect to other inline elements (inline code and bold).
- Predicate functions should not modify match data.
- Use correct list marker from previous list level when using C-u M-RET to insert a dedented list item. Prevent an infinite loop in some cases. (GH-4)
- Reduce lag when scrolling or inserting text into large files. (GH-30, GH-101)
- Avoid confusing tramp errors with malformed wiki links. (GH-65)
- Fix bug in
March 24, 2013
Version 2.0 is a major new stable releaes with many new features, including some changes to keybindings for element insertion and outline navigation. In summary, Markdown Mode now has improved keybdinings, smarter markup insertion commands, a general markup removal command, markup completion (normalization), markup promotion and demotion, list and region editing, many syntax highlighting improvements, new and improved movement commands, and generalized link following and movement.
-
Breaking changes:
- Physical style 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 related elements. For example, you can 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.
- Footnote keybindings have been moved away from the C-c C-f n prefix.
- Several other new keybdings have been introduced and are described in more detail below.
- Removed wiki link following with
RET
andmarkdown-follow-wiki-link-on-enter
setting. Use the unified following (open link) command C-c C-o instead.
-
New features:
- Fast heading insertion with a single command which automatically calculates the type (atx or setext) and level. 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.
- Easily kill an element (e.g., a link or reference definition) at the point with C-c C-k and store the most important part in the kill ring (e.g., the link text or URL).
- Markup completion (C-c C-]) normalizes the markup for an element (e.g., it balances hash marks and removing extra whitespace for atx headings).
- Markup promotion and demotion via C-c C-- and C-c C-=, respectively. The sequences M-<up> and M-<down> may also be used.
- List editing: move list items up and down with M-<up> and M-<down>. Indent and exdent list items with M-<left> and M-<right>.
- Region editing: indent and exdent regions, with tab stops
determined by context, using C-c < and C-c
> (as in
python-mode
). - 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.
- 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 back, present a buffer with buttons for selecting which link to jump to.
- 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-}.
- Customizable reference link location via
markdown-reference-location
. - Font lock for title strings in inline links.
- Subtle syntax highlighting for hard line breaks.
- In GFM Mode, change italic font lock behavior to match GFM specification regarding underscores in words.
- Insertion command (C-c C-s P) for GFM quoted code blocks.
- Syntax highlighting for MultiMarkdown metadata and Pandoc title blocks.
- Added before and after export hooks
markdown-before-export-hook
andmarkdown-after-export-hook
. - Added a library of regression tests which currently contains 160 unit tests.
-
Improvements:
- 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.
- 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.
- Basic reference-style image markup insertion.
- Multiple horizontal rule styles,
markdown-hr-strings
, 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).
- 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.
- Syntax highlighting for GFM quoted code blocks with an optional language keyword.
- Dynamic loading and unloading for math support with refontification.
- Allow underscores and colons in equation labels in math mode.
- Syntax highlighting improvements: faster identification of preformatted blocks. Markdown Mode adheres to the four space rule for nested list items: in a list item of level n, preformatted text must be indented at least 4(n + 1) spaces.
- More inclusive blockquote regular expression highlights blockquotes with leading indentation, when appropriate.
- Regular expression optimization for URI matching.
- Numerous other improvements for more accurate syntax highlighting.
- Respect hard line breaks when filling paragraphs.
- Add indentation positions: preceding list markers and pre block position.
- Use button-map for navigating undefined references, so that references can be navigated via the keyboard by pressing TAB and S-TAB.
- Use newer
use-region-p
when possible to check for active region, with fallbacks for older Emacsen and Xemacs. - Clean up whitespace after deleting footnote text.
- 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.
- Numerous other internal improvements to make the code base more robust.
-
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.
- 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.
January 1, 2013
Version 1.9 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 two 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.
- Support for setext-style headers in
-
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 forlonglines-mode
, when ingfm-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
whenrestore-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 ingfm-mode
. - Add two tab stops to possible indentation positions following list items.
- Improve
-
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.
- 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.
August 15, 2011
Version 1.8.1 is a bugfix version which addresses some minor issues in version 1.8.
-
New features:
- Wiki link features now support aliased or piped wiki links of
the form
[[PageName|link text]]
.
- Wiki link features now support aliased or piped wiki links of
the form
-
Bug fixes:
- Fixed an issue, reported by Werner Dittmann, where the
default indentation position would be skipped over when
auto-fill-mode
was on. This meant that when writing a normal paragraph, for example, the line would wrap to column 4 instead of column 1. - Require the
cl
package formultiple-value-bind
. Thanks to Werner Dittman for noticing this. - Remove a leftover debug print message which would announce "ENTER" in the minibuffer when the enter key was pressed.
- Fixed an issue, reported by Werner Dittmann, where the
default indentation position would be skipped over when
August 12, 2011
-
New features:
- Add support for following wiki links in a buffer, either with C-c C-f or, optionally, RET, when the point is at a wiki link.
- Support Markdown processors which do not accept input from
stdin (i.e, Python-Markdown) by adding the
markdown-command-needs-filename
custom option. Thanks to Jeremiah Dodds for a patch. - GitHub-Flavored Markdown mode (
gfm-mode
) turns onlonglines-mode
andauto-fill-mode
. Thanks to Edward O'Connor for the patch. - Add outline-mode-like keybindings for fast outline navigation of atx-style headers (see the updated documentation for details).
- Arbitrary content may to be added to the
<head>
block during HTML output to allow for flexible local customizations. Seemarkdown-xhtml-header-content
. - New HTML export options: export to a file with C-c C-c e or export to a file and view with C-c C-c v.
- Support Markdown processors which produce standalone output
(i.e., complete HTML documents). If this is detected, by
matching
markdown-xhtml-standalone-regexp
in the first five lines of output, then omit themarkdown-mode
header and footer. Thanks to Philippe Ivaldi for this and the previous HTML-output-related patches. - Customizable wiki link following behavior using
markdown-follow-wiki-link-on-enter
. - Quick navigation to the previous and next wiki links using M-p and M-n.
- Wiki links to non-existent files (missing links) are
highlighted differently. Based on functionality from
wiki-mode
by Alex Schroeder. Thanks to Eric Merritt for patches.
-
Improvements:
- Improve syntax highlighting of preformatted text blocks to better distinguish them from list items with hanging indentation and nested list items.
- Match italic and bold text and inline code fragments across line breaks, within a single block, but prevent them from matching across blocks.
- Generally improve multi-line font lock by extending the search region to include full blocks.
- Make indentation work when the previous line is not indented.
- Set tab width to 4, the natural tab width for Markdown documents.
- Stop announcing "TAB" in the minibuffer when tab is pressed.
- Use
html-mode
for viewing Markdown output. - Ensure Markdown output buffer is always raised, even when the output is short.
- Make sure horizontal rules inserted by C-c -
(
markdown-insert-hr
) are surrounded by blank lines. - Added an
autoload
cookie. Thanks to Peter S. Galbraith for the patch. - Support a customizable horizontal rule string
markdown-hr-string
. This replaces the previous but less flexible custom optionmarkdown-hr-length
, which has been removed. - Followed wiki links are opened using
markdown-mode
.
-
Bug fixes:
- Fixed an issue, reported by Joost Kremners, where for multi-line lists, the position of the list marker was not being added to the list of possible indentation levels.
- Avoid a problem where indentation positions were getting skipped over when tab cycling.
- Fixed an issue when column 0 is the natural automatic indentation stop.
- Prevent infinite loops in blockquote (C-c C-s b) and preformatted (C-c C-s p) block insertion while at the beginning or end of the buffer.
October 1, 2009
-
New features:
- Support filling of list items.
- Allow customization of font-lock faces (thanks to intrigeri for the patch).
- Automatic indentation when pressing enter or tab (with cycling upon subsequent tab presses) (thanks to Bryan Kyle).
- Generate real XHTML for previewing (thanks to Hilko Bengen
for the patch). This fixes Debian bug #490865. The CSS
stylesheet for XHTML output is customizable via
markdown-css-path
(thanks to Ankit Solanki for the patch). - Better URL matching (protocols are customizable through
markdown-uri-types
). - LaTeX syntax highlighting can be enabled or disabled using
the customize system (
markdown-enable-math
). - Support for HTML comments (font lock,
comment-dwim
, etc.). - Support filling of definition lists (thanks to Peter Williams for the patch).
-
Improvements:
- Add support level 5 and 6 atx-style headers (thanks to Alec Resnick for the report).
- Fill-paragraph no longer breaks lines inside of square brackets (thanks to Peter Williams for the patch).
-
Bug fixes:
- Fixed several font lock issues.
- Fixed a bug where pressing enter did nothing in longlines-mode (thanks to Ankit Solanki for the patch).
- Fixed a problem where Emacs snapshot would hang during
markdown-enter
andmarkdown-cycle
(thanks to Alec Resnick for the report). - Fixed an issue with auto-fill-mode and markdown-mode's indentation (thanks to Joost Kremers for the report and analysis).
June 4, 2008
-
Breaking changes:
- Rename
blockquote-region
tomarkdown-blockquote-region
in accordance with the Emacs major mode coding conventions. - Several new keybindings.
- Reverted to using colors instead of bold, italic, and fixed-width faces.
- Rename
-
New features:
- Implemented org-mode style visibility cycling.
- Support outline minor mode.
- Undefined reference checking (via
C-c C-c c
, using code by Dmitry Dzhus). - Wiki links: syntax highlighting and element insertion
(
C-c C-a w
). - Allow syntax highlighting faces to be customized.
- Insertion of preformatted text sections (
C-c C-s p
). - Font locking for inline URIs and email addresses.
- Markdown mode menu (thanks to Greg Bognar for the initial code).
-
Improvements:
- Markdown customize group moved to
wp
(word processing). - Derive from
text-mode
instead offundamental-mode
. - Properly prefix regex definitions and
wrap-or-insert
function.
- Markdown customize group moved to
-
Bug fixes:
- Highlight wrapped inline link definitions (thanks to Blake Winton).
- Fix adjacent wiki link font lock bug.
- Support escaping of backticks.
- Many other small font lock tweaks.
- Don't check for
transient-mark-mode
inmarkdown-blockquote-region
. This fixes Debian bug #456592 (thanks to Daniel Burrows for the report). - Apply Greg Bognar's fix for
markdown
with an active region. - Don't use the kill ring to store wrapped text.
October 11, 2007
Version 1.5 is a major revision compared to previous releases. The functionality has not changed very much, all of the keybindings are the same, but it is internally quite different.
Most of the changes involve syntax highlighting. The regular expressions have been significantly improved and the corresponding font lock faces have been tweaked (hopefully for the better, but feel free to customize them). Various other small bugs have been fixed and the documentation and website have been updated.
The two changes in functionality, both of which are optional, are syntax highlighting for embedded mathematics via LaTeX-like expressions, and highlighting for bracketed wiki links.
June 29, 2007
Version 1.4 includes a small fix to the regular expression syntaxto fix the Emacs 21 "Invalid escape character syntax." error. Thanks to Edward O'Connor for the fix.
June 5, 2007
Version 1.3 provides syntax highlighting, insertion commands for all basic HTML elements, and preview commands for viewing the resulting HTML in a new buffer of an external browser.
May 25, 2007
Version 1.2 adds element insertion commands and keys for links, horizontal rules, headers, inline code, and bold and italic text.
Added element insertion commands and keys for links, horizontal rules, headers, inline code, and bold and italic text.
May 24, 2007
Version 1.1 is the initial release of Markdown Mode for Emacs, a major mode to edit Markdown files in Emacs. This version provides basic syntax highlighting and element insertion commands for Markdown files.