| publish-mode | Publishing mode. manual generates a ready-to-post package without API calls. auto publishes via platform API. | no | manual |
| platform | Target platform. Currently supported value is linkedin. | no | linkedin |
| linkedin-access-token | LinkedIn OAuth access token. | no | — |
| linkedin-author-urn | LinkedIn author URN, for example urn:li:person:xxxx or urn:li:organization:xxxx. | no | — |
| linkedin-profile-url | Optional LinkedIn profile URL to append in caption as branding link. | no | "" |
| caption-source | Caption source, readme or custom. | no | readme |
| custom-caption | Custom caption text used when caption-source is custom. | no | "" |
| readme-path | Path to README file. | no | README.md |
| include-repo-link | Append repository URL for branding. | no | true |
| include-badges | Parse README badges and append badge target links in caption. | no | true |
| auto-media | Auto collect media files from README and repository. | no | true |
| include-readme-images | Include README images and videos as attachments. | no | true |
| include-repo-media | Include repository media matched by media-glob. | no | true |
| media-glob | Glob pattern to collect repository media. | no | **/*.{png,jpg,jpeg,gif,webp,mp4,mov,avi,webm,mkv} |
| table-to-image | Convert markdown tables in README into PNG and include as attachments. | no | true |
| max-images | Maximum number of image attachments in one post. | no | 9 |
| dry-run | If true, skip posting and only print payload preview. | no | false |
| manual-output-dir | Output directory used in manual mode. | no | .social-share-output |