{"id":34725270,"url":"https://github.com/roman910dev/ghmd","last_synced_at":"2026-01-16T23:15:09.645Z","repository":{"id":219301868,"uuid":"748670478","full_name":"roman910dev/ghmd","owner":"roman910dev","description":"An extremely light-weight (~4KB) and simple command line tool to convert Markdown files to GitHub-styled HTML.","archived":false,"fork":false,"pushed_at":"2026-01-15T15:00:15.000Z","size":153,"stargazers_count":11,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-15T18:26:43.112Z","etag":null,"topics":["cli","converter","github","github-flavored-markdown","html","markdown"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/ghmd/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/roman910dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-01-26T14:06:59.000Z","updated_at":"2026-01-15T14:55:58.000Z","dependencies_parsed_at":"2025-01-10T11:39:47.940Z","dependency_job_id":null,"html_url":"https://github.com/roman910dev/ghmd","commit_stats":null,"previous_names":["roman910dev/ghmd"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/roman910dev/ghmd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roman910dev%2Fghmd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roman910dev%2Fghmd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roman910dev%2Fghmd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roman910dev%2Fghmd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roman910dev","download_url":"https://codeload.github.com/roman910dev/ghmd/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roman910dev%2Fghmd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28487407,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T22:54:02.790Z","status":"ssl_error","status_checked_at":"2026-01-16T22:50:10.344Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","converter","github","github-flavored-markdown","html","markdown"],"created_at":"2025-12-25T02:25:13.210Z","updated_at":"2026-01-16T23:15:09.631Z","avatar_url":"https://github.com/roman910dev.png","language":"HTML","readme":"# ghmd\n\nghmd (GitHub Markdown) is an extremely light-weight and simple command line tool to convert GitHub Flavored Markdown (or [plain Markdown](#no-gfm)) to HTML.\n\nIt does so by using the [GitHub Markdown API](https://docs.github.com/en/free-pro-team@latest/rest/reference/markdown) in combination with [GitHub Markdown CSS](https://github.com/sindresorhus/github-markdown-css).\n\nIt has two available implementations:\n\n-   [Python](https://pypi.org/project/ghmd/)\n-   [Node.js](https://www.npmjs.com/package/ghmd-js)\n  \n## Installation\n\n```bash\n# Node.js\nnpm install -g ghmd-js\n```\n\nor\n\n```bash\n# Python\npip install ghmd\n```\n\n## Usage\n\nSimply run `ghmd` with the path to the markdown file(s) you want to convert. An HTML file will be created in the same directory as the markdown file with the same filename.\n\n```bash\nghmd README.md\n# or\nghmd README.md CONTRIBUTING.md\n```\n\n\u003e [!NOTE]\n\u003e If you don't have the `ghmd` command available after installing, you may need to add the Python scripts directory to your PATH environment variable.\n\u003e\n\u003e Otherwise you, can use `python -m ghmd` instead of `ghmd`.\n\n## Options\n\n### GitHub API Token\n\nBy default, ghmd uses unauthenticated requests to the GitHub API, which has a rate limit of 60 requests per hour. To increase this limit to 5000 requests per hour, you can set the `GITHUB_TOKEN` environment variable with a GitHub personal access token:\n\n```bash\nexport GITHUB_TOKEN=your_github_token_here\nghmd README.md\n```\n\nTo create a personal access token, visit your [GitHub Settings \u003e Developer Settings \u003e Personal access tokens](https://github.com/settings/tokens) and create a new token (no specific scopes are required).\n\n### `--embed-css`\n\nBy default, ghmd will add the remote CSS as a `\u003clink\u003e` tag in the HTML file. If you want to embed the CSS directly into the HTML file so that, for example, you can send the HTML file to someone else and they can view it without an internet connection, you can use the `--embed-css` option.\n\n```bash\nghmd README.md --embed-css\n```\n\n### `--light` and `--dark`\n\nThe default CSS styles adapt to the system's dark mode setting of the reader. If you want to force the CSS to be light or dark, you can use the `--light` or `--dark` options.\n\n```bash\nghmd README.md --light\n# or\nghmd README.md --dark\n```\n\nBoth `--light` and `--dark` can be used in combination with `--embed-css`.\n\n\u003e [!NOTE]\n\u003e Using the `--embed-css` option will result in a ~25 KB larger HTML file size (~18 KB when using `--light` or `--dark`).\n\n### `--no-gfm`\n\nThe tool offers two modes: GitHub Flavored Markdown (gfm, default) and plain Markdown. To use the latter, the `--no-gfm` option can be used:\n\n```bash\nghmd README.md --no-gfm\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froman910dev%2Fghmd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froman910dev%2Fghmd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froman910dev%2Fghmd/lists"}