背景介绍
作为一个技术人员，基本都需要编写技术相关文档，而且大部分技术人员都应该掌握 markdown 这个技能，使用 markdown 来编写并生成 PDF 文档将会是一个不错的体验，以下就介绍下如何使用 VS Code Markdown 来编写 PDF 文档
效果演示
环境准备
[必须]安装 Visual Studio Code
[必须]安装 Extension - Markdown PDF，主要用于生成 PDF
[可选]安装 Extension - markdownlint，用于 markdown 语法提示
使用指引
1. 打开预览
使用 Ctrl Shift V 热键打开文档 Preview：
2. 文本内容
代码语言：javascript复制## 文本内容
- 字体
我是普通字体
- 斜体
*我是斜体*
- 粗体
**我是粗体**
- 粗斜体
***我是粗斜体***
- 删除线
~~我是删除线~~
3. 超链接
代码语言：javascript复制## 超链接
- [GitHub](https://github.com/)
- <https://github.com/>
4. 图片
代码语言：javascript复制## 图片
5. 代码块
代码语言：javascript复制## 代码块
- 行内式
演示各种编程语言的 `Hello World` 程序
- Java
```java
public class HelloWorld
{
public static void main(String[] args)
{
System.out.println("Hello,World!");
}
}
```
- C
```c
#include <stdio.h>
int main()
{
printf("Hello,World!");
return 1;
}
```
- C
```cpp
#include <iostream>
#include <stdio.h>
int main()
{
printf("Hello,World!--Way 1n");
puts("Hello,World!--Way 2");
puts("Hello," " " "World!--Way 3");
std::cout << "Hello,World!--Way 4" << std::endl;
return 1;
}
```
- Python
```python
print "Hello,World!" #Python 2.x
print("Hello,World!") #Python 3.x
```
- C#
```csharp
using System;
class TestApp
{
public static void Main()
{
Console.WriteLine("Hello,World!");
Console.ReadKey();
}
}
```
- Shell
```bash
echo "Hello,World!"
```
6. 列表
代码语言：javascript复制## 列表
### 无序列表
- 第一项
- 第二项
- 第三项
### 有序列表
1. 第一项
2. 第二项
3. 第三项
### 任务列表
- [x] 吃饭
- [x] 睡觉
- [ ] 写代码
7. 引用
代码语言：javascript复制## 引用
### 并列
> 引用1
> 引用2
> 引用3
### 嵌套
> 第一层嵌套
>> 第二层嵌套
>>>>> 第五层嵌套
### 引用中使用列表
> 引用
>
> 1. 第一项
> 2. 第二项
>
> - 第一项
> - 第二项
> - 第三项
### 列表中使用引用
- 第一项
> 引用1
> 引用2
- 第二项
8. 表格
代码语言：javascript复制## 表格
| 默认对齐 | 居左对齐 | 居右对齐 | 居中对齐 |
| ------- | :------- | ------: | :-----: |
| 单元格 | 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 | 单元格 |
9. UML
代码语言：javascript复制## UML
- markdown-it-plantuml
无法预览，项目地址：<https://github.com/gmunguia/markdown-it-plantuml>
@startuml
Bob -[#red]> Alice : hello
Alice -[#0000FF]->Bob : ok
@enduml
- mermaid
无法预览，项目地址：<https://mermaid-js.github.io/mermaid/#/>
```mermaid
erDiagram
CUSTOMER ||--o{ ORDER : places
ORDER ||--|{ LINE-ITEM : contains
CUSTOMER }|..|{ DELIVERY-ADDRESS : uses
```
10. 公式
代码语言：javascript复制## 公式
使用 LaTeX 语法，仅支持预览，不支持 pdf，需要先手动转换成图片或文本。
- 梯度下降的数学公式
$$theta_{n 1} = theta_{n} - eta cdot nabla J(theta) tag{1}$$
其中：
$theta_{n 1}$：下一个值
$theta_n$：当前值
$-$：减号，梯度的反向
$eta$：学习率或步长，控制每一步走的距离，不要太快以免错过了最佳景点，不要太慢以免时间太长
$nabla$：梯度，函数当前位置的最快上升点
$J(theta)$：函数
- 均方差函数
$$ loss = {1 over 2}(z-y)^2 tag{单样本} $$
$$ J=frac{1}{2m} sum_{i=1}^m (z_i-y_i)^2 tag{多样本} $$
11. 强制换页
使用自动换页有时会不合理低把内容分到不同的页码，使用以下代码可以强制换页，美化 PDF 排版。
代码语言：javascript复制<div style="page-break-after: always"></div>生成文档
在 markdown 文件窗口右键选择 Markdown PDF: Export {pdf} 生成 PDF
参考总结
以上就是本文希望分享的内容，如果大家有什么问题，欢迎在文章或者公众号 - 跬步之巅留言交流。
