소스 정보
- 저장소
- microwind/ai-skills
- 최근 소스 활동
- 2026년 3월 26일 14:58
- 감지된 SKILL.md 언어
- 중국어
- 스타
- 68
- 포크
- 17
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
메뉴
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/microwind/ai-skills --skill markdown명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SOC 직업 분류 기준
SKILL.md 표시 중
| name | Markdown生成器 |
| description | 当生成Markdown文档、转换格式、创建技术文档、编写README文件或自动化文档生成时，提供完整的Markdown处理和生成解决方案。 |
| license | MIT |
Markdown是一种轻量级标记语言，广泛用于技术文档、README文件、博客文章和项目文档。Markdown生成器能够自动化创建结构化的Markdown文档，支持格式转换、模板生成和批量处理。
核心原则: 简洁明了、结构清晰、易于维护、自动化生成。
始终:
触发短语:
行内代码、代码块结构:
- 项目标题和简介
- 安装说明
- 使用方法
- API文档
- 贡献指南
- 许可证信息
特点:
- 简洁明了
- 突出重点
- 易于理解
- 快速上手
结构:
- API概述
- 认证方式
- 端点列表
- 请求/响应格式
- 错误处理
- 示例代码
特点:
- 结构清晰
- 示例丰富
- 错误说明
- 测试用例
结构:
- 吸引人的标题
- 问题背景
- 解决方案
- 实现细节
- 总结展望
特点:
- 内容深入
- 代码示例
- 图文并茂
- 互动性强
import os
import re
from datetime import datetime
from typing import List, Dict, Optional, Union, Any
from dataclasses import dataclass
from enum import Enum
from pathlib import Path
import json
import yaml
class MarkdownElementType(Enum):
HEADING = "heading"
PARAGRAPH = "paragraph"
LIST = "list"
CODE_BLOCK = "code_block"
INLINE_CODE = "inline_code"
LINK = "link"
IMAGE = "image"
TABLE = "table"
BLOCKQUOTE = "blockquote"
HORIZONTAL_RULE = "horizontal_rule"
TASK_LIST = "task_list"
@dataclass
class MarkdownElement:
"""Markdown元素"""
type: MarkdownElementType
content: str
level: Optional[int] = None # 用于标题级别
attributes: Optional[Dict[str, Any]] = None
class MarkdownGenerator:
"""Markdown生成器"""
():
.elements: [MarkdownElement] = []
.metadata: [, ] = {}
.toc_enabled =
.toc_max_level =
() -> :
level < level > :
ValueError()
element = MarkdownElement(
=MarkdownElementType.HEADING,
content=text,
level=level
)
.elements.append(element)
() -> :
element = MarkdownElement(
=MarkdownElementType.PARAGRAPH,
content=text
)
.elements.append(element)
() -> :
prefix = ordered
content = .join( item items)
element = MarkdownElement(
=MarkdownElementType.LIST,
content=content,
attributes={: ordered}
)
.elements.append(element)
() -> :
content =
caption:
content +=
element = MarkdownElement(
=MarkdownElementType.CODE_BLOCK,
content=content,
attributes={: language, : caption}
)
.elements.append(element)
() -> :
element = MarkdownElement(
=MarkdownElementType.INLINE_CODE,
content=
)
.elements.append(element)
() -> :
title:
content =
:
content =
element = MarkdownElement(
=MarkdownElementType.LINK,
content=content,
attributes={: url, : title}
)
.elements.append(element)
() -> :
title:
content =
:
content =
element = MarkdownElement(
=MarkdownElementType.IMAGE,
content=content,
attributes={: url, : title}
)
.elements.append(element)
() -> :
content = + .join(headers) +
content += + .join([] * (headers)) +
row rows:
content += + .join(row) +
element = MarkdownElement(
=MarkdownElementType.TABLE,
content=content.strip(),
attributes={: headers, : rows}
)
.elements.append(element)
() -> :
lines = text.split()
quoted_lines = [ line lines]
content = .join(quoted_lines)
element = MarkdownElement(
=MarkdownElementType.BLOCKQUOTE,
content=content
)
.elements.append(element)
() -> :
element = MarkdownElement(
=MarkdownElementType.HORIZONTAL_RULE,
content =
)
.elements.append(element)
() -> :
items = []
task tasks:
text = task[]
checked = task.get(, )
checkbox = checked
items.append()
content = .join(items)
element = MarkdownElement(
=MarkdownElementType.TASK_LIST,
content=content,
attributes={: tasks}
)
.elements.append(element)
() -> :
.metadata[key] = value
() -> :
.toc_enabled:
headings = [
element element .elements
element. == MarkdownElementType.HEADING
element.level <= .toc_max_level
]
headings:
toc_lines = []
heading headings:
indent = * (heading.level - )
anchor = ._generate_anchor(heading.content)
toc_lines.append()
.join(toc_lines) +
() -> :
anchor = re.sub(, , text.lower())
anchor = re.sub(, , anchor)
anchor.strip()
() -> :
lines = []
.metadata:
lines.append()
lines.append()
key, value .metadata.items():
(value, (, )):
lines.append()
:
lines.append()
lines.append()
lines.append()
.toc_enabled:
toc = .generate_toc()
toc:
lines.append(toc)
lines.append()
element .elements:
lines.append(element.content)
lines.append()
.join(lines).strip()
():
content = .render()
(file_path, , encoding=) f:
f.write(content)
() -> :
.elements.clear()
.metadata.clear()
:
() -> MarkdownGenerator:
md = MarkdownGenerator()
md.add_metadata(, project_info.get(, ))
md.add_metadata(, project_info.get(, ))
md.add_metadata(, project_info.get(, ))
md.add_heading(project_info.get(, ), )
description = project_info.get(, )
badges = project_info.get(, [])
badges:
badge_line = .join(badges)
md.add_paragraph(badge_line)
md.add_paragraph(description)
md.add_heading(, )
toc_items = [
,
,
,
,
]
md.add_list(toc_items)
md.add_heading(, )
install_methods = project_info.get(, {})
install_methods:
method, instructions install_methods.items():
md.add_heading(method, )
md.add_code_block(instructions, )
:
md.add_code_block(, )
md.add_heading(, )
usage_examples = project_info.get(, [])
usage_examples:
i, example (usage_examples, ):
md.add_heading(, )
md.add_code_block(example.get(, ), example.get(, ))
example.get():
md.add_paragraph(example[])
:
md.add_code_block(, )
md.add_heading(, )
api_info = project_info.get(, {})
api_info:
endpoint, details api_info.items():
md.add_heading(endpoint, )
md.add_paragraph(details.get(, ))
details.get():
md.add_heading(, )
param_headers = [, , , ]
param_rows = []
param details[]:
param_rows.append([
param[],
param[],
param.get(, ) ,
param[]
])
md.add_table(param_headers, param_rows)
details.get():
md.add_heading(, )
md.add_code_block(details[], details.get(, ))
md.add_heading(, )
contribution_info = project_info.get(, {})
contribution_info:
md.add_paragraph(contribution_info.get(, ))
contribution_info.get():
md.add_heading(, )
md.add_list(contribution_info[])
:
md.add_paragraph()
md.add_list([
,
,
,
,
])
md.add_heading(, )
license_info = project_info.get(, )
md.add_paragraph()
md
() -> MarkdownGenerator:
md = MarkdownGenerator()
md.add_metadata(, )
md.add_metadata(, datetime.now().isoformat())
md.add_heading(, )
md.add_heading(, )
md.add_paragraph(api_info.get(, ))
base_info = api_info.get(, {})
base_info:
md.add_heading(, )
info_items = []
base_info.get():
info_items.append()
base_info.get():
info_items.append()
base_info.get():
info_items.append()
md.add_paragraph(.join(info_items))
auth_info = api_info.get(, {})
auth_info:
md.add_heading(, )
md.add_paragraph(auth_info.get(, ))
auth_info.get():
md.add_heading(, )
md.add_code_block(auth_info.get(, ), )
endpoints = api_info.get(, [])
endpoints:
md.add_heading(, )
headers = [, , ]
rows = []
endpoint endpoints:
rows.append([
endpoint.get(, ),
endpoint.get(, ),
endpoint.get(, )
])
md.add_table(headers, rows)
endpoint endpoints:
md.add_heading(, )
endpoint.get():
md.add_paragraph(endpoint[])
endpoint.get():
md.add_heading(, )
param_headers = [, , , , ]
param_rows = []
param endpoint[]:
param_rows.append([
param[],
param.get(, ),
param[],
param.get(, ) ,
param[]
])
md.add_table(param_headers, param_rows)
endpoint.get():
md.add_heading(, )
md.add_code_block(
endpoint[],
endpoint.get(, )
)
endpoint.get():
md.add_heading(, )
response = endpoint[]
response.get():
md.add_paragraph(response[])
response.get():
md.add_code_block(
response[],
response.get(, )
)
endpoint.get():
md.add_heading(, )
error_headers = [, , ]
error_rows = []
error endpoint[]:
error_rows.append([
(error[]),
error[],
error[]
])
md.add_table(error_headers, error_rows)
md
() -> MarkdownGenerator:
md = MarkdownGenerator()
md.add_metadata(, post_info.get(, ))
md.add_metadata(, post_info.get(, datetime.now().strftime()))
md.add_metadata(, post_info.get(, ))
md.add_metadata(, post_info.get(, []))
md.add_metadata(, post_info.get(, ))
md.add_heading(post_info.get(, ), )
meta_info = []
post_info.get():
meta_info.append()
post_info.get():
meta_info.append()
post_info.get():
meta_info.append()
post_info.get():
tags = .join(post_info[])
meta_info.append()
meta_info:
md.add_paragraph(.join(meta_info))
post_info.get():
md.add_heading(, )
md.add_paragraph(post_info[])
md.add_horizontal_rule()
content_sections = post_info.get(, [])
section content_sections:
section.get():
md.add_heading(section[], section.get(, ))
section.get():
md.add_paragraph(section[])
section.get():
md.add_code_block(
section[],
section.get(, )
)
section.get():
img = section[]
md.add_image(
img.get(, ),
img.get(, ),
img.get(, )
)
section.get():
md.add_list(section[], section.get(, ))
post_info.get():
md.add_heading(, )
md.add_paragraph(post_info[])
md
:
() -> :
:
markdown
extensions = [, , , ]
markdown.markdown(markdown_content, extensions=extensions)
ImportError:
():
:
weasyprint
html_content = MarkdownConverter.to_html(markdown_content)
css_style =
html_doc =
weasyprint.HTML(string=html_doc).write_pdf(output_path)
ImportError:
()
():
()
( * )
project_info = {
: ,
: ,
: ,
: [
,
],
: {
: ,
:
},
: [
{
: ,
: ,
:
}
],
:
}
readme_md = DocumentTemplate.create_readme_template(project_info)
readme_md.save_to_file()
()
api_info = {
: ,
: {
: ,
: ,
:
},
: {
: ,
: ,
:
},
: [
{
: ,
: ,
: ,
: [
{
: ,
: ,
: ,
: ,
:
}
],
: {
: ,
:
}
}
]
}
api_md = DocumentTemplate.create_api_documentation(api_info)
api_md.save_to_file()
()
blog_info = {
: ,
: ,
: ,
: ,
: [, , ],
: ,
: [
{
: ,
: ,
:
},
{
: ,
: ,
: ,
: ,
:
}
],
:
}
blog_md = DocumentTemplate.create_blog_post(blog_info)
blog_md.save_to_file()
()
html_content = MarkdownConverter.to_html(readme_md.render())
(, , encoding=) f:
f.write(html_content)
()
()
__name__ == :
main()
class MarkdownAnalyzer:
"""Markdown分析器"""
def __init__(self):
self.element_patterns = {
'heading': re.compile(r'^(#{1,6})\s+(.+)$'),
'list': re.compile(r'^(\s*)([-*+]|\d+\.)\s+(.+)$'),
'code_block': re.compile(r'^```(\w*)\n(.*?)\n```$', re.MULTILINE | re.DOTALL),
'image': re.compile(r'!\[([^\]]*)\]\(([^)]+)\)'),
'link': re.compile(r'\[([^\]]+)\]\(([^)]+)\)'),
'table': re.compile(r'^\|(.+)\|\n\|[-\s\|]+\|\n((?:\|.+\|\n?)*)', re.MULTILINE)
}
def analyze(self, markdown_content: str) -> Dict[str, Any]:
"""分析Markdown内容"""
lines = markdown_content.split('\n')
analysis = {
'total_lines': len(lines),
'total_characters': len(markdown_content),
'elements': {
'headings': [],
'lists': [],
'code_blocks': [],
'images': [],
'links': [],
'tables': []
},
: {},
: []
}
i, line (lines, ):
element_info = ._analyze_line(line, i)
element_info:
analysis[].append(element_info)
element_type = element_info[]
element_type analysis[]:
analysis[][element_type].append(element_info)
analysis[] = ._calculate_statistics(analysis[])
analysis
() -> [[, ]]:
line = line.rstrip()
heading_match = .element_patterns[].(line)
heading_match:
level = (heading_match.group())
text = heading_match.group()
{
: ,
: line_number,
: level,
: text,
: ._generate_anchor(text)
}
list_match = .element_patterns[].(line)
list_match:
indent = (list_match.group())
marker = list_match.group()
text = list_match.group()
ordered = marker.endswith()
{
: ,
: line_number,
: indent,
: ordered,
: text
}
line line.strip():
{
: ,
: line_number,
: line
}
() -> [, ]:
stats = {}
headings = elements[]
stats[] = {
: (headings),
: {}
}
heading headings:
level = heading[]
stats[][][level] = stats[][].get(level, ) +
lists = elements[]
stats[] = {
: (lists),
: ( lst lists lst[]),
: ( lst lists lst[])
}
element_type [, , , ]:
stats[element_type] = (elements[element_type])
stats
() -> :
re
anchor = re.sub(, , text.lower())
anchor = re.sub(, , anchor)
anchor.strip()
() -> :
analysis = .analyze(markdown_content)
headings = analysis[][]
toc_lines = []
heading headings:
heading[] <= max_level:
indent = * (heading[] - )
toc_lines.append()
.join(toc_lines)
():
analyzer = MarkdownAnalyzer()
()
__name__ == :
main()