generate-md-action-inputs

Generate Markdown from Action Inputs

Danger

This action is deprecated please use the cli @stephansama/auto-readme instead as it is more feature-filled

This GitHub Action automatically generates a Markdown table of your action’s inputs and adds it to your README.md. It’s a simple way to keep your documentation in sync with your action.yml file.

Why use this action?

• Automated Documentation: No more manually updating your README.md every time you change an input in your action.yml.
• Improved Discoverability: A clear and concise table of inputs makes it easier for users to understand and use your action.
• Professional Look: A well-documented action is a sign of a quality project.

Before and After

Before:

<!-- ACTION start -->
<!-- ACTION end -->

After:

<!-- ACTION start -->

| Name       | Default         | Description               | Required |
| ---------- | --------------- | ------------------------- | -------- |
| `my-input` | `default-value` | This is my amazing input. | `false`  |

<!-- ACTION end -->

Usage

1. Add the comment block to your README.md:

   Add the following comment block to your README.md where you want the table of inputs to be generated:

   <!-- ACTION start -->
   <!-- ACTION end -->

2. Create a workflow file:

   Create a new workflow file in your .github/workflows directory (e.g., .github/workflows/docs.yml) with the following content:

example-generate-md-action-inputs.yml

name: generate-md-action-inputs example
on:
  workflow_dispatch:
permissions:
  actions: write
  contents: write
jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
      - uses: stephansama/actions/generate-md-action-inputs@v1
        with:
          verbose: true

Required permissions

permissions:
  actions: write
  contents: write

🧰 actions

🏷️ Name	Required	⚙️ Default	📝 Description
comment_tag_name	comment_tag_name	ACTION	Prefix for delimiting block start and end
commit_message	commit_message	Updated readme with the latest action inputs	Commit message used while committing to the repo
committer_username	committer_username	stephansama-bot	Username used while committing to the repo
committer_email	committer_email	[email protected]	Email id used while committing to the repo
gh_token	gh_token	${{github.token}}	Github token scoped to current repo (need to have an environment variable set if not supplied)
git_provider	git_provider	github	Git Provider to base remote urls from. Supported values are ‘github’ and ‘gitlab’.
heading	heading	⚙️ Inputs	Heading for table
heading_level	heading_level	3	Heading level for table
skip_commit	skip_commit	false	Skips committing the changes to repo
verbose	verbose	false	Whether or not to enable verbose logging for shell scripts

Type Aliases

Type Alias	Description
ActionData	‐
ActionType	‐
BuiltCommentTags	‐
GitProvider	‐
Inputs	‐
TableHeading	‐

Functions

Function	Description
buildCommentTags	‐
capitalize	‐
commitReadmes	‐
createHeading	‐
createTable	‐
debugCommit	‐
findIndices	‐
getActionsPaths	‐
getGitRoot	‐
isValidActionData	‐
loadActionData	‐
loadInputs	‐
run	‐
setupGit	‐
updateLocalActionReadmes	‐
writeActionsData	‐