document-formatter

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Document Formatter Skill

Document Formatter Skill

ドキュメントの体裁を整え、美しく読みやすいフォーマットに変換するスキルです。
This is a skill that organizes document structure and converts it into a beautiful, easy-to-read format.

概要

Overview

このスキルを使用すると、乱れたMarkdownドキュメント、書きかけのメモ、構造化されていないテキストを、プロフェッショナルで読みやすいドキュメントに自動的に整形できます。
This skill automatically formats messy Markdown documents, half-written notes, and unstructured text into professional, easy-to-read documents.

主な機能

Key Features

  • Markdownフォーマット整形: 見出し、リスト、コードブロックの統一
  • 目次の自動生成: 見出しから階層的な目次を作成
  • スタイルガイド適用: 一貫したライティングスタイル
  • 美しいHTML変換: GitHub風やプロフェッショナルなデザイン
  • コードハイライト: シンタックスハイライト付きコードブロック
  • テーブル整形: 綺麗に整列されたテーブル
  • リンク検証: 壊れたリンクの検出と修正提案
  • 画像最適化: altテキストの追加、サイズ指定
  • 印刷最適化: PDF出力に適したレイアウト
  • Markdown Formatting: Standardize headings, lists, and code blocks
  • Automatic Table of Contents Generation: Create hierarchical TOC from headings
  • Style Guide Application: Maintain consistent writing style
  • Beautiful HTML Conversion: GitHub-style or professional designs
  • Code Highlighting: Code blocks with syntax highlighting
  • Table Formatting: Neatly aligned tables
  • Link Validation: Detect broken links and suggest fixes
  • Image Optimization: Add alt text, specify image sizes
  • Print Optimization: Layout optimized for PDF output

使用方法

Usage

基本的な使い方

Basic Usage

以下のMarkdownドキュメントを整形してください:

[乱れたMarkdownを貼り付け]
Please format the following Markdown document:

[Paste messy Markdown here]

目次の追加

Add Table of Contents

このドキュメントに目次を追加してください:
位置: 冒頭
スタイル: 番号付き
深さ: 3階層まで
Please add a table of contents to this document:
Position: Top
Style: Numbered
Depth: Up to 3 levels

HTML変換

HTML Conversion

このMarkdownを美しいHTMLに変換:
スタイル: GitHub風
コードハイライト: 有効
印刷対応: はい
Convert this Markdown to beautiful HTML:
Style: GitHub-style
Code Highlighting: Enabled
Print Support: Yes

スタイルガイド適用

Apply Style Guide

このドキュメントをMicrosoft Style Guideに従って整形:
- 見出しは文頭のみ大文字
- リストは並列構造
- コードは明示的に
Format this document according to the Microsoft Style Guide:
- Headings use sentence case (only first word capitalized)
- Lists use parallel structure
- Code is explicitly marked

整形機能

Formatting Features

1. 見出しの整形

1. Heading Formatting

修正内容:
  • 階層構造の修正(H1 → H2 → H3の順序)
  • 見出しの前後に適切な空行
  • 見出しレベルのスキップを防止
  • 一貫した見出しスタイル
整形前:
markdown
undefined
Fixes Applied:
  • Correct hierarchical structure (H1 → H2 → H3 order)
  • Add proper blank lines before and after headings
  • Prevent skipping heading levels
  • Maintain consistent heading style
Before Formatting:
markdown
undefined

はじめに

Introduction

プロジェクト名

Project Name

機能

Features

詳細

Details


**整形後**:
```markdown

**After Formatting**:
```markdown

プロジェクト名

Project Name

はじめに

Introduction

機能

Features

詳細

Details

undefined
undefined

2. リストの整形

2. List Formatting

修正内容:
  • インデントの統一(2スペースまたは4スペース)
  • マーカーの統一(
    -
    ,
    *
    ,
    +
    のいずれか)
  • ネストレベルの修正
  • リスト項目の並列構造
整形前:
markdown
* 項目1
  - サブ項目1-1
    * サブサブ項目1-1-1
-項目2
   + サブ項目2-1
整形後:
markdown
- 項目1
  - サブ項目1-1
    - サブサブ項目1-1-1
- 項目2
  - サブ項目2-1
Fixes Applied:
  • Standardize indentation (2 or 4 spaces)
  • Unify list markers (choose one of
    -
    ,
    *
    ,
    +
    )
  • Correct nesting levels
  • Ensure parallel structure for list items
Before Formatting:
markdown
* Item 1
  - Sub-item 1-1
    * Sub-sub-item 1-1-1
-Item 2
   + Sub-item 2-1
After Formatting:
markdown
- Item 1
  - Sub-item 1-1
    - Sub-sub-item 1-1-1
- Item 2
  - Sub-item 2-1

3. コードブロックの整形

3. Code Block Formatting

修正内容:
  • 言語指定の追加
  • インデントの統一
  • コードのフォーマット(Prettier、Black等)
  • シンタックスハイライト対応
整形前:
undefined
function hello(){ console.log("Hello") }
undefined
整形後:
markdown
​```javascript
function hello() {
  console.log("Hello");
}
​```
Fixes Applied:
  • Add language specification
  • Standardize indentation
  • Format code (using Prettier, Black, etc.)
  • Support syntax highlighting
Before Formatting:
undefined
function hello(){ console.log("Hello") }
undefined
After Formatting:
markdown
​```javascript
function hello() {
  console.log("Hello");
}
​```

4. テーブルの整形

4. Table Formatting

修正内容:
  • 列の整列
  • ヘッダーとボディの分離線
  • セル内の余白統一
  • Markdown表の正しい構文
整形前:
markdown
| 名前 | 年齢|職業|
|---|---|---|
|田中|30|エンジニア|
|佐藤|25|デザイナー|
整形後:
markdown
| 名前 | 年齢 | 職業         |
|------|------|--------------|
| 田中 | 30   | エンジニア   |
| 佐藤 | 25   | デザイナー   |
Fixes Applied:
  • Align columns
  • Separate header and body with proper lines
  • Standardize cell padding
  • Ensure correct Markdown table syntax
Before Formatting:
markdown
| Name | Age|Occupation|
|---|---|---|
|Tanaka|30|Engineer|
|Sato|25|Designer|
After Formatting:
markdown
| Name | Age | Occupation |
|------|------|--------------|
| Tanaka | 30   | Engineer   |
| Sato | 25   | Designer   |

5. リンクと画像の整形

5. Link and Image Formatting

修正内容:
  • URLの正規化
  • リンクテキストの改善
  • 画像のaltテキスト追加
  • 相対パスの修正
整形前:
markdown
[こちら](http://example.com)
![](image.png)
整形後:
markdown
[Example サイト](https://example.com)
![プロジェクトのロゴ](image.png)
Fixes Applied:
  • Normalize URLs
  • Improve link text
  • Add alt text to images
  • Fix relative paths
Before Formatting:
markdown
[Click here](http://example.com)
![](image.png)
After Formatting:
markdown
[Example Site](https://example.com)
![Project Logo](image.png)

6. 引用の整形

6. Blockquote Formatting

修正内容:
  • 引用マーカーの統一
  • ネストされた引用の整形
  • 出典の明記
整形前:
markdown
>これは引用です
> >ネストされた引用
整形後:
markdown
> これは引用です
>
> > ネストされた引用
Fixes Applied:
  • Unify blockquote markers
  • Format nested blockquotes
  • Clarify source attribution
Before Formatting:
markdown
>This is a quote
> >Nested quote
After Formatting:
markdown
> This is a quote
>
> > Nested quote

目次生成

Table of Contents Generation

自動目次生成

Automatic TOC Generation

見出しから自動的に目次を生成します。
オプション:
  • 位置: 冒頭、末尾、カスタム位置
  • 深さ: H2まで、H3まで、H4まで
  • スタイル: 番号付き、箇条書き
  • アンカーリンク: 有効/無効
生成例:
markdown
undefined
Automatically generate a table of contents from headings.
Options:
  • Position: Top, Bottom, Custom Position
  • Depth: Up to H2, Up to H3, Up to H4
  • Style: Numbered, Bulleted
  • Anchor Links: Enabled/Disabled
Example Output:
markdown
undefined

ドキュメントタイトル

Document Title

目次

Table of Contents

はじめに

Introduction

[内容...]
undefined
[Content...]
undefined

カスタム目次

Custom TOC

目次を生成:
- H2とH3のみ含める
- 「はじめに」「謝辞」は除外
- 番号付きリスト
- クリック可能なアンカーリンク
Generate table of contents:
- Include only H2 and H3
- Exclude "Introduction" and "Acknowledgements"
- Numbered list
- Clickable anchor links

スタイルガイド

Style Guides

1. Google Developer Documentation Style Guide

1. Google Developer Documentation Style Guide

特徴:
  • 簡潔で明確な文章
  • アクティブボイス優先
  • 第二人称(you)の使用
  • 技術用語の一貫性
適用例:
整形前: "The button can be clicked by users"
整形後: "Click the button"

整形前: "It is recommended that..."
整形後: "We recommend..."
Features:
  • Concise and clear writing
  • Prefer active voice
  • Use second person (you)
  • Consistent technical terminology
Application Example:
Before: "The button can be clicked by users"
After: "Click the button"

Before: "It is recommended that..."
After: "We recommend..."

2. Microsoft Writing Style Guide

2. Microsoft Writing Style Guide

特徴:
  • 見出しは文頭のみ大文字(Sentence case)
  • 並列構造のリスト
  • 手順は番号付きリスト
  • 明確な指示語
適用例:
整形前: "How To Install The Software"
整形後: "How to install the software"

整形前:
- Installing
- Configuration
- To run

整形後:
- Install the software
- Configure the settings
- Run the application
Features:
  • Headings use sentence case
  • Lists use parallel structure
  • Procedures use numbered lists
  • Clear instructional language
Application Example:
Before: "How To Install The Software"
After: "How to install the software"

Before:
- Installing
- Configuration
- To run

After:
- Install the software
- Configure the settings
- Run the application

3. AP Stylebook

3. AP Stylebook

特徴:
  • ニュース・ブログ記事向け
  • 日付形式の統一
  • 数字の表記ルール
  • 略語の明記
Features:
  • Suitable for news and blog articles
  • Standardized date formats
  • Rules for number notation
  • Explicit abbreviation usage

4. APA Style(学術論文)

4. APA Style (Academic Writing)

特徴:
  • フォーマルな文体
  • 引用の標準化
  • 参考文献リスト
  • セクション構造
Features:
  • Formal writing style
  • Standardized citations
  • Reference lists
  • Structured section layout

5. カスタムスタイル

5. Custom Style

独自のスタイルルールを定義できます:
カスタムスタイルで整形:
- 見出し: すべて大文字
- リスト: 常に番号付き
- コードブロック: 必ず言語指定
- リンク: 常に新しいタブで開く指定
Define your own style rules:
Format with custom style:
- Headings: All uppercase
- Lists: Always numbered
- Code blocks: Must include language specification
- Links: Always set to open in new tab

HTML変換

HTML Conversion

GitHub風スタイル

GitHub-Style

特徴:
  • GitHub Markdownと同じ見た目
  • シンタックスハイライト
  • テーブルスタイル
  • レスポンシブ対応
出力例:
html
<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" href="github-markdown.css">
  <style>
    .markdown-body {
      max-width: 980px;
      margin: 0 auto;
      padding: 45px;
    }
  </style>
</head>
<body class="markdown-body">
  [変換されたHTML]
</body>
</html>
Features:
  • Same appearance as GitHub Markdown
  • Syntax highlighting
  • Table styling
  • Responsive design
Output Example:
html
<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" href="github-markdown.css">
  <style>
    .markdown-body {
      max-width: 980px;
      margin: 0 auto;
      padding: 45px;
    }
  </style>
</head>
<body class="markdown-body">
  [Converted HTML]
</body>
</html>

プロフェッショナルスタイル

Professional Style

特徴:
  • ビジネスドキュメント向け
  • 印刷最適化
  • ページ番号、ヘッダー/フッター
  • 目次、索引
Features:
  • Suitable for business documents
  • Print-optimized
  • Page numbers, headers/footers
  • Table of contents, index

技術文書スタイル

Technical Documentation Style

特徴:
  • API仕様書、マニュアル向け
  • サイドバーナビゲーション
  • コード例のコピーボタン
  • 検索機能
Features:
  • Suitable for API specifications, manuals
  • Sidebar navigation
  • Copy buttons for code examples
  • Search functionality

ブログ記事スタイル

Blog Article Style

特徴:
  • 読みやすいタイポグラフィ
  • アイキャッチ画像
  • SNSシェアボタン
  • コメント欄
Features:
  • Easy-to-read typography
  • Featured images
  • SNS share buttons
  • Comment section

コードハイライト

Code Highlighting

サポート言語

Supported Languages

以下の言語でシンタックスハイライトを適用:
  • C/C++: GCC、MSVC、Clang
  • C#: .NET、Unity
  • Python: Python 3.x
  • JavaScript/TypeScript: Node.js、ブラウザ
  • Java: Java 8+
  • Go: Go 1.x
  • Rust: Rust 2021
  • SQL: PostgreSQL、MySQL、SQL Server
  • Shell: Bash、PowerShell
  • Markup: HTML、XML、JSON、YAML
  • その他50以上の言語
Apply syntax highlighting for the following languages:
  • C/C++: GCC, MSVC, Clang
  • C#: .NET, Unity
  • Python: Python 3.x
  • JavaScript/TypeScript: Node.js, Browser
  • Java: Java 8+
  • Go: Go 1.x
  • Rust: Rust 2021
  • SQL: PostgreSQL, MySQL, SQL Server
  • Shell: Bash, PowerShell
  • Markup: HTML, XML, JSON, YAML
  • And over 50 other languages

テーマ

Themes

コードハイライトテーマ:
- github (デフォルト)
- monokai
- solarized-light
- solarized-dark
- dracula
- nord
- atom-one-dark
- vs-code
Code Highlighting Themes:
- github (default)
- monokai
- solarized-light
- solarized-dark
- dracula
- nord
- atom-one-dark
- vs-code

機能

Features

  • 行番号: 表示/非表示
  • ハイライト行: 特定の行を強調
  • 差分表示: 追加/削除行の表示
  • コピーボタン: ワンクリックでコピー
:
markdown
​```javascript {2-3} showLineNumbers
function calculate(a, b) {
  const sum = a + b;  // この行をハイライト
  return sum;         // この行もハイライト
}
​```
  • Line Numbers: Show/Hide
  • Highlight Lines: Emphasize specific lines
  • Diff Display: Show added/removed lines
  • Copy Button: One-click copy
Example:
markdown
​```javascript {2-3} showLineNumbers
function calculate(a, b) {
  const sum = a + b;  // Highlight this line
  return sum;         // Highlight this line too
}
​```

テーブルフォーマット

Table Formatting

自動整列

Automatic Alignment

列幅を自動計算して整列:
整形前:
markdown
|Name|Age|Occupation|
|-|-|-|
|John|30|Engineer|
|Jane|25|Designer|
整形後:
markdown
| Name | Age | Occupation |
|------|-----|------------|
| John | 30  | Engineer   |
| Jane | 25  | Designer   |
Automatically calculate column widths for alignment:
Before Formatting:
markdown
|Name|Age|Occupation|
|-|-|-|
|John|30|Engineer|
|Jane|25|Designer|
After Formatting:
markdown
| Name | Age | Occupation |
|------|-----|------------|
| John | 30  | Engineer   |
| Jane | 25  | Designer   |

セルの配置

Cell Alignment

markdown
| Left | Center | Right |
|:-----|:------:|------:|
|| 中央   ||
markdown
| Left | Center | Right |
|:-----|:------:|------:|
| Left | Center | Right |

複雑なテーブル

Complex Tables

  • セル結合の提案
  • HTMLテーブルへの変換
  • CSVからの変換
  • Suggest cell merging
  • Convert to HTML tables
  • Convert from CSV

リンク検証

Link Validation

壊れたリンクの検出

Broken Link Detection

リンクチェック:
✓ [GitHub](https://github.com) - OK (200)
✗ [Broken](https://example.com/404) - Not Found (404)
? [Internal](#section) - セクションが存在しません
Link Check Results:
✓ [GitHub](https://github.com) - OK (200)
✗ [Broken](https://example.com/404) - Not Found (404)
? [Internal](#section) - Section does not exist

修正提案

Fix Suggestions

修正提案:
- [こちら] → より説明的なリンクテキストに変更
- http:// → https:// に変更
- 相対パス → 絶対パスに変更(オプション)
Fix Suggestions:
- [Click here] → Change to more descriptive link text
- http:// → Change to https://
- Relative path → Change to absolute path (optional)

画像最適化

Image Optimization

altテキストの追加

Add Alt Text

markdown
整形前: ![](logo.png)
整形後: ![会社ロゴ](logo.png)
markdown
Before: ![](logo.png)
After: ![Company Logo](logo.png)

サイズ指定

Specify Size

markdown
整形前: ![Logo](logo.png)
整形後: ![Logo](logo.png){width=300}

HTML:
<img src="logo.png" alt="Logo" width="300">
markdown
Before: ![Logo](logo.png)
After: ![Logo](logo.png){width=300}

HTML:
<img src="logo.png" alt="Logo" width="300">

画像の配置

Image Alignment

markdown
中央揃え:
<p align="center">
  <img src="logo.png" alt="Logo">
</p>
markdown
Center Alignment:
<p align="center">
  <img src="logo.png" alt="Logo">
</p>

特殊機能

Special Features

1. フロントマター追加

1. Add Front Matter

YAML形式のメタデータを追加:
yaml
---
title: "ドキュメントタイトル"
author: "作成者名"
date: 2024-06-15
tags: [markdown, documentation]
---
Add YAML metadata:
yaml
---
title: "Document Title"
author: "Author Name"
date: 2024-06-15
tags: [markdown, documentation]
---

ドキュメント本文

Document Body

undefined
undefined

2. 脚注の整形

2. Footnote Formatting

markdown
本文[^1]

[^1]: 脚注の内容
markdown
Body text[^1]

[^1]: Footnote content

3. 定義リスト

3. Definition Lists

markdown
Term 1
: Definition 1

Term 2
: Definition 2a
: Definition 2b
markdown
Term 1
: Definition 1

Term 2
: Definition 2a
: Definition 2b

4. タスクリスト

4. Task Lists

markdown
- [x] 完了したタスク
- [ ] 未完了のタスク
- [ ] 別の未完了タスク
markdown
- [x] Completed task
- [ ] Incomplete task
- [ ] Another incomplete task

5. 数式(LaTeX)

5. Math Formulas (LaTeX)

markdown
インライン数式: $E = mc^2$

ブロック数式:
$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$
markdown
Inline Formula: $E = mc^2$

Block Formula:
$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$

整形ルール

Formatting Rules

改行と空行

Line Breaks and Blank Lines

ルール:
- 見出しの前後: 2行の空行
- 段落間: 1行の空行
- リストの前後: 1行の空行
- コードブロックの前後: 1行の空行
- テーブルの前後: 1行の空行
Rules:
- Before/After headings: 2 blank lines
- Between paragraphs: 1 blank line
- Before/After lists: 1 blank line
- Before/After code blocks: 1 blank line
- Before/After tables: 1 blank line

文字幅

Line Length

推奨設定:
- 1行の最大文字数: 80文字(コード)、100文字(文章)
- 自動折り返し: 有効
- ソフトラップ: 単語境界で折り返し
Recommended Settings:
- Maximum line length: 80 characters (code), 100 characters (text)
- Auto-wrap: Enabled
- Soft wrap: Wrap at word boundaries

インデント

Indentation

設定:
- リスト: 2スペースまたは4スペース
- コードブロック: 言語の規約に従う
- 引用: 自動インデント
Settings:
- Lists: 2 or 4 spaces
- Code blocks: Follow language conventions
- Blockquotes: Auto-indent

出力形式

Output Formats

1. Markdown

1. Markdown

整形されたMarkdownファイル:
  • 標準Markdown
  • GitHub Flavored Markdown (GFM)
  • CommonMark
  • Markdown Extra
Formatted Markdown files:
  • Standard Markdown
  • GitHub Flavored Markdown (GFM)
  • CommonMark
  • Markdown Extra

2. HTML

2. HTML

HTML変換オプション:
- スタンドアロン(CSS埋め込み)
- 外部CSSリンク
- インライン CSS
- JavaScript含む/含まない
HTML Conversion Options:
- Standalone (embedded CSS)
- External CSS link
- Inline CSS
- Include/Exclude JavaScript

3. PDF

3. PDF

PDF生成:
- ページサイズ: A4、Letter、カスタム
- マージン: 標準、狭い、広い
- ヘッダー/フッター: カスタマイズ可能
- ページ番号: 位置、形式
- 目次: 自動生成
- しおり: 見出しから生成
PDF Generation:
- Page Size: A4, Letter, Custom
- Margins: Standard, Narrow, Wide
- Headers/Footers: Customizable
- Page Numbers: Position, Format
- Table of Contents: Auto-generated
- Bookmarks: Generated from headings

4. Word (DOCX)

4. Word (DOCX)

Pandoc形式でWord文書に変換
Convert to Word documents using Pandoc format

5. 他の形式

5. Other Formats

  • reStructuredText
  • AsciiDoc
  • LaTeX
  • MediaWiki
  • reStructuredText
  • AsciiDoc
  • LaTeX
  • MediaWiki

カスタマイズ

Customization

整形ルールのカスタマイズ

Customize Formatting Rules

yaml
undefined
yaml
undefined

.markdownlint.yaml

.markdownlint.yaml

MD001: true # 見出しレベルのインクリメント MD003: style: atx # 見出しスタイル MD004: style: dash # リストマーカー MD013: line_length: 100 # 行の最大長 MD024: false # 重複する見出しを許可
undefined
MD001: true # Heading level increment MD003: style: atx # Heading style MD004: style: dash # List marker MD013: line_length: 100 # Maximum line length MD024: false # Allow duplicate headings
undefined

テンプレート

Templates

独自のHTMLテンプレートを使用:
html
<!DOCTYPE html>
<html>
<head>
  <title>{{title}}</title>
  <style>
    /* カスタムCSS */
  </style>
</head>
<body>
  {{content}}
</body>
</html>
Use custom HTML templates:
html
<!DOCTYPE html>
<html>
<head>
  <title>{{title}}</title>
  <style>
    /* Custom CSS */
  </style>
</head>
<body>
  {{content}}
</body>
</html>

ユースケース

Use Cases

1. 既存ドキュメントの整形

1. Format Existing Documents

この古いREADMEを最新のベストプラクティスに従って整形:
- 目次を追加
- コードブロックに言語指定
- テーブルを整列
- リンクを検証
Format this old README according to modern best practices:
- Add table of contents
- Add language specifications to code blocks
- Align tables
- Validate links

2. 下書きから完成版へ

2. Draft to Final Document

このメモを正式なドキュメントに:
入力: 箇条書きのメモ
出力: 構造化されたMarkdown + HTML
Turn this note into a formal document:
Input: Bulleted notes
Output: Structured Markdown + HTML

3. 複数ドキュメントの統一

3. Standardize Multiple Documents

以下の3つのドキュメントを同じスタイルで統一:
スタイルガイド: Google
フォーマット: 厳密
Standardize the following 3 documents with the same style:
Style Guide: Google
Format: Strict

4. GitHub README の改善

4. Improve GitHub README

このREADMEを改善:
- バッジを追加
- 目次を生成
- コード例を整形
- スクリーンショットの配置を最適化
Improve this README:
- Add badges
- Generate table of contents
- Format code examples
- Optimize screenshot placement

5. 技術文書のHTML変換

5. Convert Technical Docs to HTML

API仕様書をHTMLに変換:
スタイル: 技術文書
サイドバー: 有効
検索: 有効
コピーボタン: すべてのコードブロックに
Convert API specification to HTML:
Style: Technical Documentation
Sidebar: Enabled
Search: Enabled
Copy Buttons: For all code blocks

ベストプラクティス

Best Practices

1. 一貫性

1. Consistency

  • 同じプロジェクト内では同じスタイルガイドを使用
  • インデント、マーカー、見出しスタイルを統一
  • 用語の一貫性(例: "e-mail" vs "email")
  • Use the same style guide within a project
  • Standardize indentation, markers, and heading styles
  • Maintain consistent terminology (e.g., "e-mail" vs "email")

2. 可読性

2. Readability

  • 適切な空行で区切る
  • 長い段落は分割
  • リストを効果的に使用
  • コード例は最小限で明確に
  • Separate content with proper blank lines
  • Split long paragraphs
  • Use lists effectively
  • Keep code examples minimal and clear

3. アクセシビリティ

3. Accessibility

  • 画像にaltテキスト
  • リンクテキストは説明的に
  • テーブルにヘッダー
  • 適切な見出し階層
  • Add alt text to images
  • Use descriptive link text
  • Include headers for tables
  • Use proper heading hierarchy

4. SEO(Web公開時)

4. SEO (For Web Publication)

  • メタデータの追加
  • 説明的な見出し
  • キーワードの適切な使用
  • 内部リンク構造
  • Add metadata
  • Use descriptive headings
  • Use keywords appropriately
  • Build internal link structure

トラブルシューティング

Troubleshooting

よくある問題

Common Issues

問題: テーブルが崩れる 解決: パイプ文字のエスケープ、列数の確認
問題: コードブロックが正しく表示されない 解決: 言語指定の確認、バックティックの数
問題: リンクが機能しない 解決: アンカーテキストの正規化、パスの確認
問題: 日本語の折り返しがおかしい 解決: word-break設定、フォント指定
Issue: Tables are broken Solution: Escape pipe characters, check column count
Issue: Code blocks don't display correctly Solution: Verify language specification, check backtick count
Issue: Links don't work Solution: Normalize anchor text, verify paths
Issue: Japanese text wraps incorrectly Solution: Adjust word-break settings, specify fonts

制限事項

Limitations

  • 非常に大きなドキュメント(10MB以上)は処理時間がかかる可能性
  • 複雑なHTMLの埋め込みは一部機能しない場合がある
  • PDF生成はフォントによって制限される場合がある
  • Very large documents (10MB+) may take longer to process
  • Complex embedded HTML may not work with some features
  • PDF generation may be limited by available fonts

バージョン情報

Version Information

  • スキルバージョン: 1.0.0
  • サポートMarkdown: CommonMark, GFM
  • HTML変換: Markdown-it ベース
  • PDF生成: Puppeteer/wkhtmltopdf

使用例:
このドキュメントを整形してください:

[乱れたMarkdownを貼り付け]

要件:
- 目次を追加(H2とH3のみ)
- コードブロックに言語指定
- テーブルを整列
- GitHub風HTMLも生成
このプロンプトで、プロフェッショナルに整形されたドキュメントが生成されます!
  • Skill Version: 1.0.0
  • Supported Markdown: CommonMark, GFM
  • HTML Conversion: Based on Markdown-it
  • PDF Generation: Puppeteer/wkhtmltopdf

Usage Example:
Please format this document:

[Paste messy Markdown here]

Requirements:
- Add table of contents (only H2 and H3)
- Add language specifications to code blocks
- Align tables
- Generate GitHub-style HTML
With this prompt, you'll get a professionally formatted document!