当前位置：首页 > news >正文

markdown 文档编辑软件 MarkText 使用教程

news 2025/5/18 6:37:42

2025.5.17 更新

现在可以通过 MarkText 官网来下载 MarkText 了：https://www.marktext.cc/，支持 windows, macOS, linux 等版本。

MarkText 使用说明

MarkText是一款比Typora更简洁优雅的markdown编辑器，完全开源免费。

什么是 Markdown ?

Markdown是一种轻量级标记语言，创始人为约翰·格鲁伯。它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

一般来说，使用 Markdown 来编辑说明文档、博客等内容格式更加简洁，配合几个常用快捷键使用效率更高。推荐在许多场景下优先使用 Markdown 进行文档编辑。

Markdown 常用快捷键

1.标题

用 #标记

在 标题开头 加上1~6个#，依次代表一级标题、二级标题…六级标题

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果如下：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

用=和-标记（此功能在 MarkText 软件中不支持，影响很小）

在 标题底下 加上任意个=代表一级标题，-代表二级标题

一级标题
======二级标题
----------

效果如下：
在这里插入图片描述

2. 列表

Markdown 支持有序列表和无序列表。

无序列表使用-、+和*作为列表标记 （随意使用，但是要保证父子级列表之间的一致性）

- Red
- Green
- Blue* Red
* Green
* Blue+ Red
+ Green
+ Blue

效果如下：

Red
Green
Blue

Red
Green
Blue

Red
Green
Blue
有序列表则使用数字加英文句点.来表示

1. Red
2. Green
3. Blue

效果如下：

Red
Green
Blue

3. 引用

引用以>来表示，引用中支持多级引用、标题、列表、代码块、分割线等常规语法。

> 这是一段引用    //在`>`后面有 1 个空格
> 
>     这是引用的代码块形式    //在`>`后面有 5 个空格
>     
> 代码例子：
>   protected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);}> 一级引用
> > 二级引用
> > > 三级引用> #### 这是一个四级标题
> 
> 1. 这是第一行列表项
> 2. 这是第二行列表项

效果如下：

这是一段引用 // 在> 后面有 1 个空格

这是一个四级标题

一级引用

二级引用

三级引用

四级引用 ……

4. 强调

两个*或-代表加粗，一个*或-代表斜体，~~代表删除

**加粗文本** 或者 __加粗文本__*斜体文本*  或者_斜体文本_~~删除文本~~

效果如下：

加粗文本 加粗文本

斜体文本 斜体文本

~~删除文本~~

5. 图片与链接

图片与链接的语法很像，区别在一个 ! 号。

图片：![]()    ![图片文本(可忽略)](图片地址)链接：[]()     [链接文本](链接地址)

链接又分为行内式、参考式和 自动链接

这是行内式链接：[ConnorLin's Blog](http://connorlin.github.io)。这是参考式链接：[ConnorLin's Blog][url]，其中url为链接标记，可置于文中任意位置。[url]: http://connorlin.github.io/ "ConnorLin's Blog"链接标记格式为：[链接标记文本]:  链接地址  链接title(可忽略)这是自动链接：直接使用`<>`括起来<http://connorlin.github.io>这是图片：![][avatar][avatar]: https://connorlin.github.io/images/avatar.jpg

效果如下：
在这里插入图片描述

6. 代码

代码分为行内代码和代码块
- 行内代码使用 代码 标识，可嵌入文字中
- 代码块使用4个空格或 `````标识
```
这里是代码。。。
```
代码语法高亮在 `````后面加上空格和语言名称即可

//注意语言前面有空格  
这里是代码

例如:

这是行内代码`onCreate(Bundle savedInstanceState)`的例子。这是代码块和语法高亮：```java
// 注意 java 前面有空格
protected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);
}

#### 7. 表格表格对齐格式- 居左：`:----`
- 居中：`:----:`或`-----`
- 居右：`----:`例子：```markdown
|标题|标题|标题|
|:---|:---:|---:|
|居左测试文本|居中测试文本|居右测试文本|
|居左测试文本1|居中测试文本2|居右测试文本3|
|居左测试文本11|居中测试文本22|居右测试文本33|
|居左测试文本111|居中测试文本222|居右测试文本333|

效果如下：

在这里插入图片描述

8. 分隔线

在一行中用三个以上的*、-、_来建立一个分隔线，行内不能有其他东西。也可以在符号间插入空格。

***
---
___* * *

效果如下：

在这里插入图片描述

9. 换行

在行尾添加两个空格加回车表示换行

这是一行后面加两个空格  换行

效果如下：

在这里插入图片描述

10. 注解

使用[^]来定义脚注

这是一个脚注的例子[^1][^1]: 这里是脚注

效果如下：

在这里插入图片描述

11. 常用弥补 Markdown 的 html 标签

字体

<font face="微软雅黑" color="red" size="6">字体及字体颜色和大小</font>
<font color="#0000ff">字体颜色</font>

效果如下：

在这里插入图片描述

12. 换行

使用html标签`<br/>`<br/>换行

效果如下：

在这里插入图片描述

13. 文本对齐方式

<p align="left">居左文本</p>
<p align="center">居中文本</p>
<p align="right">居右文本</p>

效果如下：

在这里插入图片描述

14. 下划线

<u>下划线文本</u>

效果如下：

在这里插入图片描述

Markdown vs Word

Word 等其他文本编辑工具虽然也能实现同样的效果，但是其功能太强大了。Word 还能改变字体颜色，还可以调节字体大小。这么强大的功能可以说是 Word 的优点，但也可以说是它的缺点。

当功能多了，我们的注意力就会分散，我们就会去纠结：这个字体大小到底是 14 还是 16 好？我想强调这一句话，是要加粗还是标红？

而 Markdown 的出现让我们不需要去纠结这些问题。Markdown 的本质是让我们回归到内容本身，注重文章本身的结构，而不是样式。

例如我们想要强调一句话，那么我们直接使用两个星号为其加粗，而不需要考虑是加粗还是标红（Markdown中只有黑色字体，没有其他颜色字体）。

你也不需要关心字体大小问题，因为 Markdown 中字体大小都与结构有关，无法手动设置。一级标题字体大一些，二级标题小一些。我们只需要关注哪些是一级标题，哪些是二级标题。而不需要去纠结标题字体到底要设置多大。

Markdown 的本质是让我们回归内容本身。 当你明白这个道理的时候，你会明白为什么许多功能 Markdown 没有。

如何使用 MarkText

下载安装（默认英文版）

进入 github MarkText 仓库 readme 下 GitHub - marktext/marktext: 📝A simple and elegant markdown editor, available for Linux, macOS and Windows.

根据教程下载安装即可

下载 MarkText 中文版使用

点击链接 Releases · chinayangxiaowei/marktext-chinese-language-pack · GitHub

如下图：

在这里插入图片描述

根据操作系统的不同，可直接下载对应的 MarkText 中文版本使用

使用

点击打开 MarkText.exe，即可开始编写
支持通过@快捷键的方式快速选择需要编写的格式，同时也方便在忘记相关语法的时候使用

在这里插入图片描述

多 tab 编辑，鼠标移至文件栏右边空白处出现 + 图标，点击即可新建一个 tab 文件页

在这里插入图片描述

文件保存：通过快捷键Ctrl + S即可选择保存的文件位置及文件名

在这里插入图片描述

图片展示：复制粘贴对应的图片到编辑区即可，其他文本同理
已展示图片编辑：点击图片展示区域即可对其进行编辑

在这里插入图片描述

快速修改编辑格式：可以通过单击下图中突出显示的图标并选择将线条转换为另一种类型Turn Into。此外，您可以复制所选行、在所选行上方创建一个段落或删除该行

在这里插入图片描述

设置：可以在File-Preferences...打开MarkText设置页面进行设置，或者使用快捷键Ctrl+,操作
表情符号选择器：在两个::之间输入表情英文，MarkText支持快捷选择小表情

在这里插入图片描述

导出文档：MarkText 允许您将文档导出为 PDF 和 HTML 文件或打印文档。您可以通过如下的方法进行导出：

在这里插入图片描述

打印

在这里插入图片描述

您可以在导出文档之前设置页面大小、方向和边距

如果您选择 PDF 或打印，您可以在导出的文档中包含页眉或页脚，并且还可以调整页眉/页脚样式。您可以在导出选项中选择否、单个或三个单元格标题。页眉或页脚在定义时出现在每页上，页眉可以是多行但页脚只能是单行。不幸的是，目前不支持页码编号。以下是一个导出的例子：

在这里插入图片描述

关于 MarkText 复制粘贴的图片保存的路径

Markdown 文档可以保存图片，一般保存的图片有两种：线上图片和本地图片。前者只需要使用 Markdown 语法引入对应的图片地址即可。后者一般引入的是相对当前文档保存位置的相对地址
在涉及到本地图片保存时，若不借助类似 MarkText 之类的编辑软件，我们需要手动将需要展示的图片保存在本地的某个文件夹内，一般是新建一个文件夹，在该文件夹根目录保存 Markdown 文件，并在此根目录新建一个文件夹用于保存图片等静态资源，Markdown 文件中引用该文件的相对路径地址即可
而在使用了 MarkText 之后，在默认不配置的情况下，复制粘贴的图片会被 MarkText 保存在一个特定的文件夹（C:\Users\yourComputerName\AppData\Roaming\marktext\images\xxxx.png）内，然而这样并不符合我们的一般编辑习惯，所以这里要对相关配置进行设置
- 点击左上角菜单
- 点击File -> Preferences…
- 点击Image
- 现在，当我们在 MarkText 中新建一个 Markdown 文件后，先保存该文件，再复制粘贴图片时，发现图片被保存在了 Markdown 文件所在目录下的 ./assets文件夹中