| blob | 0f9329504cb8ccedc1076e05e76e166ce01fe7e8 |
1 # Markdown Mode 2.5
3 *Under development*
5 * **Breaking changes:**
7 * New features:
8 - Introduce `markdown-mouse-follow-link` variable [GH-290][]
10 * Improvements:
11 - Cleanup test code
12 - Strip query parameters from local file name at displaying inline images [GH-511][]
14 * Bug fixes:
15 - Fix remaining flyspell overlay in code block or comment issue[GH-311][]
16 - Fix inline URL regular expression which starts/ends with spaces[GH-514][]
18 [gh-290]: https://github.com/jrblevin/markdown-mode/issues/290
19 [gh-311]: https://github.com/jrblevin/markdown-mode/issues/311
20 [gh-511]: https://github.com/jrblevin/markdown-mode/issues/511
21 [gh-514]: https://github.com/jrblevin/markdown-mode/issues/514
23 # Markdown Mode 2.4
25 *May 30, 2020*
27 * **Breaking changes:**
29 - GNU Emacs 25.1 or later is required. And xemacs support has been dropped
30 - Face variables, such as `markdown-italic-face` are now
31 obsolete. Use face names directly in code and customizations.
32 The face names themselves are unaffected, so this shouldn't
33 affect most users.
34 - Delete obsoleted aliases
35 - Internal variables `markdown-font-lock-keywords-basic` and
36 `gfm-font-lock-keywords` are now obsolete.
37 `markdown-font-lock-keywords` is now used instead, but users
38 should use `font-lock-add-keywords` instead of modifying this
39 variable.
40 - `markdown-mode` now adds entries to the beginning of
41 `auto-mode-alist` rather than the end. If you were relying on
42 the previous behavior in order to override these entries, you
43 should fix the problem by following best practice and ensuring
44 that your user configuration is loaded after the autoloads for
45 `markdown-mode` are evaluated. ([GH-331][], [GH-335][])
46 - Point at the end of fenced code blocks is no-longer considered
47 part of the code block ([GH-#349][]).
48 - Enable `markdown-fontify-code-blocks-natively` in `gfm-view-mode`. ([GH-#451][])
50 * New features:
52 - GFM task list item (checkbox) insertion with `C-c C-s [`, or
53 as a final fallback for `markdown-do` (`C-c C-d`). Thanks to
54 Akinori Musha for a patch. ([GH-229][])
55 - Optionally move leading atx heading markup to the left margin
56 when `markdown-marginalize-headers` is non-`nil`. Thanks to
57 Alexis Gallagher for a patch. ([GH-272][], [GH-274][])
58 - Added pipe table editing features. Thanks to Dmitry Safronov
59 for a patch. ([GH-171][], [GH-266][])
60 - Font lock for HTML tags and attributes, with new faces
61 `markdown-html-tag-name-face`,
62 `markdown-html-tag-delimiter-face`,
63 `markdown-html-attr-name-face`, and
64 `markdown-html-attr-value-face`. ([GH-249][])
65 - Font lock for HTML entities, with a new face
66 `markdown-html-entity-face`.
67 - Scale down large inline images using `markdown-max-image-size`,
68 a cons cell of the form `(max-width . max-height)`.
69 - Added read-only viewing modes `markdown-view-mode` and
70 `gfm-view-mode` with keymaps similar to `view-mode` and
71 `help-mode`. ([GH-296][])
72 - Optionally add footnote definitions to the end of the imenu
73 index using `markdown-add-footnotes-to-imenu`. ([GH-235][])
74 - Add custom variables `markdown-xhtml-body-preamble` and
75 `markdown-xhtml-body-epilogue` for wrapping additional XHTML
76 tags around the output. ([GH-280][], [GH-281][])
77 - Add `markdown-unused-refs` command to list and clean up unused
78 references (available via `C-c C-c u`). ([GH-322][])
79 - Add `markdown-insert-table` (`C-c C-s t`) for interactive
80 table insertion. ([GH-369][])
81 - Add `markdown-kill-outline` and `markdown-kill-block`
82 functions.
83 - Added `markdown-display-remote-images` for viewing remote
84 images. Thanks to Sean Allread for the patch. ([GH-378][])
85 - `markdown-back-to-heading` can be used as command ([GH-415][])
87 * Improvements:
89 - Insert references before local variables. Thanks to Philipp
90 Stephani for a patch. ([GH-216][], [GH-262][])
91 - Allow `markdown-command` and `markdown-open-command` to be
92 functions. ([GH-255][], [GH-263][])
93 - Save the buffer before running `markdown-open-command` and run
94 `markdown-open-command` asynchronously. Thanks to Dmitry
95 Safronov for a patch. ([GH-248][])
96 - New user option `markdown-translate-filename-function` to translate
97 filenames when following file links. ([GH-268][], [GH-277][])
98 - Support double-backslash math delimiters. ([GH-270][])
99 - New user option `markdown-export-kill-buffer` to kill or preserve
100 HTML export output buffer. ([GH-224][])
101 - Add custom variables `markdown-edit-code-block-default-mode`
102 and `markdown-fontify-code-block-default-mode` to specify default
103 modes for indirect editing and fontification of code blocks.
104 ([GH-251][], [GH-303][])
105 - Insert-and-indirect-edit GFM code blocks simultaneously by
106 giving a prefix argument to `C-c C-s C`. ([GH-251][])
107 - Improve package load time by deferring calls to
108 `char-displayable-p`. ([GH-264][])
109 - Only raise footnotes when markup hiding is on.
110 Footnote display properties may now be customized via
111 `markdown-footnote-display`. ([GH-247][])
112 - Customizable subscript and superscript display properties
113 via `markdown-sub-superscript-display`.
114 - Several font-lock performance improvements.
115 - Support horizontal rules consisting of underscores.
116 - Change default character encoding to UTF-8.
117 ([GH-340][], [GH-350][])
118 - Support more markdown extensions same as Vim
119 - Complete link text from link labels at inserting link. ([GH-421][])
120 - Improve regular expression for inline attributes. ([GH-406][])
121 - Allow relative CSS stylesheets paths. ([GH-389][])
122 - Improve regular expression matching for inline attributes. ([GH-389][])
123 - If user set `display-buffer-alist` then use `display-buffer`. ([GH-413][])
124 - Add custom variable for opening image. ([GH-383][])
125 - Improve default `markdown-command` setting
126 - Use markdown-command directly instead of 'sh -c' ([GH-319][])
127 - Use explicitly numbered group as possible for easy reading regexp
128 - Support list of strings of `markdown-command`
129 - Apply `markdown-translate-filename-function` for `markdown-display-inline-images`
130 ([GH-422][])
131 - Implement own `filter-buffer-substring-function` for `markdown-view-mode` and
132 `gfm-view-mode` ([GH-493][])
133 - Improve triple backtick behavior with `electric-pair-mode`
134 - Update code block language list
136 * Bug fixes:
138 - No longer treat code fragments that are delimited with three
139 backquotes on each side as the beginning of a code block.
140 ([GH-403][])
141 - Fix infloop caused by incorrect detection of end of code
142 blocks ([GH-349][]).
143 - Remove GFM checkbox overlays when switching major modes.
144 ([GH-238][], [GH-257][])
145 - Don't test the value of the `composition` property to avoid
146 failing tests. ([GH-246][], [GH-258][])
147 - Fix types for `markdown-open-command`, `markdown-uri-types`,
148 and `markdown-hr-strings` defcustoms. ([GH-254][], [GH-259][])
149 - Don't insert trailing whitespace when inserting a blockquote.
150 ([GH-227][], [GH-260][])
151 - Make wiki link test work even when `/tmp` contains an
152 inaccessible subdirectory. ([GH-261][])
153 - Fix `markdown-inline-code-face`'s `:inherit` attribute.
154 ([GH-252][])
155 - Fix type of customizable `markdown-css-paths` variable.
156 ([GH-276][])
157 - Don't set `markdown-code-face` background color at package
158 load time. ([GH-273][])
159 - Don't clobber user specified font-lock keywords when toggling
160 features. ([GH-222][])
161 - Fix font-lock for inline code inside italics and bold.
162 ([GH-275][])
163 - Make code block language detection handle unspecified
164 or unknown code block languages. ([GH-284][])
165 - Fix precedence of inline code over inline links.
166 - Improve error reporting for `markdown` and `markdown-open`.
167 ([GH-291][])
168 - Fix M-RET binding for terminals. ([GH-317][])
169 - Do not fail displaying inline images on empty links. ([GH-320][])
170 - Fix off-by-one error in `markdown-inline-code-at-pos`.
171 ([GH-313][])
172 - Fix bounds during inline comment syntax propertization. ([GH-327][])
173 - Fix wrong metadata highlighting. ([GH-437][])
174 - Fix wrong italic highlighting in HTML attributes. ([GH-410][])
175 - Fix markdown-follow-thing-at-point issue for continuous links. ([GH-305][])
176 - Fix wrong setting major-mode issue at following wiki link([GH-427][])
177 - Fix not consider `markdown-list-indent-width` issue([GH-405][])
178 - Fix URL open issue which contains end parentheses ([GH-408][])
179 - Follow link even if it is in header([GH-430][])
180 - Fix clean up list number issue([GH-392][])
181 - Fix insert markup functions in consecutive case([GH-283][])
182 - Fix hide markup issue in markdown/gfm-view-mode([GH-468][])
183 - Fix bold regexp issue([GH-325][])
184 - Fix italic and punctual character issue([GH-359][])
185 - Fix table align issue when column contains escaped bar([GH-308][])
186 - Fix nested block fill-paragraph issue([GH-366][])
187 - Fix table transpose issue with wiki link
188 - Fix indent-region for pre block([GH-228][])
189 - Fix link highlight issue which contains escaped right bracket([GH-409][])
190 - Fix math inline single/double highlight issue([GH-352][])
191 - Fix markdown-table-forward-cell escaped vertical bar issue([GH-489][])
192 - Fix markdown-table-backward-cell escaped vertical bar issue
193 - Fix GFM italic markup issue([GH-448][])
195 [gh-171]: https://github.com/jrblevin/markdown-mode/issues/171
196 [gh-216]: https://github.com/jrblevin/markdown-mode/issues/216
197 [gh-222]: https://github.com/jrblevin/markdown-mode/issues/222
198 [gh-224]: https://github.com/jrblevin/markdown-mode/issues/224
199 [gh-227]: https://github.com/jrblevin/markdown-mode/issues/227
200 [gh-228]: https://github.com/jrblevin/markdown-mode/issues/228
201 [gh-229]: https://github.com/jrblevin/markdown-mode/pull/229
202 [gh-235]: https://github.com/jrblevin/markdown-mode/issues/235
203 [gh-238]: https://github.com/jrblevin/markdown-mode/issues/238
204 [gh-246]: https://github.com/jrblevin/markdown-mode/issues/246
205 [gh-247]: https://github.com/jrblevin/markdown-mode/issues/247
206 [gh-248]: https://github.com/jrblevin/markdown-mode/issues/248
207 [gh-249]: https://github.com/jrblevin/markdown-mode/issues/249
208 [gh-251]: https://github.com/jrblevin/markdown-mode/issues/251
209 [gh-252]: https://github.com/jrblevin/markdown-mode/pull/252
210 [gh-254]: https://github.com/jrblevin/markdown-mode/issues/254
211 [gh-255]: https://github.com/jrblevin/markdown-mode/issues/255
212 [gh-257]: https://github.com/jrblevin/markdown-mode/pull/257
213 [gh-258]: https://github.com/jrblevin/markdown-mode/pull/258
214 [gh-259]: https://github.com/jrblevin/markdown-mode/pull/259
215 [gh-260]: https://github.com/jrblevin/markdown-mode/pull/260
216 [gh-261]: https://github.com/jrblevin/markdown-mode/pull/261
217 [gh-262]: https://github.com/jrblevin/markdown-mode/pull/262
218 [gh-263]: https://github.com/jrblevin/markdown-mode/pull/263
219 [gh-264]: https://github.com/jrblevin/markdown-mode/pull/264
220 [gh-266]: https://github.com/jrblevin/markdown-mode/issues/266
221 [gh-268]: https://github.com/jrblevin/markdown-mode/issues/268
222 [gh-270]: https://github.com/jrblevin/markdown-mode/issues/270
223 [gh-272]: https://github.com/jrblevin/markdown-mode/issues/272
224 [gh-273]: https://github.com/jrblevin/markdown-mode/issues/273
225 [gh-274]: https://github.com/jrblevin/markdown-mode/pull/274
226 [gh-275]: https://github.com/jrblevin/markdown-mode/issues/275
227 [gh-276]: https://github.com/jrblevin/markdown-mode/issues/276
228 [gh-277]: https://github.com/jrblevin/markdown-mode/pull/277
229 [gh-280]: https://github.com/jrblevin/markdown-mode/issues/280
230 [gh-281]: https://github.com/jrblevin/markdown-mode/pull/281
231 [gh-283]: https://github.com/jrblevin/markdown-mode/issues/283
232 [gh-284]: https://github.com/jrblevin/markdown-mode/issues/284
233 [gh-291]: https://github.com/jrblevin/markdown-mode/issues/291
234 [gh-296]: https://github.com/jrblevin/markdown-mode/issues/296
235 [gh-303]: https://github.com/jrblevin/markdown-mode/pull/303
236 [gh-305]: https://github.com/jrblevin/markdown-mode/issues/305
237 [gh-308]: https://github.com/jrblevin/markdown-mode/issues/308
238 [gh-313]: https://github.com/jrblevin/markdown-mode/issues/313
239 [gh-317]: https://github.com/jrblevin/markdown-mode/pull/317
240 [gh-319]: https://github.com/jrblevin/markdown-mode/issues/319
241 [gh-320]: https://github.com/jrblevin/markdown-mode/pull/320
242 [gh-322]: https://github.com/jrblevin/markdown-mode/pull/322
243 [gh-325]: https://github.com/jrblevin/markdown-mode/issues/325
244 [gh-327]: https://github.com/jrblevin/markdown-mode/issues/327
245 [gh-331]: https://github.com/jrblevin/markdown-mode/issues/331
246 [gh-335]: https://github.com/jrblevin/markdown-mode/pull/335
247 [gh-340]: https://github.com/jrblevin/markdown-mode/issues/340
248 [gh-349]: https://github.com/jrblevin/markdown-mode/issues/349
249 [gh-350]: https://github.com/jrblevin/markdown-mode/pull/350
250 [gh-352]: https://github.com/jrblevin/markdown-mode/issues/352
251 [gh-359]: https://github.com/jrblevin/markdown-mode/issues/359
252 [gh-366]: https://github.com/jrblevin/markdown-mode/issues/366
253 [gh-369]: https://github.com/jrblevin/markdown-mode/pull/369
254 [gh-378]: https://github.com/jrblevin/markdown-mode/pull/378
255 [gh-383]: https://github.com/jrblevin/markdown-mode/issues/383
256 [gh-389]: https://github.com/jrblevin/markdown-mode/pull/389
257 [gh-392]: https://github.com/jrblevin/markdown-mode/pull/392
258 [gh-403]: https://github.com/jrblevin/markdown-mode/issues/403
259 [gh-405]: https://github.com/jrblevin/markdown-mode/issues/405
260 [gh-406]: https://github.com/jrblevin/markdown-mode/issues/406
261 [gh-408]: https://github.com/jrblevin/markdown-mode/issues/408
262 [gh-409]: https://github.com/jrblevin/markdown-mode/issues/409
263 [gh-410]: https://github.com/jrblevin/markdown-mode/issues/410
264 [gh-413]: https://github.com/jrblevin/markdown-mode/issues/413
265 [gh-415]: https://github.com/jrblevin/markdown-mode/issues/415
266 [gh-421]: https://github.com/jrblevin/markdown-mode/issues/421
267 [gh-422]: https://github.com/jrblevin/markdown-mode/issues/422
268 [gh-427]: https://github.com/jrblevin/markdown-mode/issues/427
269 [gh-428]: https://github.com/jrblevin/markdown-mode/issues/428
270 [gh-430]: https://github.com/jrblevin/markdown-mode/issues/430
271 [gh-437]: https://github.com/jrblevin/markdown-mode/issues/437
272 [gh-448]: https://github.com/jrblevin/markdown-mode/issues/448
273 [gh-451]: https://github.com/jrblevin/markdown-mode/issues/451
274 [gh-468]: https://github.com/jrblevin/markdown-mode/issues/468
275 [gh-489]: https://github.com/jrblevin/markdown-mode/issues/489
276 [gh-493]: https://github.com/jrblevin/markdown-mode/pull/493
278 # Markdown Mode 2.3
280 *August 31, 2017*
282 * **Breaking changes:**
284 - `markdown-mode` now requires Emacs 24.3 or later.
285 - Markup insertion and replacement keybindings under <kbd>C-c
286 C-s</kbd> (_s_ for style) have been revised to make them
287 easier to remember. Now, when the prefix <kbd>C-c C-s</kbd>
288 is pressed, a short minibuffer help prompt is presented as a
289 reminder of a few of the most frequently used keys. The major
290 changes are that bold is now inserted with <kbd>b</kbd>
291 (previously <kbd>s</kbd>) and italic is now <kbd>i</kbd>
292 (previously <kbd>e</kbd>). As a result, blockquote is now
293 <kbd>q</kbd> (previously <kbd>b</kbd>) and strikethrough
294 markup is inserted with <kbd>s</kbd> (previously
295 <kbd>d</kbd>). Press <kbd>C-c C-s C-h</kbd> for a complete
296 list of markup insertion keybindings. Heading insertion
297 commands are also now under <kbd>C-c C-s</kbd>.
298 - Link insertion and editing has been consolidated into one
299 command, `markdown-insert-link`, bound to <kbd>C-c C-l</kbd>.
300 As such, the previous separate link insertion keybindings have
301 been removed: <kbd>C-c C-a l</kbd>, <kbd>C-c C-a L</kbd>,
302 <kbd>C-c C-a r</kbd>, and <kbd>C-c C-a u</kbd>.
303 - Image insertion and editing has been consolidated into one
304 command, `markdown-insert-image`, bound to <kbd>C-c C-i</kbd>.
305 As such, the previous separate image insertion keybindings have
306 been removed: <kbd>C-c C-i i</kbd> and <kbd>C-c C-i I</kbd>.
307 - Footnote and wiki link insertion have been moved to the
308 markup insertion prefix, as <kbd>C-c C-s f</kbd> and
309 <kbd>C-c C-s w</kbd>.
310 - The list and outline editing commands have been removed from
311 the top-level positions (previously <kbd>M-LEFT</kbd>,
312 <kbd>M-RIGHT</kbd>, <kbd>M-UP</kbd>, <kbd>M-DOWN</kbd>)
313 and moved to major mode keybindings under <kbd>C-c</kbd> to
314 <kbd>C-c LEFT</kbd>, <kbd>C-c RIGHT</kbd>,
315 <kbd>C-c UP</kbd>, and <kbd>C-c DOWN</kbd>, respectively.
316 ([GH-164][])
317 - The list and outline editing commands have also been unified
318 so that they all operate on entire subtrees of list items and
319 subtrees of atx headings, symmetrically. Previously there were
320 separate commands for editing heading subtrees, but promoting
321 a single section is easy enough by directly inserting or
322 removing a hash mark or using the markup replacement commands.
323 - Jumping between references and reference definitions via
324 `markdown-jump`, previously bound to <kbd>C-c C-l</kbd>, has
325 been moved to <kbd>C-c C-d</kbd> and rebranded as
326 `markdown-do`, which attempts to do something sensible with
327 the object at the point.
328 - Rename internal `markdown-link-link` to `markdown-link-url`
329 for clarity.
330 - The old inline image toggling command <kbd>C-c C-i C-t</kbd>
331 has been removed and replaced <kbd>C-c C-x C-i</kbd> in order
332 to allow for the new interactive image insertion command at
333 <kbd>C-c C-i</kbd>. Toggling keybindings are currently being
334 grouped under <kbd>C-c C-x</kbd>.
335 - `markdown-blockquote-face` is now applied to the entire
336 blockquote, including the leading `>`, so it can be used to
337 apply a background if desired.
338 - In `markdown-regex-header`, groups 4 and 6 now include
339 whitespace surrounding hash marks in atx headings.
340 - Font lock for `~~strikethrough~~` is now supported in
341 `markdown-mode` in addition to `gfm-mode`.
342 - Introduced a new face for horizontal rules: `markdown-hr-face`.
343 Previously, `markdown-header-delimiter-face` was used.
344 - Markdown Mode is now distributed under the GNU GPL version 3
345 or later.
346 - Rename `markdown-fill-forward-paragraph-function` to
347 `markdown-fill-forward-paragraph`.
348 - Rename `markdown-footnote-face` to `markdown-footnote-marker-face`.
349 - Functions `markdown-insert-inline-link-dwim` and
350 `markdown-insert-reference-link-dwim` have been combined and
351 replaced with `markdown-insert-link`.
352 - Functions `markdown-exdent-region` and `markdown-exdent-or-delete`
353 are now named `markdown-outdent-region` and
354 `markdown-outdent-or-delete`, respectively.
355 - The non-interactive image insertion commands have been
356 refactored to mirror the corresponding link insertion
357 commands. `markdown-insert-image` (for inline images) has
358 been renamed `markdown-insert-inline-image` and it now takes
359 three arguments (previously one optional argument).
360 `markdown-insert-reference-image` now takes four arguments
361 (previously none).
363 * New features:
365 - Markup hiding: Add a custom variable `markdown-hide-markup`,
366 which determines whether to hide or otherwise beautify
367 Markdown markup. For example, for inline links the brackets,
368 URL, and title will be hidden and only the (clickable) link
369 text will remain. The URL can be seen by hovering with the
370 mouse pointer and edited by deleting one of the invisible
371 brackets or parentheses. This can be toggled interactively
372 using <kbd>C-c C-x C-m</kbd> (`markdown-toggle-markup-hiding`).
373 This setting supersedes URL hiding (below). ([GH-130][])
374 - Unicode bullets are used to replace ASCII list item markers
375 for unordered lists when markup hiding is enabled. The list
376 of characters used, in order of list level, can be specified
377 by setting the variable `markdown-list-item-bullets`.
378 ([GH-130][])
379 - When markup hiding is enabled, the characters used for
380 replacing certain markup can be changed by customizing the
381 corresponding variables:
382 `markdown-blockquote-display-char`,
383 `markdown-hr-display-char`, and
384 `markdown-definition-display-char`.
385 - URL and reference label hiding: URLs for inline links and
386 labels for reference links can now be hidden if desired. This is
387 configurable via `markdown-hide-urls`. URLs will appear as
388 `[link](∞)` instead of
389 `[link](http://perhaps.a/very/long/url/)`. To change the
390 placeholder character used, set `markdown-url-compose-char`.
391 This feature can be toggled using <kbd>C-c C-x C-l</kbd>
392 (`markdown-toggle-url-hiding`). If full markup hiding (above)
393 is enabled, then URL hiding has no additional effect.
394 - Native code block font-lock: Add a custom variable
395 `markdown-fontify-code-blocks-natively`, which determines
396 whether to fontify code in code blocks using the native major
397 mode. This only works for fenced code blocks where the
398 language is specified where we can automatically determine the
399 appropriate mode to use. The language to mode mapping may be
400 customized by setting the variable `markdown-code-lang-modes`.
401 ([GH-123][], [GH-185][])
402 - When the [`edit-indirect`](https://github.com/Fanael/edit-indirect/)
403 package is installed, <kbd>C-c '</kbd> (`markdown-edit-code-block`)
404 can be used to edit a code block in an indirect buffer in the native
405 major mode. Press <kbd>C-c C-c</kbd> to commit changes and return
406 or <kbd>C-c C-k</kbd> to cancel.
407 - Add command <kbd>C-c C-x C-f</kbd> for toggling native font lock
408 for code blocks (`markdown-toggle-fontify-code-blocks-natively`).
409 - Add "page" movement, marking, and narrowing commands, where a
410 "page" in Markdown is defined to be a top-level subtree:
411 `markdown-forward-page` (<kbd>C-x ]</kbd>),
412 `markdown-backward-page` (<kbd>C-x [</kbd>),
413 `markdown-mark-page` (<kbd>C-x C-p</kbd>), and
414 `markdown-narrow-to-page` (<kbd>C-x n p</kbd>). ([GH-191][])
415 - Add subtree marking and narrowing functions:
416 `markdown-mark-subtree` (<kbd>C-c C-M-h</kbd>) and
417 `markdown-narrow-to-subtree` (<kbd>C-x n s</kbd>).
418 ([GH-191][])
419 - Add syntax-aware Markdown paragraph movement commands:
420 <kbd>M-{</kbd> (`markdown-backward-paragraph`) and
421 <kbd>M-}</kbd> (`markdown-forward-paragraph`). To mark a
422 paragraph, use <kbd>M-h</kbd> (`markdown-mark-paragraph`).
423 These move at a more granular level than the block movement
424 commands. ([GH-191][])
425 - The previous block movement and marking commands are now at
426 <kbd>C-M-{</kbd>, <kbd>C-M-}</kbd>, and <kbd>C-c M-h</kbd>.
427 In terms of lists, paragraph movement commands now stop at
428 each list item while block commands move over entire lists.
429 ([GH-191][])
430 - Add `subtree` as a possible value for
431 `markdown-reference-location` and
432 `markdown-footnote-location`.
433 - Ask flyspell to ignore words in URLs, code fragments,
434 comments, and reference labels.
435 - Make inline links, reference links, angle bracket URLs, and
436 plain URLs clickable.
437 - Add an additional keybinding for toggling inline image
438 display, <kbd>C-c C-x C-i</kbd>.
439 - Add a keybinding for toggling LaTeX math (_e_quation) support:
440 <kbd>C-c C-x C-e</kbd>.
441 - Support Leanpub blocks (asides, info blocks, warnings, etc.).
442 These are simple extensions of the usual blockquote syntax.
443 - Font lock, with markup hiding, for subscripts (e.g., `H~2~0`)
444 and superscripts (e.g., `334^10^`). Thanks to Syohei Yoshida
445 for a patch on which this is based. ([GH-134][])
446 - Add basic font-lock support for inline attribute lists or
447 inline identifiers used by Pandoc, Python Markdown, PHP
448 Markdown Extra, Leanpub, etc.
449 - Add basic font-lock support for Leanpub section identifiers and
450 page breaks.
451 - Add basic font-lock support for common file inclusion syntax:
452 `<<(file)`, `<<[title](file)`, `<<[file]`, and `<<{file}`.
453 - Add font lock support for Pandoc inline footnotes. ([GH-81][])
454 - Raise footnote markers and inline footnote text, and
455 optionally hide markup.
456 - Filling with now respects Pandoc line blocks. ([GH-144][])
457 - Add interactive link editing and insertion command
458 `markdown-insert-link`. ([GH-199][])
459 - Added <kbd>C-c C-d</kbd>, `markdown-do`, which is a
460 replacement for <kbd>C-c C-l</kbd>, `markdown-jump`. In
461 addition to jumping between reference/footnote labels and
462 definitions, it also toggles GFM checkboxes.
463 - Outline movement keys <kbd>C-c C-p</kbd>, <kbd>C-c C-n</kbd>,
464 <kbd>C-c C-f</kbd>, <kbd>C-c C-b</kbd>, and <kbd>C-c C-u</kbd>
465 now move between list items, when the point is in a list,
466 and move between headings otherwise.
467 - New customization option `markdown-spaces-after-code-fence` to
468 control the number of spaces inserted after a code fence (` ``` `).
469 Thanks to Philipp Stephani for a patch. ([GH-232][])
470 - New customization option `markdown-gfm-uppercase-checkbox` which,
471 when non-nil, uses `[X]` to complete task list items instead of
472 `[x]`. Thanks to Paul Rankin for a patch. ([GH-236][])
473 - Add prefix-specific prompts for styles (`C-c C-s`) and toggles
474 (`C-c C-x`). These may be disabled if desired by setting
475 `markdown-enable-prefix-prompts` to `nil`.
477 * Improvements:
479 - Document customizable variables added in version 2.2 with
480 `:package-version` tags.
481 - Better consistency of function names: predicate functions
482 ending in `-p` shouldn't modify match data.
483 - Generalize rebinding of paragraph movement commands in case users
484 have customized `{forward,backward,mark}-paragraph` bindings.
485 - Adjust point so that it is left at beginning of setext
486 headings in heading navigation commands.
487 - Prevent inline link matching in code blocks.
488 - When inserting a new reference definition, don't add blank
489 line after existing reference definitions.
490 - `markdown-toggle-inline-images` now displays the status in the
491 minibuffer.
492 - Increased default heading scaling range slightly, to make
493 level differences more pronounced when markup is hidden.
494 - Reuse existing windows, when possible, rather than splitting
495 again in preferred direction. ([GH-129][])
496 - Update known languages in `markdown-gfm-recognized-languages`.
497 - Filling with `fill-region` now leaves code blocks unmodified.
498 ([GH-192][])
499 - Avoid error when live-previewing a buffer that's not visiting
500 a file. Thanks to Tianxiang Xiong for a patch.
501 ([GH-200][], [GH-201][])
502 - Adaptive filling for Leanpub blocks.
503 - Set variable `comment-use-syntax`. ([GH-213][])
504 - Support `electric-quote-inhibit-functions` for inhibiting
505 electric quoting in code spans and blocks. Thanks to Philipp
506 Stephani for patches to both Emacs and Markdown Mode.
507 ([GH-220][])
508 - Stop inhibiting line breaks inside links when filling.
509 ([GH-173][])
511 * Bug fixes:
513 - Fix spurious bold/italic faces in inline code. ([GH-172][])
514 - Fix defun movement at end of buffer. ([GH-197][])
515 - Fix bug with adjacent bold font-locking in a list
516 item. ([GH-176][])
517 - Prevent matching italics, bold, and inline code in comments.
518 - Prevent matching italics and bold in URLs.
519 - Prevent matching links in inline code or comment spans.
520 - Avoid infinite loop when promoting or demoting last section in
521 a buffer.
522 - Fix font lock for subsequent inline links after a malformed
523 inline link. ([GH-209][])
524 - Prevent clobbering match data in
525 `markdown-font-lock-extend-region-function`. Thanks to
526 Philipp Stephani for a patch. ([GH-221][])
527 - Fix incorrect indentation of inserted GFM code blocks in lists.
528 Thanks to Philipp Stephani for a patch. ([GH-215][])
529 - Fix an issue with font lock for headings with code blocks immediately
530 afterwards, without whitespace. ([GH-234][])
532 [gh-81]: https://github.com/jrblevin/markdown-mode/issues/81
533 [gh-123]: https://github.com/jrblevin/markdown-mode/issues/123
534 [gh-130]: https://github.com/jrblevin/markdown-mode/issues/130
535 [gh-134]: https://github.com/jrblevin/markdown-mode/issues/134
536 [gh-144]: https://github.com/jrblevin/markdown-mode/issues/144
537 [gh-164]: https://github.com/jrblevin/markdown-mode/issues/164
538 [gh-172]: https://github.com/jrblevin/markdown-mode/issues/172
539 [gh-173]: https://github.com/jrblevin/markdown-mode/issues/173
540 [gh-176]: https://github.com/jrblevin/markdown-mode/issues/176
541 [gh-185]: https://github.com/jrblevin/markdown-mode/issues/185
542 [gh-191]: https://github.com/jrblevin/markdown-mode/issues/191
543 [gh-192]: https://github.com/jrblevin/markdown-mode/issues/192
544 [gh-197]: https://github.com/jrblevin/markdown-mode/issues/197
545 [gh-199]: https://github.com/jrblevin/markdown-mode/issues/199
546 [gh-200]: https://github.com/jrblevin/markdown-mode/issues/200
547 [gh-201]: https://github.com/jrblevin/markdown-mode/issues/201
548 [gh-209]: https://github.com/jrblevin/markdown-mode/issues/209
549 [gh-213]: https://github.com/jrblevin/markdown-mode/issues/213
550 [gh-215]: https://github.com/jrblevin/markdown-mode/issues/215
551 [gh-220]: https://github.com/jrblevin/markdown-mode/pull/220
552 [gh-221]: https://github.com/jrblevin/markdown-mode/pull/221
553 [gh-232]: https://github.com/jrblevin/markdown-mode/pull/232
554 [gh-234]: https://github.com/jrblevin/markdown-mode/issues/234
555 [gh-236]: https://github.com/jrblevin/markdown-mode/pull/236
557 # Markdown Mode 2.2
559 *May 26, 2017*
561 Version 2.2 is a major new stable release and all users are encouraged
562 to upgrade. Thanks to everyone who submitted bug reports, feature
563 suggestions, and especially patches.
565 * **Breaking changes:**
567 - Now use <kbd>C-c C-j</kbd> for inserting list items, like
568 AUCTeX and similar to other programming modes. Since <kbd>C-c
569 C-j</kbd> was used for `markdown-jump` (for moving between
570 reference link/footnote markers and their definitions), it has
571 been changed to <kbd>C-c C-l</kbd> (think "leap" or "loop"
572 instead of jump). It's also close to <kbd>C-c C-o</kbd> (used
573 for opening links). ([GH-26][])
574 - Insertion of `kbd` tags with <kbd>C-c C-s k</kbd> or
575 `markdown-insert-kbd`.
576 - Add YAML metadata parsing. Also allow multiple Pandoc
577 metadata, with tests. Thanks to Danny McClanahan and Syohei
578 Yoshida. ([GH-66][], [GH-91][], [GH-155][], [GH-156][],
579 [GH-157][])
580 - Change the behavior of <kbd>C-c C-o</kbd>
581 (`markdown-follow-link-at-point`) so that if a link is a
582 complete URL, it will open in a browser. Otherwise, open it
583 with `find-file` after stripping anchors and/or query strings.
584 ([GH-132][])
585 - Make font lock for missing wiki links optional and disabled by
586 default. Add new custom variable
587 `markdown-wiki-link-fontify-missing` to control this behavior.
588 - The _function_ `markdown-enable-math` has been made obsolete
589 and renamed to `markdown-toggle-math`. When called without an
590 argument, the result is to toggle this extension rather than
591 enable it.
593 * New features:
595 - Filling for definition list items. ([GH-13][])
596 - Added option `markdown-gfm-downcase-languages` to use
597 lowercase language name in GFM code blocks.
598 ([GH-71][], [GH-73][])
599 - Customizable live preview window split direction via
600 `markdown-split-window-direction`. ([GH-129][], [GH-188][])
601 - Variable-height headings via
602 `markdown-header-scaling`. ([GH-121][])
603 - Implement inline image previews via
604 `markdown-toggle-inline-images` and <kbd>C-c C-i C-t</kbd>.
605 Thanks to Syohei Yoshida. ([GH-122][], [GH-128][])
606 - Added `markdown-wiki-link-search-subdirectories` to enable
607 searching for wiki link files in subdirectories. ([GH-174][])
608 - Added option to automatically continue lists when `RET` is
609 pressed. `markdown-indent-on-enter` now has three settings.
610 ([GH-179][])
611 - Match fenced code blocks with language and info strings.
612 ([GH-184][])
613 - Add smart Markdown block navigation commands <kbd>M-{</kbd>
614 and <kbd>M-}</kbd>. These replace the
615 regular-expression-based "paragraph" movement commands
616 provided by Emacs, which do not recognize Markdown syntax
617 (e.g., headings inside of code blocks). Also use
618 <kbd>M-h</kbd> for marking a block and <kbd>C-x n b</kbd> to
619 narrow to a block.
620 - Add `markdown-nested-imenu-heading-index` as a customizable
621 option. It may be disabled to instead generate a flat imenu
622 index.
623 - Basic font lock and filling for definition lists. As a side
624 effect, list item navigation and movement should also work.
625 - Add command for toggling GFM task list items via
626 <kbd>C-c C-c C-x</kbd> (`markdown-toggle-gfm-checkbox`).
627 - Ability to toggle wiki link support via a new custom variable
628 `markdown-enable-wiki-links`. This may be set in a file local
629 variable. Also added function `markdown-toggle-wiki-links`
630 and a menu item.
632 * Improvements:
634 - Menubar reorganization. Grouped related actions together,
635 added missing commands, and added several toggle options to
636 the menu. ([GH-147][])
637 - Use `toggle` menu style for macOS compatibility.
638 - Remove autoload for `.text` files. Thanks to Steve Purcell.
639 ([GH-118][])
640 - Set own `adaptive-fill-regexp` so that `fill-paragraph` works
641 for list items. Thanks to Syohei Yoshida for the patch.
642 ([GH-79][], [GH-80][])
643 - Suppress minibuffer output when generated HTML is small.
644 Thanks to Syohei Yoshida. ([GH-83][], [GH-86][])
645 - Use GitHub fetcher for `markdown-mode` on MELPA. ([GH-84][])
646 - Improve fenced code block parsing. Thanks to Danny McClanahan.
647 ([GH-85][], [GH-95][])
648 - Markdown Mode is now automatically tested against Emacs
649 24.1-24.5 and 25.1-25.2. ([GH-99][])
650 - Make live-preview mode follow min or max point. Thanks to
651 Danny McClanahan. ([GH-102][])
652 - Improved font-lock performance. ([GH-119][])
653 - Maintain cursor position when indenting instead of moving to
654 the beginning of the line. Thanks to Isaac Hodes.
655 ([GH-125][])
656 - Add used language names to front of list of known languages.
657 ([GH-135][])
658 - Support basic TOML metadata. Thanks to Jorge Israel Peña.
659 ([GH-137][])
660 - Prohibit setext heading text from starting with hyphens,
661 spaces or tabs, so that there is no ambiguity between setext
662 headings and in-progress lists. ([GH-139][], [GH-143][])
663 - Ignore heading lines in `fill-paragraph`. Thanks to Syohei
664 Yoshida. ([GH-159][], [GH-162][])
665 - Improve matching of multiple math blocks with non-math text in
666 between. Thanks to Dave Kleinschmidt for a patch.
667 ([GH-168][])
668 - Prevent `fill-paragraph` from filling lines in code blocks.
669 ([GH-169][])
670 - Fix font lock for links with URLs containing parentheses.
671 ([GH-170][])
672 - `fill-paragraph` now respects paragraph boundaries within
673 blockquotes. ([GH-186][])
674 - Set mark when calling `markdown-up-heading`.
675 - Improved font locking after empty GFM code block insertion.
676 - Fix spurious italics from underscores in URLs.
677 - Respect `font-lock-mode` being nil. Only call
678 `font-lock-refresh-defaults` if `font-lock-mode` is non-nil to
679 prevent it from being turned on when disabled by user. Thanks
680 to Tom May for the patch.
681 - Fix list item insertion on ordered lists with hash marks
682 (Pandoc "fancy lists").
683 - Treat polymode blocks as code blocks when parsing the buffer.
684 - Require whitespace atx heading hashmarks, as required by the
685 original atx specification (but not enforced by Markdown.pl).
686 The benefit is that it prevents false positives for #hashtags
687 and things like "Engine #1" when lines wrap.
688 - Complete heading markup when point is on an setext heading and
689 `markdown-insert-header-dwim` is invoked
690 (<kbd>C-c C-t h</kbd>).
691 - Better point position after inserting asymmetric atx headings.
693 * Bug fixes:
695 - Fix `scripts/get-recognized-gfm-languages.el`, which skipped
696 languages with spaces. ([GH-72][], [GH-82][])
697 - `README.md` specified Arch (AUR) package (`emacs-goodies-el`),
698 which did not exist. ([GH-74][])
699 - Don't accidentally override user entries in `auto-mode-alist`.
700 ([GH-127][])
701 - Fix `markdown-cycle` issue with heading-like strings in code
702 blocks. Thanks to Syohei Yoshida. ([GH-75][], [GH-76][])
703 - Fix moving same level heading over code block issue. Thanks
704 to Syohei Yoshida. ([GH-77][], [GH-78][])
705 - Don't insert empty title strings for links. Thanks to
706 Sebastian Wiesner for the patch. ([GH-89][])
707 - Fix possible infinite loop in `markdown-cleanup-list-numbers`.
708 Thanks to Danny McClanahan. ([GH-98][], [GH-100][])
709 - Fix an args-out-of-range error due to the syntax-propertize
710 function returning point which is larger than `point-max`.
711 Thanks to Syohei Yoshida. ([GH-142][])
712 - Respect narrowed region in `markdown-find-previous-prop`.
713 Thanks to Vitalie Spinu. ([GH-109][])
714 - Move point at least 1 char in
715 `markdown-match-propertized-text` to avoid possible infinite
716 loop in font-lock. Thanks to Vitalie Spinu. ([GH-110][])
717 - Fix issues where buffers could be marked as modified when no
718 modifications were made. ([GH-115][], [GH-116][], [GH-146][])
719 - Fix an issue where comments of the form `<!-- > comment -->`
720 were not correctly identified. ([GH-117][])
721 - Prevent spurious bold fontification. Thanks to Kévin Le
722 Gouguec. ([GH-124][])
723 - Keep metadata visible when cycling visibility. ([GH-136][])
724 - `markdown-syntax-propertize-extend-region` should not
725 overwrite match-data, which caused issues with
726 `replace-regexp`, etc. ([GH-104][], [GH-105][])
727 - Don't list heading-like lines in code blocks or metadata in
728 imenu. Thanks to Syohei Yoshida. ([GH-145][], [GH-154][])
729 - Fix an issue where fill paragraph wouldn't work following
730 unclosed left square brackets. ([GH-148][], [GH-161][])
731 - Fix default language presented when inserting GFM code blocks.
732 Thanks to Conal Elliot for a patch. ([GH-152][])
733 - Backspace now always deletes characters if a region is
734 specified. Thanks to Syohei Yoshida.
735 ([GH-166][], [GH-167][])
736 - Fix `markdown-header-face` inherit from nil error, e.g., when
737 exporting HTML from an Org mode file containing a Markdown
738 source block. Thanks to Moogen Tian for a patch.
739 ([GH-190][], [GH-193][])
740 - Inserting a reference link no longer causes an "args out of
741 range" commit error when the existing reference label is a
742 single commit character.
743 - Fix to honor location setting when inserting reference
744 definitions.
745 - Fixed an issue where, if there is special markup at the end of
746 the buffer, deleting a character backward would cause the
747 font-lock faces to disappear.
748 - Fix incorrect matching of italic text due to underscores in
749 math mode. Thanks also to Dave Kleinschmidt.
750 - Fix italic highlighting issue when each line or both lines are list.
751 - Handle false positive italics across list items.
753 [gh-13]: https://github.com/jrblevin/markdown-mode/issues/13
754 [gh-26]: https://github.com/jrblevin/markdown-mode/issues/26
755 [gh-66]: https://github.com/jrblevin/markdown-mode/issues/66
756 [gh-71]: https://github.com/jrblevin/markdown-mode/issues/71
757 [gh-72]: https://github.com/jrblevin/markdown-mode/issues/72
758 [gh-73]: https://github.com/jrblevin/markdown-mode/issues/73
759 [gh-74]: https://github.com/jrblevin/markdown-mode/issues/74
760 [gh-75]: https://github.com/jrblevin/markdown-mode/issues/75
761 [gh-76]: https://github.com/jrblevin/markdown-mode/pull/76
762 [gh-77]: https://github.com/jrblevin/markdown-mode/pull/77
763 [gh-78]: https://github.com/jrblevin/markdown-mode/pull/78
764 [gh-79]: https://github.com/jrblevin/markdown-mode/issues/79
765 [gh-80]: https://github.com/jrblevin/markdown-mode/pull/80
766 [gh-82]: https://github.com/jrblevin/markdown-mode/pull/82
767 [gh-83]: https://github.com/jrblevin/markdown-mode/issues/83
768 [gh-84]: https://github.com/jrblevin/markdown-mode/issues/84
769 [gh-86]: https://github.com/jrblevin/markdown-mode/pull/86
770 [gh-85]: https://github.com/jrblevin/markdown-mode/issues/85
771 [gh-89]: https://github.com/jrblevin/markdown-mode/pull/89
772 [gh-91]: https://github.com/jrblevin/markdown-mode/pull/91
773 [gh-95]: https://github.com/jrblevin/markdown-mode/pull/95
774 [gh-98]: https://github.com/jrblevin/markdown-mode/issues/98
775 [gh-99]: https://github.com/jrblevin/markdown-mode/pull/99
776 [gh-100]: https://github.com/jrblevin/markdown-mode/pull/100
777 [gh-102]: https://github.com/jrblevin/markdown-mode/pull/102
778 [gh-104]: https://github.com/jrblevin/markdown-mode/issues/104
779 [gh-105]: https://github.com/jrblevin/markdown-mode/pull/105
780 [gh-109]: https://github.com/jrblevin/markdown-mode/pull/109
781 [gh-110]: https://github.com/jrblevin/markdown-mode/pull/110
782 [gh-115]: https://github.com/jrblevin/markdown-mode/issues/115
783 [gh-116]: https://github.com/jrblevin/markdown-mode/pull/116
784 [gh-117]: https://github.com/jrblevin/markdown-mode/issues/117
785 [gh-118]: https://github.com/jrblevin/markdown-mode/pull/118
786 [gh-119]: https://github.com/jrblevin/markdown-mode/issues/119
787 [gh-121]: https://github.com/jrblevin/markdown-mode/issues/121
788 [gh-122]: https://github.com/jrblevin/markdown-mode/issues/122
789 [gh-124]: https://github.com/jrblevin/markdown-mode/issues/124
790 [gh-125]: https://github.com/jrblevin/markdown-mode/pull/125
791 [gh-127]: https://github.com/jrblevin/markdown-mode/issues/127
792 [gh-128]: https://github.com/jrblevin/markdown-mode/pull/128
793 [gh-129]: https://github.com/jrblevin/markdown-mode/issues/129
794 [gh-132]: https://github.com/jrblevin/markdown-mode/pull/132
795 [gh-135]: https://github.com/jrblevin/markdown-mode/issues/135
796 [gh-136]: https://github.com/jrblevin/markdown-mode/issues/136
797 [gh-137]: https://github.com/jrblevin/markdown-mode/issues/137
798 [gh-139]: https://github.com/jrblevin/markdown-mode/issues/139
799 [gh-142]: https://github.com/jrblevin/markdown-mode/pull/142
800 [gh-143]: https://github.com/jrblevin/markdown-mode/issues/143
801 [gh-145]: https://github.com/jrblevin/markdown-mode/issues/145
802 [gh-154]: https://github.com/jrblevin/markdown-mode/pull/154
803 [gh-146]: https://github.com/jrblevin/markdown-mode/pull/146
804 [gh-147]: https://github.com/jrblevin/markdown-mode/issues/147
805 [gh-148]: https://github.com/jrblevin/markdown-mode/issues/148
806 [gh-152]: https://github.com/jrblevin/markdown-mode/issues/152
807 [gh-155]: https://github.com/jrblevin/markdown-mode/issues/155
808 [gh-156]: https://github.com/jrblevin/markdown-mode/issues/156
809 [gh-157]: https://github.com/jrblevin/markdown-mode/pull/157
810 [gh-159]: https://github.com/jrblevin/markdown-mode/issues/159
811 [gh-161]: https://github.com/jrblevin/markdown-mode/issues/161
812 [gh-162]: https://github.com/jrblevin/markdown-mode/pull/162
813 [gh-166]: https://github.com/jrblevin/markdown-mode/issues/166
814 [gh-167]: https://github.com/jrblevin/markdown-mode/pull/167
815 [gh-168]: https://github.com/jrblevin/markdown-mode/pull/168
816 [gh-169]: https://github.com/jrblevin/markdown-mode/issues/169
817 [gh-170]: https://github.com/jrblevin/markdown-mode/issues/170
818 [gh-174]: https://github.com/jrblevin/markdown-mode/issues/174
819 [gh-179]: https://github.com/jrblevin/markdown-mode/issues/179
820 [gh-184]: https://github.com/jrblevin/markdown-mode/issues/184
821 [gh-186]: https://github.com/jrblevin/markdown-mode/issues/186
822 [gh-188]: https://github.com/jrblevin/markdown-mode/pull/188
823 [gh-190]: https://github.com/jrblevin/markdown-mode/pull/190
824 [gh-193]: https://github.com/jrblevin/markdown-mode/issues/193
826 # Markdown Mode 2.1
828 *January 9, 2016*
830 Version 2.1 is a major new stable release and all users are encouraged
831 to upgrade. The many new features and bug fixes included are
832 described below.
834 Markdown Mode is developed and tested primarily for compatibility with
835 GNU Emacs versions 24.3 and later. It requires `cl-lib` version 0.5
836 or later. This library has been bundled with GNU Emacs since version
837 24.3. Users of GNU Emacs 24.1 and 24.2 can install `cl-lib` using
838 `M-x package-install RET cl-lib`.
840 This release of Markdown Mode contains patches written by many
841 individuals including Masayuki Ataka, Jonas Bernoulli, Roger Bolsius,
842 Daniel Brotsky, Julien Danjou, Samuel Freilich, David Glasser, Marijn
843 Haverbeke, Antonis Kanouras, Keshav Kini, Vasily Korytov, Danny
844 McClanahan, Matt McClure, Howard Melman, Makoto Motohashi, Jon
845 Mountjoy, Pierre Neidhardt, Spanti Nicola, Paul W. Rankin, Christophe
846 Rhodes, Tim Visher, and Syohei Yoshida. Many others also submitted
847 bug reports. Thanks to everyone for your contributions.
849 * **Breaking changes:**
851 - In GFM Mode, `visual-line-mode` is no longer enabled by
852 default. A `gfm-mode-hook` was added, which could be used to
853 keep `visual-line-mode` on by default in `gfm-mode`.
854 ([GH-31][])
856 * New features:
858 - Add automatically updating live preview functionality
859 (<kbd>C-c C-c l</kbd>) via the native `eww` browser.
860 ([GH-36][], [GH-53][], [GH-57][], [GH-58][], [GH-63][])
861 - Use `autoload` to enable `markdown-mode` in `auto-mode-alist`
862 for files with `.text`, `.markdown`, and `.md` extensions.
863 - Use Travis CI for automated build testing.
864 - ATX heading subtree promotion and demotion via
865 <kbd>M-S-LEFT</kbd>, and <kbd>M-S-RIGHT</kbd>.
866 - ATX heading subtree moving up and down via <kbd>M-S-UP</kbd>
867 and <kbd>M-S-DOWN</kbd>.
868 - Convert inline links to reference links when
869 `markdown-insert-reference-link-dwim` is used when the point
870 is at an inline link.
871 - Allow linking to multiple stylesheets in `markdown-css-paths`
872 list. Use stylesheets for both preview and export. Previous
873 `markdown-css-path` (singular) is now deprecated.
874 - Customizable default unordered list marker via
875 `markdown-unordered-list-item-prefix`.
876 - Add asymmetric ATX heading adornment option
877 `markdown-asymmetric-header`.
878 - Font lock for `<kbd>` tags.
879 - Support GFM-style code blocks in `markdown-mode` (as well as
880 `gfm-mode`). ([GH-2][])
881 - New function `markdown-electric-backquote` will prompt for a
882 language name for GFM code blocks. This can be disabled by
883 customizing the variable
884 `markdown-gfm-use-electric-backquote`. ([GH-9][])
885 - Completion of programming language names for GFM code blocks.
886 A list of pre-defined languages is included, but this can be
887 augmented by setting `markdown-gfm-additional-languages`.
888 ([GH-38][], [GH-54][], [GH-59][], [GH-60][], [GH-64][])
889 - Strikethrough support in `gfm-mode`.
890 - Support for GFM toggling checkboxes `mouse-1` or
891 <kbd>RET</kbd>. This is controlled by a new custom variable,
892 `markdown-make-gfm-checkboxes-buttons`. Thanks to Howard
893 Melman for a patch. ([GH-7][])
894 - Font lock and filling for Pandoc "fancy lists," which use `#`
895 as the list marker. ([GH-3][])
896 - Basic support for filling of definition lists. ([GH-20][])
897 - Support [Ikiwiki](http://ikiwiki.info/)-style search for wiki links that allows
898 links relative to parent directories. Enable this by setting
899 `markdown-wiki-link-search-parent-directories`.
900 ([GH-8][], [GH-21][])
902 * Improvements:
904 - General font lock improvements for comments, code blocks,
905 blockquotes, headings, horizontal rules, bold, and italics.
906 ([GH-67][], [GH-68][])
907 - Separate highlighting for Markdown markup characters
908 (asterisks, underscores, backquotes, etc.) to aid in
909 readability.
910 - Font lock for bold, italics, and LaTeX math work inside block
911 elements such as headings and blockquotes. ([GH-39][])
912 - Display a link to the GitHub repository in the MELPA
913 description. ([GH-37][])
915 * Bug fixes:
917 - Fix bug in `markdown-complete-region/buffer` where level-two
918 Setext headings could be confused with horizontal rules.
919 Includes a unit test. Thanks to Gunnar Franke for the report.
920 - Fix filling when a decimal number appears at column zero,
921 which could be confused with an ordered list item.
922 - Fix buffer-wide markup completion.
923 - Fix font-lock for GFM code blocks without language keywords.
924 - Improved Setext header insertion to support wide characters.
925 - Fix expensive `paragraph-separate` regular expression.
926 - Make `comment-auto-fill-only-comments` a buffer-local
927 variable, which allows for better default filling behavior in
928 cases where the global variable is non-`nil`.
929 - Fix Emacs 23 compatibility by checking for
930 `font-lock-refresh-defaults` before calling it.
931 - Handle reference definitions when filling paragraphs.
932 - Improve filling of list items with indentation.
933 - Properly handle footnotes when filling.
934 - Fix issues with markdown-footnote-kill and related functions.
935 - Improve font lock for fenced code blocks.
936 - Avoid avoid overwriting source file when exporting if source
937 file has `.html` extension.
938 - Fix and improve ordered list behavior to preserve digit
939 spacing and avoid an infinite loop in certain cases. Adjust
940 ordered list whitespace when marker digit count increases.
941 - Improve reference definition regular expression to avoid
942 matching multiple reference links in one line.
943 - Allow spaces in fenced code language identifiers. ([GH-22][])
944 - Improve font lock for preformatted blocks and fenced code
945 blocks.
946 - Fix out-of-order HTML output. ([GH-14][])
947 - Add console-friendly backspace and tab bindings. ([GH-15][])
948 - Better treatment of files without extensions for wiki links.
949 When files have no extensions, don't append a lone period.
950 ([GH-23][])
951 - Call `looking-back` with two arguments for compatibility with
952 Emacs 25.1.
953 - Make `(beginning-of-defun -1)` go to next title when point is
954 at beginning of defun. ([GH-34][])
955 - Ignore headings in code blocks for font lock, movement, and
956 visibility cycling.
957 ([GH-27][], [GH-33][], [GH-35][], [GH-40][], [GH-41][])
958 - Don't highlight wiki links in code blocks. ([GH-17][])
959 - Don't move to links in code blocks with <kbd>C-c C-p</kbd> and
960 <kbd>C-c C-n</kbd>.
961 - Fix hanging indentation for list items and single-line
962 preformatted blocks. ([GH-16][], [GH-28][], [GH-30][])
963 - Better rejection of false positives for italics with respect
964 to other inline elements (inline code and bold).
965 - Predicate functions should not modify match data.
966 - Use correct list marker from previous list level when using
967 <kbd>C-u M-RET</kbd> to insert a dedented list item. Prevent
968 an infinite loop in some cases. ([GH-4][])
969 - Reduce lag when scrolling or inserting text into large files.
970 ([GH-30][], [GH-101][])
971 - Avoid confusing tramp errors with malformed wiki links.
972 ([GH-65][])
974 [gh-2]: https://github.com/jrblevin/markdown-mode/pull/2
975 [gh-3]: https://github.com/jrblevin/markdown-mode/pull/3
976 [gh-4]: https://github.com/jrblevin/markdown-mode/issues/4
977 [gh-7]: https://github.com/jrblevin/markdown-mode/issues/7
978 [gh-8]: https://github.com/jrblevin/markdown-mode/issues/8
979 [gh-9]: https://github.com/jrblevin/markdown-mode/issues/9
980 [gh-14]: https://github.com/jrblevin/markdown-mode/issues/14
981 [gh-15]: https://github.com/jrblevin/markdown-mode/issues/15
982 [gh-16]: https://github.com/jrblevin/markdown-mode/issues/16
983 [gh-17]: https://github.com/jrblevin/markdown-mode/issues/17
984 [gh-18]: https://github.com/jrblevin/markdown-mode/issues/18
985 [gh-20]: https://github.com/jrblevin/markdown-mode/issues/20
986 [gh-21]: https://github.com/jrblevin/markdown-mode/issues/21
987 [gh-22]: https://github.com/jrblevin/markdown-mode/issues/22
988 [gh-23]: https://github.com/jrblevin/markdown-mode/issues/23
989 [gh-27]: https://github.com/jrblevin/markdown-mode/issues/27
990 [gh-28]: https://github.com/jrblevin/markdown-mode/issues/28
991 [gh-30]: https://github.com/jrblevin/markdown-mode/issues/30
992 [gh-31]: https://github.com/jrblevin/markdown-mode/issues/31
993 [gh-32]: https://github.com/jrblevin/markdown-mode/pull/32
994 [gh-33]: https://github.com/jrblevin/markdown-mode/issues/33
995 [gh-34]: https://github.com/jrblevin/markdown-mode/pull/34
996 [gh-35]: https://github.com/jrblevin/markdown-mode/pull/35
997 [gh-36]: https://github.com/jrblevin/markdown-mode/pull/36
998 [gh-37]: https://github.com/jrblevin/markdown-mode/issues/37
999 [gh-38]: https://github.com/jrblevin/markdown-mode/issues/38
1000 [gh-39]: https://github.com/jrblevin/markdown-mode/issues/39
1001 [gh-40]: https://github.com/jrblevin/markdown-mode/pull/40
1002 [gh-41]: https://github.com/jrblevin/markdown-mode/pull/41
1003 [gh-53]: https://github.com/jrblevin/markdown-mode/pull/53
1004 [gh-54]: https://github.com/jrblevin/markdown-mode/pull/54
1005 [gh-57]: https://github.com/jrblevin/markdown-mode/pull/57
1006 [gh-58]: https://github.com/jrblevin/markdown-mode/pull/58
1007 [gh-59]: https://github.com/jrblevin/markdown-mode/pull/59
1008 [gh-60]: https://github.com/jrblevin/markdown-mode/pull/60
1009 [gh-63]: https://github.com/jrblevin/markdown-mode/pull/63
1010 [gh-64]: https://github.com/jrblevin/markdown-mode/pull/64
1011 [gh-65]: https://github.com/jrblevin/markdown-mode/pull/65
1012 [gh-67]: https://github.com/jrblevin/markdown-mode/pull/67
1013 [gh-68]: https://github.com/jrblevin/markdown-mode/pull/68
1014 [gh-101]: https://github.com/jrblevin/markdown-mode/issues/101
1016 # Markdown Mode 2.0
1018 *March 24, 2013*
1020 Version 2.0 is a major new stable release with many new features,
1021 including some changes to keybindings for element insertion and
1022 outline navigation. In summary, Markdown Mode now has improved
1023 keybindings, smarter markup insertion commands, a general markup
1024 removal command, markup completion (normalization), markup promotion
1025 and demotion, list and region editing, many syntax highlighting
1026 improvements, new and improved movement commands, and generalized link
1027 following and movement.
1029 * **Breaking changes:**
1031 - Physical style element insertion commands prefixed by
1032 <kbd>C-c C-p</kbd> have been removed in favor of their
1033 logical style counterparts prefixed by <kbd>C-c C-s</kbd>.
1034 - Shift is now the preferred way to distinguish keybindings for
1035 two related elements. For example, you can insert an inline
1036 link with <kbd>C-c C-a l</kbd> or a reference link with
1037 <kbd>C-c C-a L</kbd>. The latter keybinding is new and
1038 preferred over <kbd>C-c C-a r</kbd>, which is deprecated.
1039 - Footnote keybindings have been moved away from the
1040 <kbd>C-c C-f n</kbd> prefix.
1041 - Several other new keybindings have been introduced and are
1042 described in more detail below.
1043 - Removed wiki link following with `RET` and
1044 `markdown-follow-wiki-link-on-enter` setting. Use the
1045 unified following (open link) command <kbd>C-c C-o</kbd>
1046 instead.
1048 * New features:
1050 - Fast heading insertion with a single command which
1051 automatically calculates the type (atx or setext) and level.
1052 Prefix with <kbd>C-u</kbd> to promote the heading by one
1053 level or <kbd>C-u C-u</kbd> to demote the heading by one
1054 level. Headings with a specific level or type can still be
1055 inserted quickly with specific keybindings.
1056 - Easily kill an element (e.g., a link or reference definition)
1057 at the point with <kbd>C-c C-k</kbd> and store the most
1058 important part in the kill ring (e.g., the link text or URL).
1059 - Markup completion (<kbd>C-c C-]</kbd>) normalizes the markup
1060 for an element (e.g., it balances hash marks and removing
1061 extra whitespace for atx headings).
1062 - Markup promotion and demotion via <kbd>C-c C--</kbd> and
1063 <kbd>C-c C-=</kbd>, respectively. The sequences
1064 <kbd>M-UP</kbd> and <kbd>M-DOWN</kbd> may
1065 also be used.
1066 - List editing: move list items up and down with
1067 <kbd>M-UP</kbd> and <kbd>M-DOWN</kbd>.
1068 Indent and exdent list items with <kbd>M-LEFT</kbd>
1069 and <kbd>M-RIGHT</kbd>.
1070 - Region editing: indent and exdent regions, with tab stops
1071 determined by context, using <kbd>C-c <</kbd> and
1072 <kbd>C-c ></kbd> (as in `python-mode`).
1073 - Smart list item insertion with <kbd>M-RET</kbd>, with
1074 indentation and marker determined by the surrounding context.
1075 Prefix with <kbd>C-u</kbd> to decrease the indentation by one
1076 level or <kbd>C-u C-u</kbd> to increase the indentation one
1077 level.
1078 - Quickly jump between reference definitions and
1079 reference-style links and between footnote markers and
1080 footnote text with <kbd>C-c C-j</kbd>. Create undefined
1081 references when jumping from a reference link. When jumping
1082 back, present a buffer with buttons for selecting which link
1083 to jump to.
1084 - Revised outline navigation commands, following `org-mode`.
1085 This frees up the sexp navigation keys <kbd>C-M-f</kbd> and
1086 <kbd>C-M-b</kbd> which can be useful in Markdown documents
1087 which have many matching delimiters, as well as the defun
1088 navigation keys <kbd>C-M-a</kbd> and <kbd>C-M-e</kbd>.
1089 - Previous/next section movement with <kbd>C-M-a</kbd> and
1090 <kbd>C-M-e</kbd> (in Emacs parlance, this is movement by
1091 defun). Mark the current section with <kbd>C-M-h</kbd>.
1092 - Previous/next paragraph movement via <kbd>M-{</kbd> and
1093 <kbd>M-}</kbd>.
1094 - Previous/next block movement with <kbd>C-u M-{</kbd> and
1095 <kbd>C-u M-}</kbd>.
1096 - Customizable reference link location via
1097 `markdown-reference-location`.
1098 - Font lock for title strings in inline links.
1099 - Subtle syntax highlighting for hard line breaks.
1100 - In GFM Mode, change italic font lock behavior to match GFM
1101 specification regarding underscores in words.
1102 - Insertion command (<kbd>C-c C-s P</kbd>) for GFM quoted code
1103 blocks.
1104 - Syntax highlighting for MultiMarkdown metadata and Pandoc
1105 title blocks.
1106 - Added before and after export hooks
1107 `markdown-before-export-hook` and
1108 `markdown-after-export-hook`.
1109 - Added a library of regression tests which currently contains
1110 160 unit tests.
1112 * Improvements:
1114 - ATX heading insertion will use current line as heading text
1115 if not blank and there is no active region.
1116 - Setext heading insertion will prompt for heading title when
1117 there is no active region.
1118 - When the point is at a heading, the heading insertion
1119 commands will replace the heading at point with a heading of
1120 the requested level and type.
1121 - When there is no active region, the bold, italic, code, link,
1122 and image insertion commands will operate on the word at
1123 point, if any, so that you don't have to have an active
1124 selection for simple modifications.
1125 - Repeating the bold, italic, or code insertion commands when
1126 the point is at an element of the corresponding type will
1127 remove the markup.
1128 - Indentation of preformatted text and blockquotes will be
1129 adjusted automatically in contexts where more indentation is
1130 required, as in nested lists. (For example, in Markdown, a
1131 preformatted text block inside a first-level list item must
1132 have eight spaces of indentation.)
1133 - Improved reference link insertion with label completion:
1134 + Use word at point as link text, if possible, when there
1135 is no active region.
1136 + Tab completion of reference labels from the set of
1137 currently defined references.
1138 + Reference link insertion no longer prompts for a URL or
1139 title if the label is already defined.
1140 + If no URL is given, create an empty reference definition
1141 and move the point there.
1142 - Basic reference-style image markup insertion.
1143 - Multiple horizontal rule styles, `markdown-hr-strings`,
1144 customizable as a list of strings, which can be cycled
1145 through.
1146 - New URL insertion command for inserting plain URLs delimited
1147 by angle brackets (<kbd>C-c C-a u</kbd>). Works on URL at
1148 point, if any, when there is no active region.
1149 - Generally improved insertion commands with respect to
1150 insertion of surrounding whitespace and point position after
1151 insertion (e.g., ensuring blank lines before and after newly
1152 inserted headings and horizontal rules).
1153 - Unified link following: open links in a browser and wiki
1154 links in a new buffer with the same keybinding (<kbd>C-c
1155 C-o</kbd>). This supersedes the separate wiki link following
1156 command (<kbd>C-c C-w</kbd>).
1157 - Generalized link movement and following: move between and
1158 open all link types (inline, reference, wiki, angle URIs)
1159 using the same key bindings (<kbd>M-n</kbd> and
1160 <kbd>M-p</kbd>). Previously, these commands only moved
1161 between wiki links, but with the above following enhancement,
1162 moving between hyperlinks of all types is more useful.
1163 - Syntax highlighting for GFM quoted code blocks with an
1164 optional language keyword.
1165 - Dynamic loading and unloading for math support with
1166 refontification.
1167 - Allow underscores and colons in equation labels in math mode.
1168 - Syntax highlighting improvements: faster identification of
1169 preformatted blocks. Markdown Mode adheres to the four space
1170 rule for nested list items: in a list item of level _n_,
1171 preformatted text must be indented at least 4(_n_ + 1)
1172 spaces.
1173 - More inclusive blockquote regular expression highlights
1174 blockquotes with leading indentation, when appropriate.
1175 - Regular expression optimization for URI matching.
1176 - Numerous other improvements for more accurate syntax
1177 highlighting.
1178 - Respect hard line breaks when filling paragraphs.
1179 - Add indentation positions: preceding list markers and pre
1180 block position.
1181 - Use button-map for navigating undefined references, so that
1182 references can be navigated via the keyboard by pressing
1183 <kbd>TAB</kbd> and <kbd>S-TAB</kbd>.
1184 - Use newer `use-region-p` when possible to check for active
1185 region, with fallbacks for older Emacsen and Xemacs.
1186 - Clean up whitespace after deleting footnote text.
1187 - Use adaptive filling for list items and blockquotes.
1188 - Treat all list items (any marker type) the same way with respect
1189 to filling.
1190 - Retain the `>` prefix when filling blockquotes.
1191 - Fill list items inside of blockquotes.
1192 - Numerous other internal improvements to make the code base
1193 more robust.
1195 * Bug fixes:
1197 - Fix bug in heading visibility cycling introduced in version
1198 1.9 where the level of headings was being calculated
1199 incorrectly.
1200 - Fix problems inserting ATX headings at end of buffer.
1201 - Support small Setext headings (with fewer than three
1202 characters).
1203 - Several improvements to inline code syntax highlighting.
1204 - Fix some edge cases regarding escaping, spaces, etc. for bold
1205 and italic font lock.
1206 - Prohibit newlines and tabs immediately after opening bold and
1207 italic delimiters. This fixes a bug where italics would not
1208 be highlighted following a horizontal rule
1209 - Improved multi-line font lock performance for large files.
1210 - Improved multi-line font lock at beginning of buffer.
1211 - List items with any of the three markers are filled in the
1212 same way (previously list items starting with `+` were not
1213 filled with hanging indentation).
1214 - Fix end detection for empty list items. Don't skip over the
1215 whitespace following the marker on the same line.
1216 Previously, empty list items were not being detected properly
1217 by `markdown-cur-list-item-bounds` as a result of this.
1218 - Don't exclude `[^]`, which is a valid reference tag (but
1219 let's please stick to alphanumeric characters).
1220 - No longer highlight escaped wiki links.
1221 - Fix line number buttons for reference checking and make all
1222 buttons clickable.
1223 - Fix killing of footnotes with no text.
1224 - Fix escaping in `markdown-xhtml-standalone-regexp`.
1225 - Fix a font-lock edge case involving footnote markers
1226 preceding inline links.
1227 - More accurate font-lock for ATX headings in edge cases.
1228 - Fix killing of footnotes from footnote text.
1230 --- ---
1232 # Markdown Mode 1.9
1234 *January 1, 2013*
1236 Version 1.9 is a major new stable release with important bug fixes.
1238 * New features:
1240 - Support for setext-style headers in `outline-mode`. Thanks
1241 to Shigeru Fukaya.
1242 - Font lock for tilde-fenced code blocks.
1243 - Reference link insertion (<kbd>C-c C-a r</kbd>).
1244 - Support two forms of aliased wiki links:
1245 `[[link text|PageName]]` and `[[PageName|link text]]`
1246 (`markdown-wiki-link-alias-first`).
1247 - Footnote support: font lock and insertion, deletion, and
1248 navigation functions for footnotes (prefixed by
1249 <kbd>C-c C-f</kbd>; following for wiki links is now
1250 <kbd>C-c C-w</kbd>). Thanks to Joost Kremers.
1251 - Improved preview and export commands. Thanks to Donald
1252 Ephraim Curtis.
1253 - `imenu` support. Thanks to Akinori Musha.
1254 - Added autoload token for `gfm-mode`. Thanks to Max Penet and
1255 Peter Eisentraut for the suggestion.
1256 - Optional character set declaration in XHTML output. Thanks
1257 to François Gannaz for the suggestion.
1258 - Smart unindentation when pressing delete at the beginning of
1259 a line. Thanks to Zhenlei Jia.
1260 - Optional prefix argument to <kbd>C-c C-w</kbd> for opening
1261 wiki links in another window.
1262 - Open inline and reference links and inline URIs in browser
1263 (<kbd>C-c C-o</kbd>). Thanks to Peter Jones.
1264 - Open files in a standalone previewer or editor
1265 (<kbd>C-c C-c o</kbd>).
1266 - Clean up numbered/ordered lists (<kbd>C-c C-c n</kbd>).
1267 Thanks to Donald Ephraim Curtis.
1268 - Save Markdown output to kill ring (copy to clipboard)
1269 (<kbd>C-c C-c w</kbd>). Thanks to Donald Ephraim Curtis.
1271 * Improvements:
1273 - Improve `markdown-mode-hook` docstring. Thanks to Shigeru
1274 Fukaya for the more precise description.
1275 - Don't require Common Lisp extensions at run time. Thanks to
1276 Shigeru Fukaya.
1277 - Prefer `visual-line-mode`, the replacement for
1278 `longlines-mode`, when in `gfm-mode`. Thanks to Christopher
1279 J. Madsen.
1280 - Proper GitHub wiki link handling in `gfm-mode`. Thanks to
1281 Kevin Porter.
1282 - XEmacs compatibility:
1283 - Avoid malformed list errors during font definitions.
1284 - Handle replace-regexp-in-string.
1285 - Use text properties instead of overlays.
1286 - Fall back to `set-buffer-modified-p` when
1287 `restore-buffer-modified-p` is unavailable.
1288 - Many additional fixes. Thanks to Michael Sperber.
1289 - Handle wiki links in buffers not associated with a file.
1290 - Update autoload documentation to support byte compilation.
1291 - Option to use `-` instead of `_` for wiki links in
1292 `gfm-mode`.
1293 - Add two tab stops to possible indentation positions following
1294 list items.
1296 * Bug fixes:
1298 - Fixed a bug which caused unusual behavior in functions
1299 performing search, replace, and/or matching operations.
1300 Thanks to Christopher J. Madsen for the patch.
1301 - Fixed a bug which caused an incompatibility with
1302 `orgtbl-mode`. Thanks to Vegard Vesterheim for the report
1303 and to Carsten Dominik for a patch.
1304 - Fixed a bug where reference links at the beginning of a line
1305 would be mistaken for reference definitions.
1306 - Improved font lock for headers.
1307 - Improved font lock for reference definitions. Thanks to Ian
1308 Yang.
1309 - Avoid byte compiler warning about `region-exists-p` in GNU
1310 Emacs.
1311 - Additional key bindings for cross-platform header cycling
1312 compatibility.
1313 - Fix problem with externally modified files on disk where the
1314 user would get stuck in a loop answering "really edit the
1315 buffer?" Thanks to Bryan Fink for a detailed report.
1316 - Font lock fix for URLs with underscores.
1317 - Escape shell commands to handle filenames with spaces, etc.
1318 Thanks to Marcin Kasperski for a patch.
1319 - Use `:slant` instead of unsupported `:italic` in font spec.
1320 - Fix typo in `paragraph-fill` regexp.
1322 # Markdown Mode 1.8.1
1324 *August 15, 2011*
1326 Version 1.8.1 is a bugfix version which addresses some minor issues in
1327 version 1.8.
1329 * New features:
1331 - Wiki link features now support aliased or piped wiki links of
1332 the form `[[PageName|link text]]`.
1334 * Bug fixes:
1336 - Fixed an issue, reported by Werner Dittmann, where the
1337 default indentation position would be skipped over when
1338 `auto-fill-mode` was on. This meant that when writing a
1339 normal paragraph, for example, the line would wrap to column
1340 4 instead of column 1.
1341 - Require the `cl` package for `multiple-value-bind`. Thanks
1342 to Werner Dittman for noticing this.
1343 - Remove a leftover debug print message which would announce
1344 "ENTER" in the minibuffer when the enter key was pressed.
1346 # Markdown Mode 1.8
1348 *August 12, 2011*
1350 * New features:
1352 - Add support for following wiki links in a buffer, either with
1353 <kbd>C-c C-f</kbd> or, optionally, <kbd>RET</kbd>, when the
1354 point is at a wiki link.
1355 - Support Markdown processors which do not accept input from
1356 stdin (i.e, Python-Markdown) by adding the
1357 `markdown-command-needs-filename` custom option. Thanks to
1358 Jeremiah Dodds for a patch.
1359 - GitHub-Flavored Markdown mode (`gfm-mode`) turns on
1360 `longlines-mode` and `auto-fill-mode`. Thanks to Edward
1361 O'Connor for the patch.
1362 - Add outline-mode-like keybindings for fast outline navigation
1363 of atx-style headers (see the updated documentation for
1364 details).
1365 - Arbitrary content may to be added to the `<head>` block during
1366 HTML output to allow for flexible local customizations. See
1367 `markdown-xhtml-header-content`.
1368 - New HTML export options: export to a file with
1369 <kbd>C-c C-c e</kbd> or export to a file and view with
1370 <kbd>C-c C-c v</kbd>.
1371 - Support Markdown processors which produce standalone output
1372 (i.e., complete HTML documents). If this is detected, by
1373 matching `markdown-xhtml-standalone-regexp` in the first five
1374 lines of output, then omit the `markdown-mode` header and
1375 footer. Thanks to Philippe Ivaldi for this and the previous
1376 HTML-output-related patches.
1377 - Customizable wiki link following behavior using
1378 `markdown-follow-wiki-link-on-enter`.
1379 - Quick navigation to the previous and next wiki links using
1380 <kbd>M-p</kbd> and <kbd>M-n</kbd>.
1381 - Wiki links to non-existent files (missing links) are
1382 highlighted differently. Based on functionality from
1383 `wiki-mode` by Alex Schroeder. Thanks to Eric Merritt for
1384 patches.
1386 * Improvements:
1388 - Improve syntax highlighting of preformatted text blocks to
1389 better distinguish them from list items with hanging
1390 indentation and nested list items.
1391 - Match italic and bold text and inline code fragments across
1392 line breaks, within a single block, but prevent them from
1393 matching across blocks.
1394 - Generally improve multi-line font lock by extending the search
1395 region to include full blocks.
1396 - Make indentation work when the previous line is not indented.
1397 - Set tab width to 4, the natural tab width for Markdown
1398 documents.
1399 - Stop announcing "TAB" in the minibuffer when tab is pressed.
1400 - Use `html-mode` for viewing Markdown output.
1401 - Ensure Markdown output buffer is always raised, even when the
1402 output is short.
1403 - Make sure horizontal rules inserted by <kbd>C-c -</kbd>
1404 (`markdown-insert-hr`) are surrounded by blank lines.
1405 - Added an `autoload` cookie. Thanks to Peter S. Galbraith for
1406 the patch.
1407 - Support a customizable horizontal rule string
1408 `markdown-hr-string`. This replaces the previous but less
1409 flexible custom option `markdown-hr-length`, which has been
1410 removed.
1411 - Followed wiki links are opened using `markdown-mode`.
1413 * Bug fixes:
1415 - Fixed an issue, reported by Joost Kremners, where for
1416 multi-line lists, the position of the list marker was not
1417 being added to the list of possible indentation levels.
1418 - Avoid a problem where indentation positions were getting
1419 skipped over when tab cycling.
1420 - Fixed an issue when column 0 is the natural automatic
1421 indentation stop.
1422 - Prevent infinite loops in blockquote (<kbd>C-c C-s b</kbd>)
1423 and preformatted (<kbd>C-c C-s p</kbd>) block insertion while
1424 at the beginning or end of the buffer.
1426 # Markdown Mode 1.7
1428 *October 1, 2009*
1430 * New features:
1432 - Support filling of list items.
1433 - Allow customization of font-lock faces (thanks to intrigeri
1434 for the patch).
1435 - Automatic indentation when pressing enter or tab (with
1436 cycling upon subsequent tab presses) (thanks to Bryan Kyle).
1437 - Generate real XHTML for previewing (thanks to Hilko Bengen
1438 for the patch). This fixes [Debian bug #490865](http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=490865). The CSS
1439 stylesheet for XHTML output is customizable via
1440 `markdown-css-path` (thanks to Ankit Solanki for the patch).
1441 - Better URL matching (protocols are customizable through
1442 `markdown-uri-types`).
1443 - LaTeX syntax highlighting can be enabled or disabled using
1444 the customize system (`markdown-enable-math`).
1445 - Support for HTML comments (font lock, `comment-dwim`, etc.).
1446 - Support filling of definition lists (thanks to Peter Williams
1447 for the patch).
1449 * Improvements:
1451 - Add support level 5 and 6 atx-style headers (thanks to Alec
1452 Resnick for the report).
1453 - Fill-paragraph no longer breaks lines inside of square
1454 brackets (thanks to Peter Williams for the patch).
1456 * Bug fixes:
1458 - Fixed several font lock issues.
1459 - Fixed a bug where pressing enter did nothing in
1460 longlines-mode (thanks to Ankit Solanki for the patch).
1461 - Fixed a problem where Emacs snapshot would hang during
1462 `markdown-enter` and `markdown-cycle` (thanks to Alec Resnick
1463 for the report).
1464 - Fixed an issue with auto-fill-mode and markdown-mode's
1465 indentation (thanks to Joost Kremers for the report and
1466 analysis).
1468 # Markdown Mode 1.6
1470 *June 4, 2008*
1472 * **Breaking changes:**
1474 - Rename `blockquote-region` to `markdown-blockquote-region` in
1475 accordance with the Emacs major mode coding conventions.
1476 - Several new keybindings.
1477 - Reverted to using colors instead of bold, italic, and
1478 fixed-width faces.
1480 * New features:
1482 - Implemented org-mode style visibility cycling.
1483 - Support outline minor mode.
1484 - Undefined reference checking (via `C-c C-c c`, using code by
1485 Dmitry Dzhus).
1486 - Wiki links: syntax highlighting and element insertion
1487 (`C-c C-a w`).
1488 - Allow syntax highlighting faces to be customized.
1489 - Insertion of preformatted text sections (`C-c C-s p`).
1490 - Font locking for inline URIs and email addresses.
1491 - Markdown mode menu (thanks to Greg Bognar for the initial
1492 code).
1494 * Improvements:
1496 - Markdown customize group moved to `wp` (word processing).
1497 - Derive from `text-mode` instead of `fundamental-mode`.
1498 - Properly prefix regex definitions and `wrap-or-insert`
1499 function.
1501 * Bug fixes:
1503 - Highlight wrapped inline link definitions (thanks to Blake
1504 Winton).
1505 - Fix adjacent wiki link font lock bug.
1506 - Support escaping of backticks.
1507 - Many other small font lock tweaks.
1508 - Don't check for `transient-mark-mode` in
1509 `markdown-blockquote-region`. This fixes Debian bug #456592
1510 (thanks to Daniel Burrows for the report).
1511 - Apply Greg Bognar's fix for `markdown` with an active region.
1512 - Don't use the kill ring to store wrapped text.
1514 # Markdown Mode 1.5
1516 *October 11, 2007*
1518 Version 1.5 is a major revision compared to previous releases. The
1519 functionality has not changed very much, all of the keybindings are
1520 the same, but it is internally quite different.
1522 Most of the changes involve syntax highlighting. The regular
1523 expressions have been significantly improved and the corresponding
1524 font lock faces have been tweaked (hopefully for the better, but feel
1525 free to customize them). Various other small bugs have been fixed and
1526 the documentation and website have been updated.
1528 The two changes in functionality, both of which are optional, are
1529 syntax highlighting for embedded mathematics via LaTeX-like
1530 expressions, and highlighting for bracketed wiki links.
1532 [itex]: http://golem.ph.utexas.edu/~distler/blog/itex2MMLcommands.html
1534 # Markdown Mode 1.4
1536 *June 29, 2007*
1538 Version 1.4 includes a small fix to the regular expression syntax to
1539 fix the Emacs 21 "Invalid escape character syntax." error. Thanks to
1540 Edward O'Connor for the fix.
1542 # Markdown Mode 1.3
1544 *June 5, 2007*
1546 Version 1.3 provides syntax highlighting, insertion commands for all
1547 basic HTML elements, and preview commands for viewing the resulting
1548 HTML in a new buffer of an external browser.
1550 # Markdown Mode 1.2
1552 *May 25, 2007*
1554 Version 1.2 adds element insertion commands and keys for links,
1555 horizontal rules, headers, inline code, and bold and italic text.
1557 Added element insertion commands and keys for links, horizontal rules, headers, inline code, and bold and italic text.
1559 # Markdown Mode 1.1
1561 *May 24, 2007*
1563 Version 1.1 is the initial release of Markdown Mode for Emacs, a major
1564 mode to edit Markdown files in Emacs. This version provides basic
1565 syntax highlighting and element insertion commands for Markdown files.