掌握Markdown技巧,轻松应对写作需求
Markdown 是一种轻量级标记语言,它以简洁易读的文本格式来编写文档。
特点:
- 简单易学:语法简洁明了,容易上手。
- 可读性高:纯文本形式,便于阅读和理解。
- 跨平台:在各种操作系统和设备上都能使用。
- 广泛应用:常用于文档编写、博客文章、技术文档等。
注意:
本文 Markdown 语法使用 VSCode 编辑并使用其插件 Markdown Preview Enhanced 预览。
1 基本语法
最简单的语法,通常在大部分编辑器中都可以使用。
1.1 标题
使用一定数量的#
标记标题,#
的数量代表标题的级别。
1 | # 一级标题 |
使用三个以上的=
和-
在后一行可以标记一级标题和二级标题。
1 | 一级标题 |
1.2 段落
段落无特殊格式,直接编写文字就可以;换行需要在段落后面加一个空行表示重新开始一个新段落。
1.3 强调
使用一定数量的*
或_
标记加粗、倾斜等效果表示强调,它需要在目标文本的前后添加相同相等的符号来标记开始和结束。推荐使用*
。
1 | **加粗** |
1.4 分割线
使用三个以上的*
、-
或_
标记分割线,需要在单独一行使用。推荐使用-
。
1 | *** |
1.5 引用
使用>
标记区块引用,使用两个以上的>
标记嵌套的区块引用,其它大部分语法都可以嵌套在引用其中。
1 | > 区块引用 |
1.6 列表
列表分为无序和有序两种。使用*
、+
或-
标记无序列表,使用数字.
标记有序列表。列表可以嵌套,有序列表可以自定义序号。
1 | * 无序列表 |
1.7 链接
使用[]()
标记一个超链接,链接文本放在[]
中,链接地址放在()
中,还可以使用尖括号<>
将URL或Email地址变成可点击链接。
1 | [爱吃猫的鱼BLOG](https://talen.top) |
1.8 图片
使用![]()
标记一张图片,图片描述放在[]
中,图片地址放在()
中,本地图片使用相对地址引用,网络图片使用网络链接引用。
1 | ![本地图片](/2024-05-19_hd.jpg) |
1.9 代码
使用``
标记行内代码,内容放在``
中。
1 | `Markdown`语法 |
1.10 转义
使用\
将格式化字符转义为原义,可转移字符有\ * _ {} [] () # + - . ! |
等。
1 | \*不要倾斜\* |
2 拓展语法
拓展语法可能在某些编辑器中无法使用。
2.1 表格
使用|
分割每列、三个以上的-
创建每列标题来标记表格,在---
左右使用:
表示对其方式。
1 | | 默认 | 左对齐 | 居中 | 右对齐 | |
2.2 代码块
使用两个```
在代码上下标记代码块,第一个```
后指定语言可将代码高亮显示。
1 | ```json |
2.3 脚注
使用[^]
和[^]:
组合标记脚注,脚注标题在^
后,脚注内容在:
后。
1 | 第一个脚注[^1]和第二个脚注[^2] |
2.4 任务列表
使用- [ ]
标记任务列表,[]
中添加×
表示复选框。
1 | - [x] 完成 |
2.5 删除线
使用~~
标记删除线,在目标内容前后添加~~
。
1 | ~~删除线~~ |
2.6 内容目录
使用[TOC]
标记一个目录,它根据标题自动生成。
1 | [TOC] |
2.7 公式
若支持 LaTeX 公式,$
表示行内公式,$$
表示整行公式。更多相关知识可参阅 LaTeX 入门 - OI Wiki
1 | $$ |
3 进阶使用
Markdown 语法还支持 HTML 标签,所以可以使用 HTML 标签来完成一些进阶效果。
3.1 复杂表格
使用 HTML 标签可以让表格实现合并单元格等效果,rowspan
为跨行合并,colspan
为跨列合并,style
可以添加 CSS 样式。
1 | <table> |
3.2 更改文本
使用 HTML 标签还可以给文本添加各种 CSS 样式,如改变颜色、字体、大小等。
1 | <font face="微软雅黑">微软雅黑</font> |
3.3 特殊标志
使用<kbd>
<sup>
<sub>
等标签可以实现键盘文本、上下标等效果。
1 | 复制:<kbd>Ctrl</kbd>+<kbd>C</kbd> |
3.4 调整图片
使用<img>
标签配合 CSS 样式可以调整图片。
1 | <img src="https://bing.mcloc.cn/img/2024/05/19/2024-05-19_hd.jpg" width = "200" align="right" /> |
4 高级技巧
Markdown 语法还有很多使用技巧需要探索发现。
4.1 插入bash64图片
将图片转化为 Bash64 编码,可以直接插入在![]()
的()
中使用。推荐一个编码网站:图片转BASE64。
1 | ![base64](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAeAB4.....dG7tzQTdtNWrn//2Q==) |
4.2 各类图表
Markdown 语法除了支持公式外,还支持多种图表。本节采集于网络,仅供参考。
1、横向流程图
1 | ```mermaid |
2、竖向流程图
1 | ```mermaid |
3、UML时序图
1 | ```mermaid |
4、甘特图
1 | ```mermaid |
5 工具
编写 Markdown 有很多好用的工具,就像编写文档有 Word 一样。
PC端:Typora(推荐)、Obsidian、VSCode等
移动端:Obsidian、坚果云Markdown等
Web端:Cmd Markdown、Editor.md等
我的博客即将同步至腾讯云开发者社区,邀请大家一同入驻:https://cloud.tencent.com/developer/support-plan?invite_code=3bjscq0kgso4k
- 感谢您的赞赏。