259 lines
8.8 KiB
Markdown
259 lines
8.8 KiB
Markdown
---
|
||
title: Markdown
|
||
createTime: 2025/03/03 23:12:31
|
||
permalink: /csdiy/tools-must/markdown/
|
||
icon: material-symbols:markdown
|
||
---
|
||
|
||
> markdown 是一种轻量级的标记语言，可用于在纯文本文档中添加格式化元素。Markdown 由 John Gruber 于 2004 年创建，如今已成为世界上最受欢迎的标记语言之一。
|
||
> 1. 专注于文字内容；
|
||
> 2. 纯文本，易读易写，可以方便地纳入版本控制；
|
||
> 3. 语法简单，没有什么学习成本，能轻松在码字的同时做出美观大方的排版。
|
||
|
||
下面有几个可以学习markdown基础语法的网站：
|
||
|
||
<CardGrid>
|
||
<LinkCard icon = "/src/2025-03-12_23-14-02.png" title="Getting Started | Markdown" href="https://www.markdownguide.org/getting-started/"/>
|
||
|
||
<LinkCard icon = "/src/2025-03-12_23-14-35.png" title="Markdown教程 | 菜鸟教程" href="https://www.runoob.com/markdown/md-tutorial.html" />
|
||
|
||
<LinkCard icon = "/src/2025-03-12_23-15-01.png" title="Markdown基本语法" href="https://markdown.com.cn/basic-syntax/" />
|
||
|
||
<LinkCard icon = "entypo-social:github-with-circle" title="Markdown Github-docs" href="https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax" />
|
||
</CardGrid>
|
||
|
||
## 支持 markdown的主流编辑器
|
||
### Typora
|
||
<LinkCard icon = "/typora.svg" title="Typora" href="https://www.markdownguide.org/getting-started/"/>
|
||
|
||
### VScode
|
||
<LinkCard icon = "devicon:vscode" title="VScode" href="https://code.visualstudio.com/"/>
|
||
|
||
### JetBrains
|
||
<LinkCard icon = "logos:jetbrains-icon" title="JetBrains" href="https://www.jetbrains.com/"/>
|
||
|
||
## Markdown简易教程
|
||
|
||
### 欢迎使用Markdown编辑器
|
||
|
||
你好！ 这是你第一次使用 **Markdown编辑器** 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章，了解一下Markdown的基本语法知识。
|
||
|
||
### 新的改变
|
||
|
||
我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：
|
||
|
||
1. **全新的界面设计** ，将会带来全新的写作体验；
|
||
2. 在创作中心设置你喜爱的代码高亮样式，Markdown **将代码片显示选择的高亮样式** 进行展示；
|
||
3. 增加了 **图片拖拽** 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
|
||
4. 全新的 **KaTeX数学公式** 语法；
|
||
5. 增加了支持**甘特图的mermaid语法[^1]** 功能；
|
||
6. 增加了 **多屏幕编辑** Markdown文章功能；
|
||
7. 增加了 **焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置** 等功能，功能按钮位于编辑区域与预览区域中间；
|
||
8. 增加了 **检查列表** 功能。
|
||
|
||
[^1]: [mermaid语法说明](https://mermaidjs.github.io/)
|
||
|
||
### 功能快捷键
|
||
|
||
- 撤销：<kbd>Ctrl/Command</kbd> + <kbd>Z</kbd>
|
||
- 重做：<kbd>Ctrl/Command</kbd> + <kbd>Y</kbd>
|
||
- 加粗：<kbd>Ctrl/Command</kbd> + <kbd>B</kbd>
|
||
- 斜体：<kbd>Ctrl/Command</kbd> + <kbd>I</kbd>
|
||
- 标题：<kbd>Ctrl/Command</kbd> + <kbd>Shift</kbd> + <kbd>H</kbd>
|
||
- 无序列表：<kbd>Ctrl/Command</kbd> + <kbd>Shift</kbd> + <kbd>U</kbd>
|
||
- 有序列表：<kbd>Ctrl/Command</kbd> + <kbd>Shift</kbd> + <kbd>O</kbd>
|
||
- 检查列表：<kbd>Ctrl/Command</kbd> + <kbd>Shift</kbd> + <kbd>C</kbd>
|
||
- 插入代码：<kbd>Ctrl/Command</kbd> + <kbd>Shift</kbd> + <kbd>K</kbd>
|
||
- 插入链接：<kbd>Ctrl/Command</kbd> + <kbd>Shift</kbd> + <kbd>L</kbd>
|
||
- 插入图片：<kbd>Ctrl/Command</kbd> + <kbd>Shift</kbd> + <kbd>G</kbd>
|
||
- 查找：<kbd>Ctrl/Command</kbd> + <kbd>F</kbd>
|
||
- 替换：<kbd>Ctrl/Command</kbd> + <kbd>G</kbd>
|
||
|
||
### 合理的创建标题，有助于目录的生成
|
||
|
||
直接输入1次<kbd>#</kbd>，并按下<kbd>space</kbd>后，将生成1级标题。
|
||
输入2次<kbd>#</kbd>，并按下<kbd>space</kbd>后，将生成2级标题。
|
||
以此类推，我们支持6级标题。有助于使用`TOC`语法后生成一个完美的目录。
|
||
|
||
### 如何改变文本的样式
|
||
|
||
*强调文本* _强调文本_
|
||
|
||
**加粗文本** __加粗文本__
|
||
|
||
==标记文本==
|
||
|
||
~~删除文本~~
|
||
|
||
> 引用文本
|
||
|
||
H~2~O is是液体。
|
||
|
||
2^10^ 运算结果是 1024.
|
||
|
||
### 插入链接与图片
|
||
|
||
链接: [link](https://www.csdn.net/).
|
||
|
||
图片: 
|
||
|
||
带尺寸的图片: 
|
||
|
||
居中的图片: 
|
||
|
||
居中并且带尺寸的图片: 
|
||
|
||
当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。
|
||
|
||
### 如何插入一段漂亮的代码片
|
||
|
||
去[博客设置](https://mp.csdn.net/console/configBlog)页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 `代码片`.
|
||
|
||
```javascript
|
||
// An highlighted block
|
||
var foo = 'bar';
|
||
```
|
||
|
||
### 生成一个适合你的列表
|
||
|
||
- 项目
|
||
- 项目
|
||
- 项目
|
||
|
||
1. 项目1
|
||
2. 项目2
|
||
3. 项目3
|
||
|
||
- [x] 计划任务
|
||
- [x] 完成任务
|
||
|
||
### 创建一个表格
|
||
|
||
一个简单的表格是这么创建的：
|
||
|
||
| 项目 | Value |
|
||
| ---- | ----- |
|
||
| 电脑 | $1600 |
|
||
| 手机 | $12 |
|
||
| 导管 | $1 |
|
||
|
||
#### 设定内容居中、居左、居右
|
||
|
||
使用`:---------:`居中
|
||
使用`:----------`居左
|
||
使用`----------:`居右
|
||
|
||
| 第一列 | 第二列 | 第三列 |
|
||
| :------------: | -------------: | :------------- |
|
||
| 第一列文本居中 | 第二列文本居右 | 第三列文本居左 |
|
||
|
||
#### SmartyPants
|
||
|
||
SmartyPants将ASCII标点字符转换为“智能”印刷标点HTML实体。例如：
|
||
|
||
| TYPE | ASCII | HTML |
|
||
| ---------------- | ------------------------------- | ----------------------------- |
|
||
| Single backticks | `'Isn't this fun?'` | 'Isn't this fun?' |
|
||
| Quotes | `"Isn't this fun?"` | "Isn't this fun?" |
|
||
| Dashes | `-- is en-dash, --- is em-dash` | -- is en-dash, --- is em-dash |
|
||
|
||
### 创建一个自定义列表
|
||
|
||
Markdown
|
||
: Text-to-HTML conversion tool
|
||
|
||
Authors
|
||
: John
|
||
: Luke
|
||
|
||
### 如何创建一个注脚
|
||
|
||
一个具有注脚的文本。[^2]
|
||
|
||
[^2]: 注脚的解释
|
||
|
||
### 注释也是必不可少的
|
||
|
||
Markdown将文本转换为 HTML。
|
||
|
||
*[HTML]: 超文本标记语言
|
||
|
||
### KaTeX数学公式
|
||
|
||
您可以使用渲染LaTeX数学表达式 [KaTeX](https://khan.github.io/KaTeX/):
|
||
|
||
Gamma公式展示 $\Gamma(n) = (n-1)!\quad\forall
|
||
n\in\mathbb N$ 是通过欧拉积分
|
||
|
||
$$
|
||
\Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.
|
||
$$
|
||
|
||
> 你可以找到更多关于的信息 **LaTeX** 数学表达式[here][1].
|
||
|
||
### 新的甘特图功能，丰富你的文章
|
||
|
||
```mermaid
|
||
gantt
|
||
dateFormat YYYY-MM-DD
|
||
title Adding GANTT diagram functionality to mermaid
|
||
section 现有任务
|
||
已完成 :done, des1, 2014-01-06,2014-01-08
|
||
进行中 :active, des2, 2014-01-09, 3d
|
||
计划一 : des3, after des2, 5d
|
||
计划二 : des4, after des3, 5d
|
||
```
|
||
|
||
- 关于 **甘特图** 语法，参考 [这儿][2],
|
||
|
||
### UML 图表
|
||
|
||
可以使用UML图表进行渲染。 [Mermaid](https://mermaidjs.github.io/). 例如下面产生的一个序列图：
|
||
|
||
```mermaid
|
||
sequenceDiagram
|
||
张三 ->> 李四: 你好！李四, 最近怎么样?
|
||
李四-->>王五: 你最近怎么样，王五？
|
||
李四--x 张三: 我很好，谢谢!
|
||
李四-x 王五: 我很好，谢谢!
|
||
Note right of 王五: 李四想了很长时间, 文字太长了<br/>不适合放在一行.
|
||
|
||
李四-->>张三: 打量着王五...
|
||
张三->>王五: 很好... 王五, 你怎么样?
|
||
```
|
||
|
||
这将产生一个流程图。:
|
||
|
||
```mermaid
|
||
graph LR
|
||
A[长方形] -- 链接 --> B((圆))
|
||
A --> C(圆角长方形)
|
||
B --> D{菱形}
|
||
C --> D
|
||
```
|
||
|
||
- 关于 **Mermaid** 语法，参考 [这儿][3],
|
||
|
||
### FLowchart流程图
|
||
|
||
[//]: # (TODO: 此处待写)
|
||
|
||
Flowchart是一种可视化工具，可通过自由编辑图形符号（如矩形、菱形、箭头等）来展示您的逻辑思考
|
||
|
||
- 关于 **Flowchart流程图** 语法，参考 [这儿][4].
|
||
|
||
### 导出与导入
|
||
|
||
### 导出
|
||
|
||
如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 **文章导出** ，生成一个.md文件或者.html文件进行本地保存。
|
||
|
||
### 导入
|
||
|
||
如果你想加载一篇你写过的.md文件，在上方工具栏可以选择导入功能进行对应扩展名的文件导入，
|
||
继续你的创作。
|
||
|
||
[1]: http://meta.math.stackexchange.com/questions/5020/mathjax-basic-tutorial-and-quick-reference
|
||
[2]: https://mermaidjs.github.io/
|
||
[3]: https://mermaidjs.github.io/
|
||
[4]: http://adrai.github.io/flowchart.js/ |