|
@@ -371,7 +371,7 @@ Markdown 脚注的格式如下:
|
|
|
|
|
|
|
|
|
演示效果如下:
|
|
|
-
|
|
|
+
|
|
|

|
|
|
|
|
|
## 行内代码标记
|
|
@@ -428,20 +428,24 @@ HTML 替代方案:
|
|
|
段落之间由一个或多个空行分隔
|
|
|
普通段落不应该用空格或制表符缩进
|
|
|
正确的段落写法:
|
|
|
+
|
|
|
```
|
|
|
这是第一个段落。它可以包含多个句子,内容可以很长,会自动换行显示。
|
|
|
|
|
|
这是第二个段落。注意上面有一个空行分隔。
|
|
|
|
|
|
这是第三个段落。
|
|
|
-```
|
|
|
-
|
|
|
+```
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
常见错误:
|
|
|
+
|
|
|
```
|
|
|
这是第一段
|
|
|
这是第二段(错误:没有空行分隔)
|
|
|
|
|
|
- 这是缩进段落(错误:不应该缩进)
|
|
|
+ 这是缩进段落(错误:不应该缩进)
|
|
|
```
|
|
|
|
|
|

|
|
@@ -451,22 +455,29 @@ HTML 替代方案:
|
|
|
有时需要在不创建新段落的情况下换行,Markdown 提供了几种方法:
|
|
|
|
|
|
#### 方法一:行尾两个空格
|
|
|
-在行尾添加两个或更多空格,然后按回车:
|
|
|
+在行尾添加两个或更多空格,然后按回车:
|
|
|
+
|
|
|
```
|
|
|
第一行内容(这里有两个空格)
|
|
|
第二行内容
|
|
|
```
|
|
|
+
|
|
|
#### 方法二:HTML 换行标签
|
|
|
+
|
|
|
```
|
|
|
第一行内容<br>
|
|
|
第二行内容
|
|
|
```
|
|
|
+
|
|
|
#### 方法三:反斜杠(部分解析器支持)
|
|
|
+
|
|
|
```
|
|
|
第一行内容\
|
|
|
第二行内容
|
|
|
```
|
|
|
+
|
|
|
实际应用示例:
|
|
|
+
|
|
|
```
|
|
|
地址:北京市朝阳区
|
|
|
电话:010-12345678
|
|
@@ -485,12 +496,15 @@ HTML 替代方案:
|
|
|
空行在 Markdown 中扮演重要角色:
|
|
|
|
|
|
分隔段落:
|
|
|
+
|
|
|
```
|
|
|
第一段内容
|
|
|
|
|
|
第二段内容
|
|
|
```
|
|
|
+
|
|
|
分隔不同元素:
|
|
|
+
|
|
|
```
|
|
|
# 标题
|
|
|
|
|
@@ -521,6 +535,7 @@ HTML 替代方案:
|
|
|
|
|
|
## 无序列表
|
|
|
无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记,这些标记后面要添加一个空格,然后再填写内容:
|
|
|
+
|
|
|
```
|
|
|
* 第一项
|
|
|
* 第二项
|
|
@@ -537,6 +552,7 @@ HTML 替代方案:
|
|
|
```
|
|
|
|
|
|
显示结果如下:
|
|
|
+
|
|
|

|
|
|
|
|
|
选择建议:
|
|
@@ -550,6 +566,7 @@ HTML 替代方案:
|
|
|
有序列表用于展示有顺序要求的步骤或项目。
|
|
|
|
|
|
有序列表使用数字并加上 . 号来表示,如:
|
|
|
+
|
|
|
```
|
|
|
1. 第一项
|
|
|
2. 第二项
|
|
@@ -557,10 +574,12 @@ HTML 替代方案:
|
|
|
```
|
|
|
|
|
|
显示结果如下:
|
|
|
+
|
|
|

|
|
|
|
|
|
## 数字可以不连续
|
|
|
Markdown 会自动修正数字顺序:
|
|
|
+
|
|
|
```
|
|
|
1. 第一项
|
|
|
3. 第二项(实际显示为2)
|
|
@@ -570,6 +589,7 @@ Markdown 会自动修正数字顺序:
|
|
|

|
|
|
|
|
|
从指定数字开始:
|
|
|
+
|
|
|
```
|
|
|
5. 第五项
|
|
|
6. 第六项
|
|
@@ -583,6 +603,7 @@ Markdown 会自动修正数字顺序:
|
|
|
列表可以嵌套使用,创建多层次的结构:
|
|
|
|
|
|
无序列表嵌套:
|
|
|
+
|
|
|
```
|
|
|
- 水果
|
|
|
- 苹果
|
|
@@ -596,6 +617,7 @@ Markdown 会自动修正数字顺序:
|
|
|
```
|
|
|
|
|
|
有序列表嵌套:
|
|
|
+
|
|
|
```
|
|
|
1. 准备阶段
|
|
|
1. 收集资料
|
|
@@ -607,6 +629,7 @@ Markdown 会自动修正数字顺序:
|
|
|
```
|
|
|
|
|
|
混合嵌套:
|
|
|
+
|
|
|
```
|
|
|
1. 主要任务
|
|
|
- 子任务A
|
|
@@ -618,6 +641,7 @@ Markdown 会自动修正数字顺序:
|
|
|
```
|
|
|
|
|
|
列表混合嵌套只需在子列表中的选项前面添加两个或四个空格即可:
|
|
|
+
|
|
|
```
|
|
|
1. 第一项:
|
|
|
- 第一项嵌套的第一个元素
|
|
@@ -635,9 +659,10 @@ Markdown 会自动修正数字顺序:
|
|
|
保持一致的缩进长度
|
|
|
可以无限层嵌套,但实际使用中建议不超过 3 层
|
|
|
|
|
|
-## 任务列表(复选框列表)---任务列表是 GitHub 风格 Markdown 的扩展功能,现在被广泛支持:
|
|
|
+## 任务列表(复选框列表)---任务列表是GitHub风格Markdown的扩展功能,现在被广泛支持:
|
|
|
|
|
|
基本语法:
|
|
|
+
|
|
|
```
|
|
|
- [ ] 未完成的任务
|
|
|
- [x] 已完成的任务
|
|
@@ -647,6 +672,7 @@ Markdown 会自动修正数字顺序:
|
|
|

|
|
|
|
|
|
实际应用示例:
|
|
|
+
|
|
|
```
|
|
|
## 项目待办清单
|
|
|
|
|
@@ -682,6 +708,7 @@ Markdown 会自动修正数字顺序:
|
|
|
高级列表技巧:
|
|
|
|
|
|
列表项中包含多段内容:
|
|
|
+
|
|
|
```
|
|
|
1. 第一项
|
|
|
|
|
@@ -697,6 +724,7 @@ Markdown 会自动修正数字顺序:
|
|
|

|
|
|
|
|
|
列表项中的换行:
|
|
|
+
|
|
|
```
|
|
|
- 这是一个很长的列表项,
|
|
|
需要换行显示,注意第二行需要与第一行对齐
|
|
@@ -713,6 +741,7 @@ Markdown 会自动修正数字顺序:
|
|
|
基本语法:
|
|
|
|
|
|
Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号:
|
|
|
+
|
|
|
```
|
|
|
> 区块引用
|
|
|
> 菜鸟教程
|
|
@@ -722,6 +751,7 @@ Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一
|
|
|

|
|
|
|
|
|
## 多行引用:
|
|
|
+
|
|
|
```
|
|
|
> 这是引用的第一行。
|
|
|
> 这是引用的第二行。
|
|
@@ -732,6 +762,7 @@ Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一
|
|
|
简化写法:
|
|
|
|
|
|
只在第一行使用 > ,其余行会自动包含在引用中:
|
|
|
+
|
|
|
```
|
|
|
> 这是一个长引用,
|
|
|
包含多行内容,
|
|
@@ -743,6 +774,7 @@ Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一
|
|
|
|
|
|
## 多级嵌套引用
|
|
|
另外区块是可以嵌套的,一个 > 符号是最外层,两个 > 符号是第一层嵌套,以此类推:
|
|
|
+
|
|
|
```
|
|
|
> 最外层
|
|
|
> > 第一层嵌套
|
|
@@ -785,6 +817,7 @@ Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一
|
|
|
如果要在列表项目内放进区块,那么就需要在 > 前添加四个空格的缩进。
|
|
|
|
|
|
列表中使用区块实例如下:
|
|
|
+
|
|
|
```
|
|
|
* 第一项
|
|
|
> 菜鸟教程
|
|
@@ -798,6 +831,7 @@ Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一
|
|
|
引用块内可以包含几乎所有其他 Markdown 元素。
|
|
|
|
|
|
包含标题:
|
|
|
+
|
|
|
```
|
|
|
> ## 重要提醒
|
|
|
>
|
|
@@ -805,6 +839,7 @@ Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一
|
|
|
```
|
|
|
|
|
|
包含列表:
|
|
|
+
|
|
|
```
|
|
|
> ### 注意事项
|
|
|
>
|
|
@@ -818,18 +853,20 @@ Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一
|
|
|
```
|
|
|
|
|
|
包含代码:
|
|
|
+
|
|
|
```
|
|
|
> 要运行这个脚本,请使用以下命令:
|
|
|
>
|
|
|
-> ```bash
|
|
|
+> bash
|
|
|
> npm install
|
|
|
> npm start
|
|
|
-> ```
|
|
|
+>
|
|
|
>
|
|
|
> 执行后会在 `http://localhost:3000` 看到结果。
|
|
|
```
|
|
|
|
|
|
包含链接和图片:
|
|
|
+
|
|
|
```
|
|
|
> 📚 **推荐阅读**
|
|
|
>
|
|
@@ -849,6 +886,7 @@ Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一
|
|
|
|
|
|
## 重要信息提示
|
|
|
成功提示:
|
|
|
+
|
|
|
```
|
|
|
> ✅ **成功**
|
|
|
>
|
|
@@ -856,6 +894,7 @@ Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一
|
|
|
```
|
|
|
|
|
|
警告信息:
|
|
|
+
|
|
|
```
|
|
|
> ❌ **错误**
|
|
|
>
|
|
@@ -863,6 +902,7 @@ Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一
|
|
|
```
|
|
|
|
|
|
信息提示:
|
|
|
+
|
|
|
```
|
|
|
> ℹ️ **提示**
|
|
|
>
|
|
@@ -873,6 +913,7 @@ Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一
|
|
|
|
|
|
## 文档结构中的引用
|
|
|
章节摘要:
|
|
|
+
|
|
|
```
|
|
|
# 第一章:项目概述
|
|
|
|
|
@@ -886,6 +927,7 @@ Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一
|
|
|

|
|
|
|
|
|
版本更新说明:
|
|
|
+
|
|
|
```
|
|
|
## v2.1.0 更新内容
|
|
|
|
|
@@ -908,6 +950,7 @@ Markdown 提供了多种方式来展示代码,从简单的行内代码到复
|
|
|
|
|
|
## 行内代码
|
|
|
如果是段落上的一个函数或片段的代码可以用反引号把它包起来(`),例如:
|
|
|
+
|
|
|
```
|
|
|
`printf()` 函数
|
|
|
```
|
|
@@ -931,6 +974,7 @@ Markdown 提供了多种方式来展示代码,从简单的行内代码到复
|
|
|
显示反引号的方法:
|
|
|
|
|
|
使用双反引号包围单反引号:
|
|
|
+
|
|
|
```
|
|
|
``使用 `反引号` 包围代码``
|
|
|
```
|
|
@@ -938,6 +982,7 @@ Markdown 提供了多种方式来展示代码,从简单的行内代码到复
|
|
|

|
|
|
|
|
|
使用多个反引号包围:
|
|
|
+
|
|
|
```
|
|
|
```包含 `` 双反引号的代码```
|
|
|
```
|
|
@@ -956,6 +1001,7 @@ HTML 标签:<div> 元素
|
|
|
代码区块使用 4 个空格或者一个制表符(Tab 键)。
|
|
|
|
|
|
语法格式:
|
|
|
+
|
|
|
```
|
|
|
正常文本段落
|
|
|
|
|
@@ -972,13 +1018,12 @@ HTML 标签:<div> 元素
|
|
|
|
|
|
## 三反引号代码块
|
|
|
你也可以用 ``` ```包裹一段代码,并指定一种语言(也可以不指定):
|
|
|
-```
|
|
|
+
|
|
|
```
|
|
|
多行代码内容
|
|
|
可以包含空行
|
|
|
保持原有缩进
|
|
|
```
|
|
|
-```
|
|
|
|
|
|

|
|
|
|
|
@@ -1034,6 +1079,7 @@ JavaScript:
|
|
|
某些 Markdown 渲染器支持显示行号,通过特定的语法或配置实现。
|
|
|
|
|
|
语法示例(部分支持):
|
|
|
+
|
|
|

|
|
|
|
|
|
## 代码差异对比
|
|
@@ -1062,6 +1108,7 @@ Diff 语法:
|
|
|
掌握链接语法能让你创建内容丰富、易于导航的文档。
|
|
|
|
|
|
链接使用方法如下:
|
|
|
+
|
|
|
```
|
|
|
[链接名称](链接地址)
|
|
|
[链接文字](链接地址 "可选的标题")
|
|
@@ -1071,12 +1118,16 @@ Diff 语法:
|
|
|
```
|
|
|
|
|
|
一个简单的链接:
|
|
|
+
|
|
|
```
|
|
|
这是一个链接 [上海永天科技官网](https://www.usky.cn)
|
|
|
```
|
|
|
+
|
|
|

|
|
|
|
|
|
+
|
|
|
直接使用链接地址:
|
|
|
+
|
|
|
```
|
|
|
<https://www.usky.cn>
|
|
|
```
|
|
@@ -1084,6 +1135,7 @@ Diff 语法:
|
|
|

|
|
|
|
|
|
设置可选标题:
|
|
|
+
|
|
|
```
|
|
|
这是一个链接 [上海永天科技官网](https://www.usky.cn)
|
|
|
欢迎访问 [GitHub](https://github.com) 官网
|
|
@@ -1098,6 +1150,7 @@ Diff 语法:
|
|
|
对搜索引擎优化和无障碍访问有帮助
|
|
|
标题文字放在双引号、单引号或括号中都可以
|
|
|
邮箱链接:
|
|
|
+
|
|
|
```
|
|
|
markdown联系我:[发送邮件](mailto:usky@email.com)
|
|
|
电话联系:[拨打电话](tel:+86-100-0000-8000)
|
|
@@ -1107,6 +1160,7 @@ markdown联系我:[发送邮件](mailto:usky@email.com)
|
|
|
参考式链接将链接定义与使用分离,让文档更整洁,特别适合长文档或需要多次引用相同链接的情况。
|
|
|
|
|
|
基本语法:
|
|
|
+
|
|
|
```
|
|
|
markdown[链接文字][参考标签]
|
|
|
|
|
@@ -1114,6 +1168,7 @@ markdown[链接文字][参考标签]
|
|
|
```
|
|
|
|
|
|
我们可以通过变量来设置一个链接,变量赋值在文档末尾进行:
|
|
|
+
|
|
|
```
|
|
|
这个链接用 1 作为网址变量 [Google][1]
|
|
|
这个链接用 usky 作为网址变量 [Usky][usky]
|
|
@@ -1128,6 +1183,7 @@ markdown[链接文字][参考标签]
|
|
|
简化写法:
|
|
|
|
|
|
当参考标签与链接文字相同时,可以省略第二个方括号:
|
|
|
+
|
|
|
```
|
|
|
markdown 我喜欢使用 [GitHub][] 来管理代码。
|
|
|
|
|
@@ -1143,6 +1199,7 @@ markdown 我喜欢使用 [GitHub][] 来管理代码。
|
|
|
链接定义可以放在文档任意位置(通常放在末尾)
|
|
|
组织技巧:
|
|
|
markdown# 学习资源推荐
|
|
|
+
|
|
|
```
|
|
|
## 在线教程
|
|
|
- [MDN Web Docs][mdn] - 权威的 Web 技术文档
|
|
@@ -1167,15 +1224,19 @@ markdown# 学习资源推荐
|
|
|
现代 Markdown 解析器通常支持自动识别 URL 和邮箱地址:
|
|
|
|
|
|
URL 自动识别:
|
|
|
+
|
|
|
```
|
|
|
markdown直接输入网址:https://www.example.com
|
|
|
用尖括号包围:<https://www.example.com>
|
|
|
```
|
|
|
+
|
|
|
邮箱自动识别:
|
|
|
+
|
|
|
```
|
|
|
markdown联系邮箱:example@email.com
|
|
|
或者:<example@email.com>
|
|
|
```
|
|
|
+
|
|
|
注意事项:
|
|
|
|
|
|
自动识别功能依赖于具体的 Markdown 解析器
|
|
@@ -1185,6 +1246,7 @@ markdown联系邮箱:example@email.com
|
|
|
锚点链接用于在同一文档内跳转,特别适合长文档的导航:
|
|
|
|
|
|
跳转到标题:
|
|
|
+
|
|
|
```
|
|
|
## 目录
|
|
|
- [第一章:介绍](#第一章介绍)
|
|
@@ -1210,6 +1272,7 @@ markdown联系邮箱:example@email.com
|
|
|
空格替换为连字符
|
|
|
移除特殊字符
|
|
|
手动创建锚点:
|
|
|
+
|
|
|
```
|
|
|
<a id="custom-anchor"></a>
|
|
|
## 自定义锚点位置
|
|
@@ -1218,6 +1281,7 @@ markdown联系邮箱:example@email.com
|
|
|
|
|
|
```
|
|
|
|
|
|
+
|
|
|
页面顶部返回链接:
|
|
|
```
|
|
|
[回到顶部](#)
|
|
@@ -1236,14 +1300,17 @@ markdown联系邮箱:example@email.com
|
|
|
Markdown 的图片语法简洁而灵活。
|
|
|
|
|
|
Markdown 图片语法格式如下:
|
|
|
+
|
|
|
```
|
|
|

|
|
|

|
|
|
```
|
|
|
+
|
|
|
开头一个感叹号 !
|
|
|
接着一个方括号,里面放上图片的替代文字
|
|
|
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的 'title' 属性的文字。
|
|
|
-相对路径示例:
|
|
|
+相对路径示例:
|
|
|
+
|
|
|
```
|
|
|

|
|
|

|
|
@@ -1251,10 +1318,12 @@ Markdown 图片语法格式如下:
|
|
|
```
|
|
|
|
|
|
绝对路径示例:
|
|
|
+
|
|
|
```
|
|
|

|
|
|

|
|
|
```
|
|
|
+
|
|
|
路径使用建议:
|
|
|
|
|
|
推荐使用相对路径,便于项目移植
|
|
@@ -1262,6 +1331,7 @@ Markdown 图片语法格式如下:
|
|
|
使用有意义的文件名,便于管理
|
|
|
注意路径分隔符在不同操作系统中的差异
|
|
|
直接引用网络图片:
|
|
|
+
|
|
|
```
|
|
|

|
|
|
|
|
@@ -1271,6 +1341,7 @@ Markdown 图片语法格式如下:
|
|
|

|
|
|
|
|
|
当然,你也可以像网址那样对图片网址使用变量:
|
|
|
+
|
|
|
```
|
|
|
这个链接用 1 作为网址变量 [USKY][1].
|
|
|
然后在文档的结尾为变量赋值(网址)
|
|
@@ -1279,15 +1350,18 @@ Markdown 图片语法格式如下:
|
|
|
```
|
|
|
|
|
|
Markdown 还没有办法指定图片的高度与宽度,如果你需要的话,你可以使用普通的 `<img> `标签。
|
|
|
+
|
|
|
```
|
|
|
<img src="http://47.111.81.118:4000/images/uskylogo.png" width="50%">
|
|
|
```
|
|
|
|
|
|
使用 CDN 服务:
|
|
|
+
|
|
|
```
|
|
|

|
|
|

|
|
|
```
|
|
|
+
|
|
|
网络图片注意事项:
|
|
|
|
|
|
确保图片 URL 的稳定性和可访问性
|
|
@@ -1300,17 +1374,21 @@ Markdown 还没有办法指定图片的高度与宽度,如果你需要的话
|
|
|
Alt 文本(替代文字)在图片无法显示时提供替代信息,同时对无障碍访问和 SEO 很重要:
|
|
|
|
|
|
好的 alt 文本示例:
|
|
|
+
|
|
|
```
|
|
|

|
|
|

|
|
|

|
|
|
```
|
|
|
+
|
|
|
避免的 alt 文本:
|
|
|
+
|
|
|
```
|
|
|
 // 太简单,没有描述性
|
|
|
 // 完全没有 alt 文本
|
|
|
 // 不描述图片内容
|
|
|
```
|
|
|
+
|
|
|
alt 文本最佳实践:
|
|
|
|
|
|
简洁但有描述性
|
|
@@ -1323,6 +1401,7 @@ alt 文本最佳实践:
|
|
|
标准 Markdown 不支持直接控制图片尺寸,但可以使用 HTML 标签。
|
|
|
|
|
|
使用 HTML img 标签:
|
|
|
+
|
|
|
```
|
|
|
<img src="image.jpg" alt="描述文字" width="300" height="200">
|
|
|
<img src="image.jpg" alt="描述文字" width="50%">
|
|
@@ -1330,11 +1409,13 @@ alt 文本最佳实践:
|
|
|
```
|
|
|
|
|
|
响应式图片:
|
|
|
+
|
|
|
```
|
|
|
<img src="image.jpg" alt="描述文字" style="max-width: 100%; height: auto;">
|
|
|
```
|
|
|
|
|
|
图片对齐:
|
|
|
+
|
|
|
```
|
|
|
<!-- 居中对齐 -->
|
|
|
<div align="center">
|
|
@@ -1353,17 +1434,20 @@ alt 文本最佳实践:
|
|
|
将图片作为链接的可点击元素。
|
|
|
|
|
|
基本语法:
|
|
|
+
|
|
|
```
|
|
|
[](链接URL)
|
|
|
```
|
|
|
|
|
|
实际示例:
|
|
|
+
|
|
|
```
|
|
|
[](https://github.com/username/project)
|
|
|
[](https://example.com "点击访问官网")
|
|
|
```
|
|
|
|
|
|
常见应用场景:
|
|
|
+
|
|
|
```
|
|
|
<!-- 项目徽章 -->
|
|
|
[](https://travis-ci.org/user/repo)
|
|
@@ -1376,6 +1460,7 @@ alt 文本最佳实践:
|
|
|
|
|
|
相对路径与绝对路径
|
|
|
相对路径的优势:
|
|
|
+
|
|
|
```
|
|
|
<!-- 项目结构 -->
|
|
|
project/
|
|
@@ -1404,6 +1489,7 @@ project/
|
|
|
|
|
|
## 图片居中和对齐
|
|
|
方法一:HTML + CSS
|
|
|
+
|
|
|
```
|
|
|
<div style="text-align: center;">
|
|
|
<img src="image.jpg" alt="居中图片" style="max-width: 100%;">
|
|
@@ -1411,6 +1497,7 @@ project/
|
|
|
```
|
|
|
|
|
|
方法二:使用 HTML 对齐属性
|
|
|
+
|
|
|
```
|
|
|
<p align="center">
|
|
|
<img src="image.jpg" alt="居中图片" width="400">
|
|
@@ -1418,6 +1505,7 @@ project/
|
|
|
```
|
|
|
|
|
|
方法三:创建图片画廊
|
|
|
+
|
|
|
```
|
|
|
<div style="display: flex; justify-content: space-around; flex-wrap: wrap;">
|
|
|
<img src="image1.jpg" alt="图片1" style="width: 30%; margin: 10px;">
|
|
@@ -1427,6 +1515,7 @@ project/
|
|
|
```
|
|
|
|
|
|
实用的图片展示模板:
|
|
|
+
|
|
|
```
|
|
|
## 产品展示
|
|
|
|
|
@@ -1472,6 +1561,7 @@ project/
|
|
|
图片过大:使用 HTML 控制尺寸或优化图片文件
|
|
|
链接在新窗口打开:使用 HTML <a target="_blank"> 标签
|
|
|
调试技巧:
|
|
|
+
|
|
|
```
|
|
|
<!-- 测试链接是否有效 -->
|
|
|
测试链接:[点击测试](https://httpbin.org/get)
|
|
@@ -1495,6 +1585,7 @@ project/
|
|
|
Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。
|
|
|
|
|
|
语法格式如下:
|
|
|
+
|
|
|
```
|
|
|
| 表头 | 表头 |
|
|
|
| ---- | ---- |
|
|
@@ -1518,6 +1609,7 @@ Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔
|
|
|
:--- 设置内容和标题栏居左对齐。
|
|
|
:---: 设置内容和标题栏居中对齐。
|
|
|
实例如下:
|
|
|
+
|
|
|
```
|
|
|
| 左对齐 | 右对齐 | 居中对齐 |
|
|
|
| :-----| ----: | :----: |
|
|
@@ -1530,6 +1622,7 @@ Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔
|
|
|
## 复杂表格的处理技巧
|
|
|
元格内容格式化
|
|
|
表格单元格内可以使用大部分 Markdown 语法:
|
|
|
+
|
|
|
```
|
|
|
| 功能 | 描述 | 状态 |
|
|
|
|------|------|:----:|
|
|
@@ -1545,6 +1638,7 @@ Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔
|
|
|
当单元格内容较长时,可以使用以下技巧:
|
|
|
|
|
|
换行处理:
|
|
|
+
|
|
|
```
|
|
|
| 项目 | 详细说明 |
|
|
|
|------|----------|
|
|
@@ -1553,6 +1647,7 @@ Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔
|
|
|
```
|
|
|
|
|
|
缩写和链接:
|
|
|
+
|
|
|
```
|
|
|
| 技术栈 | 说明 | 官网 |
|
|
|
|--------|------|------|
|
|
@@ -1565,6 +1660,7 @@ Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔
|
|
|
|
|
|
表格中的特殊字符
|
|
|
某些字符在表格中有特殊含义,需要转义:
|
|
|
+
|
|
|
```
|
|
|
| 字符 | 转义方法 | 示例 |
|
|
|
|------|----------|------|
|
|
@@ -1577,6 +1673,7 @@ Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔
|
|
|
|
|
|
## 表格美化建议
|
|
|
使用 Emoji 和符号
|
|
|
+
|
|
|
```
|
|
|
| 状态 | 图标 | 说明 |
|
|
|
|:----:|:----:|------|
|
|
@@ -1591,6 +1688,7 @@ Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔
|
|
|
|
|
|
数据表格最佳实践
|
|
|
财务数据表格:
|
|
|
+
|
|
|
```
|
|
|
| 月份 | 收入 | 支出 | 利润 | 增长率 |
|
|
|
|:----:|-----:|-----:|-----:|-------:|
|
|
@@ -1603,6 +1701,7 @@ Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔
|
|
|

|
|
|
|
|
|
技术对比表格:
|
|
|
+
|
|
|
```
|
|
|
| 特性 | React | Vue.js | Angular | 评分 |
|
|
|
|------|:-----:|:------:|:-------:|:----:|
|
|
@@ -1619,6 +1718,7 @@ Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔
|
|
|
对于复杂表格,可以考虑分解为多个简单表格。
|
|
|
|
|
|
移动端友好的设计:
|
|
|
+
|
|
|
```
|
|
|
### 基本信息
|
|
|
| 项目 | 值 |
|
|
@@ -1649,6 +1749,7 @@ Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔
|
|
|
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
|
|
|
|
|
|
目前支持的 HTML 元素有:`<kbd> <b> <i> <em> <sup> <sub> <br>`等 ,如:
|
|
|
+
|
|
|
```
|
|
|
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑
|
|
|
```
|
|
@@ -1657,6 +1758,7 @@ Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔
|
|
|
|
|
|
## 转义
|
|
|
Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符:
|
|
|
+
|
|
|
```
|
|
|
**文本加粗**
|
|
|
\*\* 正常显示星号 \*\*
|
|
@@ -1665,6 +1767,7 @@ Markdown 使用了很多特殊符号来表示特定的意义,如果需要显
|
|
|

|
|
|
|
|
|
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
|
|
|
+
|
|
|
```
|
|
|
\ 反斜线
|
|
|
` 反引号
|
|
@@ -1744,6 +1847,7 @@ ___
|
|
|
|
|
|
## 扩展写法
|
|
|
可以使用更多的符号,但三个是最小要求:
|
|
|
+
|
|
|
```
|
|
|
-----
|
|
|
*****
|
|
@@ -1751,6 +1855,7 @@ _____
|
|
|
```
|
|
|
|
|
|
空格的影响:符号之间可以有空格。
|
|
|
+
|
|
|
```
|
|
|
- - -
|
|
|
* * *
|
|
@@ -1759,6 +1864,7 @@ _ _ _
|
|
|
|
|
|
## 分割线的使用场景
|
|
|
章节分隔
|
|
|
+
|
|
|
```
|
|
|
# 第一章:概述
|
|
|
|
|
@@ -1780,6 +1886,7 @@ _ _ _
|
|
|

|
|
|
|
|
|
内容区块分隔
|
|
|
+
|
|
|
```
|
|
|
## 产品特性
|
|
|
|
|
@@ -1818,6 +1925,7 @@ markdown正文内容...
|
|
|

|
|
|
|
|
|
引用和正文分隔
|
|
|
+
|
|
|
```
|
|
|
项目介绍的正文内容...
|
|
|
|
|
@@ -1836,6 +1944,7 @@ markdown正文内容...
|
|
|
|
|
|
## 分割线的最佳实践
|
|
|
避免过度使用:
|
|
|
+
|
|
|
```
|
|
|
# 标题
|
|
|
|
|
@@ -1849,6 +1958,7 @@ markdown正文内容...
|
|
|
```
|
|
|
|
|
|
合理的使用:
|
|
|
+
|
|
|
```
|
|
|
# 项目文档
|
|
|
|
|
@@ -1874,6 +1984,7 @@ FAQ内容...
|
|
|
```
|
|
|
|
|
|
与其他元素的配合:
|
|
|
+
|
|
|
```
|
|
|
## 版本历史
|
|
|
|
|
@@ -1913,6 +2024,7 @@ FAQ内容...
|
|
|
上标:使用 ^,如 x^2
|
|
|
分组:用花括号将多个字符组合,如 x_{i+1}
|
|
|
常用 LaTeX 命令
|
|
|
+
|
|
|
```
|
|
|
\alpha, \beta, \gamma % 希腊字母
|
|
|
\sum, \prod, \int % 求和、乘积、积分
|
|
@@ -2004,6 +2116,7 @@ $$
|
|
|
a & b \
|
|
|
c & d
|
|
|
\end{pmatrix}
|
|
|
+
|
|
|
```
|
|
|
$$
|
|
|
\begin{pmatrix}
|
|
@@ -2152,6 +2265,7 @@ graph LR
|
|
|
C --> E[结束]
|
|
|
D --> E
|
|
|
```
|
|
|
+
|
|
|
语法说明:
|
|
|
graph 声明流程图
|
|
|
LR 表示从左到右布局 (可选 TB/RL/BT)
|