使用 VS Code + Markdown 编写 PDF 文档

背景介绍

作为一个技术人员,基本都需要编写技术相关文档,而且大部分技术人员都应该掌握 markdown 这个技能,使用 markdown 来编写并生成 PDF 文档将会是一个不错的体验,以下就介绍下如何使用 VS Code + Markdown 来编写 PDF 文档

 

效果演示

 

环境准备

[必须]安装 Visual Studio Code

 

[必须]安装 Extension - Markdown PDF,主要用于生成 PDF

 

[可选]安装 Extension - markdownlint,用于 markdown 语法提示

 

使用指引

1. 打开预览

使用 Ctrl+Shift+V 热键打开文档 Preview:

 

2. 文本内容

## 文本内容

- 字体

  我是普通字体

- 斜体

  *我是斜体*

- 粗体

  **我是粗体**

- 粗斜体

  ***我是粗斜体***

- 删除线

  ~~我是删除线~~

 

3. 超链接

## 超链接

- [GitHub](https://github.com/)

- <https://github.com/>

 

4. 图片

## 图片

![图片](image.png "图片")

 

5. 代码块

## 代码块

- 行内式

  演示各种编程语言的 `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 1\n");  
      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. 列表

## 列表

### 无序列表

- 第一项
- 第二项
- 第三项

### 有序列表

1. 第一项
2. 第二项
3. 第三项

### 任务列表

- [x] 吃饭
- [x] 睡觉
- [ ] 写代码

 

 7. 引用

## 引用

### 并列

> 引用1  
> 引用2  
> 引用3  

### 嵌套

> 第一层嵌套
>> 第二层嵌套  
>>>>> 第五层嵌套

### 引用中使用列表

> 引用
>
> 1. 第一项
> 2. 第二项
>
> - 第一项
> - 第二项
> - 第三项

### 列表中使用引用

- 第一项
    > 引用1  
    > 引用2
- 第二项

 

8. 表格

## 表格

| 默认对齐 | 居左对齐 | 居右对齐 | 居中对齐 |
| ------- | :------- | ------: | :-----: |
| 单元格 | 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 | 单元格 |

 

9. UML

## 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. 公式

## 公式

使用 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 排版。

<div style="page-break-after: always"></div>

 

生成文档

在 markdown 文件窗口右键选择 Markdown PDF: Export {pdf} 生成 PDF

 

 

参考总结

以上就是本文希望分享的内容,如果大家有什么问题,欢迎在文章或者公众号 - 跬步之巅留言交流。
posted @ 2022-05-19 06:15  编程玩家  阅读(1746)  评论(7编辑  收藏  举报