manual for emacs markdown-mode(English)
阅读原文时间:2023年07月10日阅读:2
  • * markdown-mode now requires Emacs 24.3 or later.

    • Markup insertion and replacement keybindings under C-c C-s (s for style) have been revised to make them easier to remember. Now, when the prefix C-c C-s is pressed, a short minibuffer help prompt is presented as a reminder of a few of the most frequently used keys. The major changes are that bold is now inserted with b (previously s) and italic is now i (previously e). As a result, blockquote is now q (previously b) and strikethrough markup is inserted with s (previously d). Press C-c C-s C-h for a complete list of markup insertion keybindings. Heading insertion commands are also now under C-c C-s.
    • Link insertion and editing has been consolidated into one command, markdown-insert-link, bound to C-c C-l. As such, the previous separate link insertion keybindings have been removed: C-c C-a l, C-c C-a L, C-c C-a r, and C-c C-a u.
    • Image insertion and editing has been consolidated into one command, markdown-insert-image, bound to C-c C-i. As such, the previous separate image insertion keybindings have been removed: C-c C-i i and C-c C-i I.
    • Footnote and wiki link insertion have been moved to the markup insertion prefix, as C-c C-s f and C-c C-s w.
    • The list and outline editing commands have been removed from the top-level positions (previously M-LEFT, M-RIGHT, M-UP, M-DOWN) and moved to major mode keybindings under C-c to C-c LEFT, C-c RIGHT, C-c UP, and C-c DOWN, respectively. (GH–164)
    • The list and outline editing commands have also been unified so that they all operate on entire subtrees of list items and subtrees of atx headings, symmetrically. Previously there were separate commands for editing heading subtrees, but promoting a single section is easy enough by directly inserting or removing a hash mark or using the markup replacement commands.
    • Jumping between references and reference definitions via markdown-jump, previously bound to C-c C-l, has been moved to C-c C-d and rebranded as markdown-do, which attempts to do something sensible with the object at the point.
    • Rename internal markdown-link-link to markdown-link-url for clarity.
    • The old inline image toggling command C-c C-i C-t has been removed and replaced C-c C-x C-i in order to allow for the new interactive image insertion command at C-c C-i. 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.
    • In markdown-regex-header, groups 4 and 6 now include whitespace surrounding hash marks in atx headings.
    • Font lock for ~~strikethrough~~ is now supported in markdown-mode in addition to gfm-mode.
    • Introduced a new face for horizontal rules: markdown-hr-face. Previously, markdown-header-delimiter-face was used.
    • Markdown Mode is now distributed under the GNU GPL version 3 or later.
    • Rename markdown-fill-forward-paragraph-function to markdown-fill-forward-paragraph.
    • Rename markdown-footnote-face to markdown-footnote-marker-face.
    • Functions markdown-insert-inline-link-dwim and markdown-insert-reference-link-dwim have been combined and replaced with markdown-insert-link.
    • Functions markdown-exdent-region and markdown-exdent-or-delete are now named markdown-outdent-region and markdown-outdent-or-delete, respectively.
    • The non-interactive image insertion commands have been refactored to mirror the corresponding link insertion commands. markdown-insert-image (for inline images) has been renamed markdown-insert-inline-image and it now takes three arguments (previously one optional argument). markdown-insert-reference-image now takes four arguments (previously none).
  • 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 supersedes URL hiding (below). (GH–130)
    • Unicode bullets are used to replace ASCII list item markers for unordered lists when markup hiding is enabled. The list of characters used, in order of list level, can be specified by setting the variable markdown-list-item-bullets. (GH–130)
    • When markup hiding is enabled, the characters used for replacing certain markup can be changed by customizing the corresponding variables: markdown-blockquote-display-char, markdown-hr-display-char, and markdown-definition-display-char.
    • URL and reference label hiding: URLs for inline links and labels for reference links can now be hidden if desired. 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, set markdown-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 variable markdown-code-lang-modes. (GH–123, GH–185)
    • When the edit-indirect package is installed, C-c ’ (markdown-edit-code-block) can be used to edit a code block in an indirect buffer in the native major mode. Press C-c C-c to commit changes and return or C-c C-k to cancel.
    • 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), and markdown-narrow-to-page (C-x n p). (GH–191)
    • Add subtree marking and narrowing functions: markdown-mark-subtree (C-c C-M-h) and markdown-narrow-to-subtree (C-x n s). (GH–191)
    • Add syntax-aware Markdown paragraph movement commands: M-{ (markdown-backward-paragraph) and M-} (markdown-forward-paragraph). To mark a paragraph, use M-h (markdown-mark-paragraph). These move at a more granular level than the block movement commands. (GH–191)
    • The previous block movement and marking commands are now at C-M-{, C-M-}, and C-c M-h. In terms of lists, paragraph movement commands now stop at each list item while block commands move over entire lists. (GH–191)
    • Add subtree as a possible value for markdown-reference-location and markdown-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.
    • Add a keybinding for toggling LaTeX math (_e_quation) support: C-c C-x C-e.
    • Support Leanpub blocks (asides, info blocks, warnings, etc.). These are simple extensions of the usual blockquote syntax.
    • Font lock, with markup hiding, for subscripts (e.g., H~2~0) and superscripts (e.g., 334^10^). Thanks to Syohei Yoshida for a patch on which this is based. (GH–134)
    • Add basic font-lock support for inline attribute lists or inline identifiers used by Pandoc, Python Markdown, PHP Markdown Extra, Leanpub, etc.
    • Add basic font-lock support for Leanpub section identifiers and page breaks.
    • Add basic font-lock support for common file inclusion syntax: <<(file), <<[title](file), <<[file], and <<{file}.
    • Add font lock support for Pandoc inline footnotes. (GH–81)
    • Raise footnote markers and inline footnote text, and optionally hide markup.
    • Filling with now respects Pandoc line blocks. (GH–144)
    • Add interactive link editing and insertion command markdown-insert-link. (GH–199)
    • Added C-c C-d, markdown-do, which is a replacement for C-c C-l, markdown-jump. In addition to jumping between reference/footnote labels and definitions, it also toggles GFM checkboxes.
    • Outline movement keys C-c C-p, C-c C-n, C-c C-f, C-c C-b, and C-c C-u now move between list items, when the point is in a list, and move between headings otherwise.
    • New customization option markdown-spaces-after-code-fence to control the number of spaces inserted after a code fence (```). Thanks to Philipp Stephani for a patch.
    • New customization option markdown-gfm-uppercase-checkbox which, when non-nil, uses [X] to complete task list items instead of [x]. Thanks to Paul Rankin for a patch. (GH–236)
    • Add prefix-specific prompts for styles (C-c C-s) and toggles (C-c C-x). These may be disabled if desired by setting markdown-enable-prefix-prompts to nil.
  • 转载于https://jblevins.org/projects/markdown-mode/rev-2-3

  • 说实话,看得我头疼