lark-markdown

Create, fetch, patch, overwrite, and diff Markdown files in Lark Drive via lark-cli.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/TrayMachi/dotfiles --skill lark-markdown-traymachi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-markdown
Source: https://github.com/TrayMachi/dotfiles/tree/main/agents/skills/lark-markdown
Command: npx skills add https://github.com/TrayMachi/dotfiles --skill lark-markdown-traymachi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lark-cli, and includes references (resource) components.

What problem does it solve? Managing native Markdown files stored in Lark (Feishu) Drive normally requires manual uploads and downloads through the web UI. This Skill lets you create, read, edit, patch, and compare Markdown files directly through lark-cli commands, with clear guidance on identity (user vs bot), permissions, and error handling. ## Core Features & Use Cases - Create and upload: Create native .md files in a Drive folder or Wiki node from inline content, a local file, or stdin. - Fetch and overwrite: Download remote Markdown content to local files, or overwrite remote files with new content and receive the new version number. - Patch and diff: Apply literal or regex-based local replacements without manual fetch-edit-upload cycles, and compare remote versions or remote-vs-local drafts with unified diff output. - Use Case: You drafted release notes locally and want to update the team's shared Markdown file in Lark Drive, then verify the changes — use markdown +overwrite followed by markdown +diff to confirm exactly what changed. ## Quick Start Ask the AI to create a Markdown file named notes.md in your Lark Drive with the content you provide, using the lark-markdown skill.

Frequently Asked Questions about lark-markdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Markdown file in Lark Drive from the command line?

Use lark-cli markdown +create with either --content (inline string, @file, or stdin) or --file pointing to a local .md file. The --name must explicitly include the .md suffix, and you can target a folder with --folder-token or a Wiki node with --wiki-token.

How to compare a remote Lark Markdown file with a local draft?

Run lark-cli markdown +diff with --file-token and --file pointing to your local .md file. Omitting --from-version compares the remote latest version against your local file; use --format pretty for colored unified diff output.

Does markdown +patch update the file atomically on the server?

No. The patch command downloads the full Markdown, applies the replacement locally, then overwrites the remote file. If someone edits the file between your download and upload, their change can be overwritten, so it is not a server-side atomic patch.

Why does markdown +create fail with permission or scope errors?

Failures with missing scope or permission denied usually relate to identity: bot identity hits app scope or folder ACL issues, while user identity hits user authorization or ACL issues. Diagnose the identity and permission cause first instead of switching identities and retrying blindly.

Can I use this skill to import Markdown as a Lark online docx document?

No. This skill only handles Markdown stored as plain files in Drive. To import Markdown as an online docx document, or to rename, move, delete, search, or manage permissions, use the lark-drive skill instead.