---
id: gh-lark-markdown
name: "lark-markdown"
url: https://skills.yangsir.net/skill/gh-lark-markdown
author: larksuite
domain: content-creation
tags: ["markdown", "lark", "cli", "document", "automation"]
install_count: 71000
rating: 4.70 (120 reviews)
github: https://github.com/larksuite/cli/tree/main/skills/lark-markdown
---

# lark-markdown

> 本 Skill 旨在帮助用户在飞书云空间中高效管理 Markdown 文件。通过命令行工具，用户可以轻松创建、上传、读取和覆盖更新 `.md` 文件，实现对原生 Markdown 内容的便捷操作，提升文档处理效率。

**Stats**: 71,000 installs · 4.7/5 (120 reviews)

## Before / After 对比

### 高效管理飞书Markdown文件

**Before**:

在飞书云空间中管理Markdown文件时，需要频繁手动通过网页界面上传、下载或编辑，操作繁琐且效率低下，尤其对于需要批量处理或集成到自动化流程的开发者而言，耗时且易出错。

**After**:

通过命令行工具，用户可以快速创建、上传、读取和更新Markdown文件，实现自动化脚本集成，大幅减少手动操作时间，提高文档管理效率和准确性，让内容创作和维护更加便捷。

| Metric | Before | After | Change |
|---|---|---|---|
| 处理时间 | 60分钟 | 10分钟 | -83% |

## Readme

# markdown (v1)

**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理**

## 快速决策

- 用户要**上传、创建一个原生 `.md` 文件**，使用 `lark-cli markdown +create`
- 用户要**读取 Drive 里某个 `.md` 文件内容**，使用 `lark-cli markdown +fetch`
- 用户要**覆盖更新 Drive 里某个 `.md` 文件内容**，使用 `lark-cli markdown +overwrite`
- 用户要把本地 Markdown **导入成在线新版文档（docx）**，不要用本 skill，改用 [`lark-drive`](../lark-drive/SKILL.md) 的 `lark-cli drive +import --type docx`
- 用户要对 Markdown 文件做**rename / move / delete / 搜索 / 权限 / 评论**等云空间操作，不要留在本 skill，切到 [`lark-drive`](../lark-drive/SKILL.md)

## 核心边界

- 本 skill 处理的是 **Drive 中作为普通文件存储的 Markdown**，不是 docx 文档
- `--name` 和本地 `--file` 文件名都必须显式带 `.md` 后缀；不满足时 shortcut 会直接报错
- `--content` 支持：
  - 直接传字符串
  - `@file` 从本地文件读取内容
  - `-` 从 stdin 读取内容
- `--file` 只接受本地 `.md` 文件路径

## Shortcuts（推荐优先使用）

Shortcut 是对常用操作的高级封装（`lark-cli markdown +<verb> [flags]`）。有 Shortcut 的操作优先使用。

| Shortcut | 说明 |
|----------|------|
| [`+create`](references/lark-markdown-create.md) | Create a Markdown file in Drive |
| [`+fetch`](references/lark-markdown-fetch.md) | Fetch a Markdown file from Drive |
| [`+overwrite`](references/lark-markdown-overwrite.md) | Overwrite an existing Markdown file in Drive |

## 参考

- [lark-shared](../lark-shared/SKILL.md) — 认证和全局参数
- [lark-drive](../lark-drive/SKILL.md) — Drive 文件管理、导入 docx、move/delete/search 等


---
*Source: https://skills.yangsir.net/skill/gh-lark-markdown*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-lark-markdown/markdown*