Emacs Markdown Mode 使用教程

Emacs Markdown Mode 使用教程

markdown-mode 项目地址: https://gitcode.com/gh_mirrors/ma/markdown-mode

1. 项目介绍

markdown-mode 是一个用于编辑 Markdown 格式文本的 Emacs 主模式。它提供了丰富的功能，包括语法高亮、代码块编辑、预览和导出等。最新稳定版本为 markdown-mode 2.6，发布于 2023 年 8 月 30 日。该项目遵循 GNU GPL 3.0 或更高版本的许可证。

2. 项目快速启动

安装 Emacs 和 Markdown 处理器

在开始使用 markdown-mode 之前，请确保你已经安装了 Emacs 和至少一个 Markdown 处理器（如 Markdown.pl、MultiMarkdown 或 Pandoc）。

安装 markdown-mode

推荐通过 MELPA Stable 安装 markdown-mode。首先，配置 package.el 和 MELPA Stable 仓库：

(require 'package)
(add-to-list 'package-archives '("melpa-stable" . "https://stable.melpa.org/packages/"))
(package-initialize)

然后，重启 Emacs 或评估上述语句后，执行以下命令：

M-x package-install RET markdown-mode RET

配置 markdown-command

安装完成后，确保配置 markdown-command 指向你系统上的 Markdown 可执行文件：

(setq markdown-command "multimarkdown")

使用 markdown-mode

markdown-mode 会自动用于以 .md、.markdown 等扩展名结尾的文件。你可以通过以下命令手动启用 markdown-mode：

M-x markdown-mode

3. 应用案例和最佳实践

编辑 Markdown 文件

使用 markdown-mode 编辑 Markdown 文件时，你可以利用以下快捷键：

• C-c C-s：样式文本（如加粗、斜体）
• C-c C-l：插入或编辑链接
• C-c C-i：插入或编辑图片
• C-c C-c：运行 Markdown 命令（如预览、导出）

预览和导出

你可以使用以下命令预览和导出 Markdown 文件：

• C-c C-c p：预览 HTML 文件
• C-c C-c e：导出为 HTML 文件

代码块编辑

markdown-mode 支持在间接缓冲区中编辑代码块。你可以使用 C-c ' 打开代码块进行编辑。

4. 典型生态项目

edit-indirect

edit-indirect 是一个用于在间接缓冲区中编辑文本的 Emacs 包。它与 markdown-mode 结合使用，可以方便地编辑 Markdown 文件中的代码块。

org-mode

org-mode 是 Emacs 中另一个强大的文本编辑模式，支持多种格式和功能。虽然它不是 markdown-mode 的直接生态项目，但两者可以结合使用，提供更丰富的编辑体验。

Pandoc

Pandoc 是一个通用的文档转换工具，支持多种格式之间的转换。你可以使用 Pandoc 将 Markdown 文件转换为其他格式（如 PDF、Word 等），进一步扩展 markdown-mode 的功能。

通过以上步骤，你可以快速上手并充分利用 markdown-mode 进行 Markdown 文件的编辑和处理。

markdown-mode 项目地址: https://gitcode.com/gh_mirrors/ma/markdown-mode