markdown语言使用教程：简单而优雅的开源

小君 2023-02-09 23:42:15 982

markdown语言使用教程：简单而优雅的开源您可以使用菜单File -> Open File或按CmdOrCtrl O打开文件对话框以选择降价文件。另一种方法是通过命令行启动带有目录或文件的 MarkText。打开和修改markdown文件侧边栏由三个面板组成，您可以通过按CmdOrCtrl 来切换侧边栏J：切换标签MarkText 可以用作单个编辑器，但在单独的选项卡中打开所有文件。选项卡可以通过CmdOrCtrl Alt切换B并通过拖放重新排序。

《开源精选》是我们分享Github、Gitee等开源社区中优质项目的栏目，包括技术、学习、实用与各种有趣的内容。本期推荐的 MarkText是一个简单而优雅的开源 Markdown 编辑器。

markdown语言使用教程：简单而优雅的开源(1)

MarkText 是 markdown 的实时预览 (WYSIWYG) 编辑器，带有各种功能 Markdown 扩展，我们的理念是保持干净、简单和最小化。该应用程序是在 Electron 之上使用 HTML、JS 和 CSS 构建的。目前我们正在使用一些本地节点库，并且我们的 UI 是使用 Vue/Vuex 构建的。MarkText 可以分为三个部分：分别为 Muya 的核心、主进程和渲染器进程。

Muya基于块结构通过多个模块提供实时预览和markdown编辑。您可以将其想象为编辑器后端，带有用于 Markdown 解析的模块、作为块结构的数据存储、根据 CommonMark 和 GitHub Flavored Markdown 规范进行的 Markdown 文档转换以及一些额外的规范、事件侦听器和导出器，以生成独立的 HTML 和 Markdown 文件，还可以生成所见即所得的编辑器。Muya 和 MarkText 一样是单线程的，是使用异步函数来提高性能。

功能特性

实时预览 (WYSIWYG) 和简洁明了的界面，让您获得无干扰的写作体验。
支持CommonMark Spec、GitHub Flavored Markdown Spec和选择性支持Pandoc markdown。
Markdown 扩展，例如数学表达式 (KaTeX)、前端和表情符号。
支持段落和内联样式快捷方式，以提高您的写作效率。
输出HTML和PDF文件。
各种主题：Cadmium Light，Material Dark等。
多种编辑模式：源代码模式、打字机模式、焦点模式。
直接从剪贴板上粘贴图像。

基本入门

界面

侧边栏由三个面板组成，您可以通过按CmdOrCtrl 来切换侧边栏J：

打开的根目录的文件系统资源管理器（树视图）
在文件中查找
所选选项卡的目录

切换标签

MarkText 可以用作单个编辑器，但在单独的选项卡中打开所有文件。选项卡可以通过CmdOrCtrl Alt切换B并通过拖放重新排序。

markdown语言使用教程：简单而优雅的开源(2)

打开和修改markdown文件

您可以使用菜单File -> Open File或按CmdOrCtrl O打开文件对话框以选择降价文件。另一种方法是通过命令行启动带有目录或文件的 MarkText。

保存您编辑的文件

经过一些修改后，您可以通过CmdOrCtrl 保存文件S或使用另存为来使用不同的文件名。

打开一个目录

MarkText还支持通过CmdOrCtrl 或侧边栏按钮Open Folder打开目录。打开目录后，所有文件和目录都显示在侧边栏树的视图中。树视图允许您打开更多文件，浏览和修改打开的根目录中的文件或目录。树视图上方是所有打开的文件所在的位置。您还可以使用快速打开 ( ) 从打开的根目录或编辑器中快速打开文件，并通过箭头键导航或通过鼠标选择文件。要查看另一个侧边栏面板，例如在文件中查找，请单击左侧边栏图标。

markdown语言使用教程：简单而优雅的开源(3)

主题

您可以在设置窗口中控制和修改所有首选项或preferences.json在应用程序数据目录中进行编辑。

一般应用程序设置
控制编辑器外观的设置
Markdown 相关设置
应用主题
如何处理图像的选项

markdown语言使用教程：简单而优雅的开源(4)

下载和安装

苹果系统

您可以marktext-%version%.dmg从发布页面下载最新版本，也可以使用homebrew cask 安装 MarkText 。要使用 Homebrew-Cask，您只需要安装Homebrew。

brew install --cask 标记文本

视窗

视窗只需通过安装向导 ( ) 下载并安装 MarkText，marktext-setup-%version%.exe然后选择是按用户安装还是在机器范围内安装。或者，使用包管理器（例如Chocolatey或Winget ）安装 MarkText 。

要使用 Chocolatey，您需要安装Chocolatey：

choco install marktext

其他

Linux、macOS 和 Windows 所有二进制文件都可以从发布页面下载。

示例

打开一个markdown文档并渲染它

MarkdownDocument是表示磁盘上的降价文件或无标题文档的文档。要获取降价文档，您可以使用在主进程loadMarkdownFile中异步返回 a RawMarkdownDocument（=带有一些附加信息）的函数。MarkdownDocument

打开文件的总体步骤：

单击File -> Open File并显示一个文件对话框，该对话框会发出app-open-file-by-id带有编辑器窗口 ID 的文件，以在其中打开文件并解析绝对文件路径。
应用程序（App实例）试图找到指定openTab的编辑器并调用编辑器窗口。如果不存在编辑器窗口，则会创建一个新的编辑器窗口。
编辑器窗口尝试加载 markdown 文件，loadMarkdownFile并通过事件将结果发送mt::open-new-tab到渲染器进程。
每个打开的文件也会添加到文件系统观察程序中，并保存完整路径以跟踪当前编辑器窗口中打开的文件。
该事件在src/renderer/store/editor.js（渲染器进程）中触发，进行一些检查并创建一个表示降价文档和选项卡状态的新文档状态。
新创建的选项卡要么打开并file-changed发出事件，要么只是添加到选项卡状态。
Muya 和源代码编辑器都侦听此事件并相应地更改降价文档。

主题样式

markdown语言使用教程：简单而优雅的开源(5)