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

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

news 来源：原创 2025/5/18 6:06:09

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

效果如下：

  1. Red

  2. Green

  3. 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文件夹中

    在这里插入图片描述

在这里插入图片描述

其他
  • MarkText 中还有许多在 Markdown 文档编辑过程中非常实用的功能，可慢慢探索。
总结
  • MarkText 是一款简洁好用的开源免费 markdown 文档编辑器，当我们需要编写一些 markdown 格式的技术说明文档的时候，非常好用。但是不同的 markdown 软件之间可能对相同的 markdown 标记语法的解析会略有不同，这点还是值得注意的。

参考

https://zh.m.wikipedia.org/zh-hans/Markdown

https://www.jianshu.com/p/82e730892d42

https://blog.csdn.net/windowsxp2018/article/details/121892165

https://zhuanlan.zhihu.com/p/86516807

https://blog.csdn.net/Gherbirthday0916/article/details/125380693

相关文章：

  • 板凳-------Mysql cookbook学习 （二）
  • spring cache使用指南
  • 西门子 Teamcenter13 Eclipse RCP 开发 1.3 工具栏 单选按钮
  • NDS3211HV单路H.264/HEVC/HD视频编码器
  • Dockerfile学习指南
  • 端到端自动驾驶系统实战指南：从Comma.ai架构到PyTorch部署
  • AI517 AI本地部署 docker微调（失败）
  • 车载以太网驱动智能化：域控架构设计与开发实践
  • ECS/GEM是半导体制造业的标准通信协议中host和equipment的区别是什么，在交互过程中，如何来定位角色谁为host，谁为equipment
  • C# 中的锁
  • 数字万用表与指针万用表使用方法及注意事项
  • 上集：一个前端的血泪复仇记 —— 静态部署的胜利
  • 调用DeepSeek系列模型问答时，输出只有＜/think＞标签，而没有＜think＞标签
  • CANoe CAPL TCP DoIP通信问题
  • 【springboot+vue3的前后端分离项目实现支付宝的沙箱支付】
  • 使用instance着色
  • 边缘计算：物联网的“加速器”与“守护者”
  • Postman遇到脚本不支持replaceIn函数
  • 3D个人简历网站 4.小岛
  • BootCDN介绍（Bootstrap主导的前端开源项目免费CDN加速服务）
  • 原核试验基地司令员范如玉逝世，从事核试验研究超40年
  • 盐城经济技术开发区党工委书记王旭东接受纪律审查和监察调查
  • 蒲慕明院士：未来数十年不是AI取代人，而是会用AI的人取代不会用的
  • 浙江省委金融办原副主任潘广恩被“双开”
  • 新片｜《碟中谍8：最终清算》定档5月30日
  • 清雪车司机未拉手刹下车导致溜车被撞亡，事故调查报告发布