# baoyu-format-markdown

> Claude/Codex skill by [@jimliu](https://omgskills.com/library/jimliu/index.md) · 27k stars · Updated 2026-09-10

Formats plain text or markdown files with frontmatter, titles, summaries, headings, bold, lists, and code blocks. Use when user asks to "format markdown", "beautify article", "add formatting", or improve article layout. Outputs to {filename}-formatted.md.

Tags: agent-skills, claude-skills, codex-skills, openclaw-skills

## Install

```sh
git clone https://github.com/JimLiu/baoyu-skills /tmp/baoyu-skills && ln -s /tmp/baoyu-skills/skills/baoyu-format-markdown ~/.claude/skills/baoyu-format-markdown
```

## From README

Markdown Formatter Transforms plain text or markdown into well-structured, reader-friendly markdown. The goal is to help readers quickly grasp key points, highlights, and structure — without changing any original content. Core principle: Only adjust formatting and fix obvious typos. Never add, delete, or rewrite content. User Input Tools When this skill prompts the user, follow this tool-selection rule (priority order): Prefer built-in user-input tools exposed by the current agent runtime — e.g., AskUserQuestion, requestuserinput, clarify, askuser, or any equivalent. Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question. Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order.

## Links

- HTML page: https://omgskills.com/skills/jimliu/baoyu-skills/baoyu-format-markdown/
- GitHub: https://github.com/JimLiu/baoyu-skills
- Author: [@jimliu](https://omgskills.com/library/jimliu/index.md)

## More from this repo

- [baoyu-post-to-wechat](https://omgskills.com/skills/jimliu/baoyu-skills/baoyu-post-to-wechat/index.md) — Posts content to WeChat Official Account (微信公众号) via API or Chrome CDP.
   - [@jimliu](https://omgskills.com/library/jimliu/index.md) · 27k stars
- [baoyu-article-illustrator](https://omgskills.com/skills/jimliu/baoyu-skills/baoyu-article-illustrator/index.md) — Analyzes article structure, identifies positions requiring visual aids, generates illustrations with Type × Style ×...
   - [@jimliu](https://omgskills.com/library/jimliu/index.md) · 27k stars
- [baoyu-comic](https://omgskills.com/skills/jimliu/baoyu-skills/baoyu-comic/index.md) — Knowledge comic creator supporting multiple art styles and tones.
   - [@jimliu](https://omgskills.com/library/jimliu/index.md) · 27k stars