{"id":28381887,"url":"https://github.com/opf/md-to-pdf","last_synced_at":"2025-06-25T04:31:04.328Z","repository":{"id":64440332,"uuid":"557224356","full_name":"opf/md-to-pdf","owner":"opf","description":"A markdown to pdf generator with styling by yml","archived":false,"fork":false,"pushed_at":"2025-06-19T10:54:58.000Z","size":5100,"stargazers_count":9,"open_issues_count":1,"forks_count":2,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-06-22T00:57:49.485Z","etag":null,"topics":["markdown","pdf"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opf.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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}},"created_at":"2022-10-25T09:52:55.000Z","updated_at":"2025-06-19T10:55:01.000Z","dependencies_parsed_at":"2024-01-15T15:42:40.106Z","dependency_job_id":"54900435-c96e-4a98-bae1-a36fdededdc6","html_url":"https://github.com/opf/md-to-pdf","commit_stats":null,"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"purl":"pkg:github/opf/md-to-pdf","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opf%2Fmd-to-pdf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opf%2Fmd-to-pdf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opf%2Fmd-to-pdf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opf%2Fmd-to-pdf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opf","download_url":"https://codeload.github.com/opf/md-to-pdf/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opf%2Fmd-to-pdf/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261805036,"owners_count":23212289,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["markdown","pdf"],"created_at":"2025-05-30T04:06:39.836Z","updated_at":"2025-06-25T04:31:04.318Z","avatar_url":"https://github.com/opf.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Markdown-to-PDF\n\nA markdown to pdf generator with styling by yml.\n\n**WORK IN PROGRESS**, please expect changes to API and styling yml spec\n\n## Installation\n\n```bash\nbundle add md_to_pdf --github opf/md-to-pdf\n```\n\nRequirements\n\n* Ruby 3.4.0 or newer\n\n## Usage\n\n### Command line\n\nbundle exec md_to_pdf `\u003cstyling file\u003e` `\u003csource file\u003e` `\u003cdest file\u003e`\n\nExample:\n\n```bash\nbundle exec md_to_pdf ./demo/demo.yml ./demo/demo.md ./demo/generated/demo.pdf\n```\n\n### As Library\n\n```ruby\nrequire 'md_to_pdf'\n\n#...\n# file processing\nstyling_filename = './demo/demo.yml'\nsource_filename = './demo/demo.md'\ndest_filename = './demo/generated/demo.pdf'\nMarkdownToPDF.generate_markdown_pdf(source_filename, styling_filename, dest_filename)\n\n# example with raw markdown pre-processing\nmarkdown_string = File.read(source_filename)\nmarkdown_string += 'An additional text at the bottom'\nimages_path = File.dirname(source_filename)\nMarkdownToPDF.generate_markdown_string_pdf(markdown_string, styling_filename, images_path, dest_filename)\n```\n## Known Limitations\n\n* Table cells that exceed the height of a single page are truncated (see [prawn-table#41](https://github.com/prawnpdf/prawn-table/issues/41)).   \n\n**Currently not supported:**\n\n* Tables in tables\n* Images inline in text in tables (images will be placed in own line)\n* Images inline in text (images will be placed in own line)\n* Remote images e.g. via http (images will be skipped)\n* Outer table borders at the same time as cell borders of outer cells\n  \n\n## Markdown\n\nPlease have a look at [demo.md](./demo/demo.md) for an overview and examples of all supported markdown syntax\n\n## Styling\n\nA yml config file is used to set the pdf styling\n\nPlease have a look at [docs/STYLING.md](docs/STYLING.md) for description.\n\n## Frontmatter\n\nMeta Information and header/footer content is defined in a head section of the markdown file\n\nPlease have a look at [docs/FRONTMATTER.md](docs/FRONTMATTER.md) for description.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopf%2Fmd-to-pdf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopf%2Fmd-to-pdf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopf%2Fmd-to-pdf/lists"}