如何在Azure DevOps Wiki CLI更新时实现内容换行？

你遇到的问题是因为shell未将\n解析为实际换行符，而是把它当作字面字符传递给了命令。根据你使用的shell环境不同，可采用以下解决方案：

1. 按Shell类型调整转义逻辑 #

Bash/Zsh（类Unix环境） #

使用ANSI-C引号（$'...'）包裹内容，这种语法会自动将\n转换为实际换行：

az devops wiki page update --wiki-name "你的Wiki名称" --path "/目标页面路径" --content $'# Main Heading\n\n## Subheading\n\n| **Column Header**          | **Header 1** | **Header 2** | **Header 3** |  **Header 4** | **Header 5**    |\n| -----------------      | ------- | ------- | ------- | -------- | ---------- |\n| Item 1 | 1.1.1 | 1.1.1 | 1.1.1 | 1.1.1 | **1.1.1** |\n| Item 2 | 2.2.2 | 2.2.2 | 2.2.2 | 2.2.2 | **2.2.2** |\n| Item 3 | 3.3.3 | 3.3.3 | 3.3.3 | 3.3.3 | **3.3.3** |\n| Item 4 | 4.4.4 | 4.4.4 | 4.4.4 | 4.4.4 | **4.4.4** |'

PowerShell（Windows环境） #

PowerShell的转义字符为**反引号（）**，需将内容中的\n替换为`` n ``，或使用Here-String直接写入多行内容：

方法一：替换转义字符

az devops wiki page update --wiki-name "你的Wiki名称" --path "/目标页面路径" --content "# Main Heading`n`n## Subheading`n`n| **Column Header**          | **Header 1** | **Header 2** | **Header 3** |  **Header 4** | **Header 5**    |`n| -----------------      | ------- | ------- | ------- | -------- | ---------- |`n| Item 1 | 1.1.1 | 1.1.1 | 1.1.1 | 1.1.1 | **1.1.1** |`n| Item 2 | 2.2.2 | 2.2.2 | 2.2.2 | 2.2.2 | **2.2.2** |`n| Item 3 | 3.3.3 | 3.3.3 | 3.3.3 | 3.3.3 | **3.3.3** |`n| Item 4 | 4.4.4 | 4.4.4 | 4.4.4 | 4.4.4 | **4.4.4** |"

方法二：使用Here-String

$content = @"
# Main Heading

## Subheading

| **Column Header**          | **Header 1** | **Header 2** | **Header 3** |  **Header 4** | **Header 5**    |
| -----------------      | ------- | ------- | ------- | -------- | ---------- |
| Item 1 | 1.1.1 | 1.1.1 | 1.1.1 | 1.1.1 | **1.1.1** |
| Item 2 | 2.2.2 | 2.2.2 | 2.2.2 | 2.2.2 | **2.2.2** |
| Item 3 | 3.3.3 | 3.3.3 | 3.3.3 | 3.3.3 | **3.3.3** |
| Item 4 | 4.4.4 | 4.4.4 | 4.4.4 | 4.4.4 | **4.4.4** |
"@
az devops wiki page update --wiki-name "你的Wiki名称" --path "/目标页面路径" --content $content

2. 使用文件传递内容（最可靠） #

将Markdown内容保存为本地文件（比如wiki-content.md），内容直接保留换行：

# Main Heading

## Subheading

| **Column Header**          | **Header 1** | **Header 2** | **Header 3** |  **Header 4** | **Header 5**    |
| -----------------      | ------- | ------- | ------- | -------- | ---------- |
| Item 1 | 1.1.1 | 1.1.1 | 1.1.1 | 1.1.1 | **1.1.1** |
| Item 2 | 2.2.2 | 2.2.2 | 2.2.2 | 2.2.2 | **2.2.2** |
| Item 3 | 3.3.3 | 3.3.3 | 3.3.3 | 3.3.3 | **3.3.3** |
| Item 4 | 4.4.4 | 4.4.4 | 4.4.4 | 4.4.4 | **4.4.4** |

然后用@符号引用文件：

# Bash/PowerShell通用
az devops wiki page update --wiki-name "你的Wiki名称" --path "/目标页面路径" --content @wiki-content.md

这种方法完全规避了转义字符的困扰，内容格式与最终Wiki页面显示一致，推荐优先使用。

内容的提问来源于stack exchange，提问作者Ryan Penfold