[{"_1":2,"_184":-5,"_185":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_158":159},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":17},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_91":-5,"_92":93,"_149":-5,"_150":11,"_151":17,"_152":11,"_153":-5,"_154":11,"_155":-5,"_156":157},"canonicalUrl","https://hub.docker.com/r/blackrose01/markdown-pdf/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","blackrose01","reponame","markdown-pdf","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_46":47,"_49":50,"_51":52,"_53":11,"_54":55,"_56":57,"_58":59,"_39":31,"_28":29,"_61":62,"_63":48,"_64":65,"_66":67,"_68":69,"_70":-5,"_71":65,"_72":73,"_74":11,"_75":29,"_76":77,"_82":11,"_83":84,"_88":29,"_89":90},"categories",[38,43],{"_39":40,"_41":42},"name","Integration & delivery","slug","integration-and-delivery",{"_39":44,"_41":45},"Developer tools","developer-tools","content_types",[48],"image","date_registered","2024-06-24T21:41:17.448886Z","description","Create PDFs from Markdown without pandoc","is_private","last_updated","2024-08-02T14:57:50.350236Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[60],"application/vnd.oci.image.index.v1+json","pull_count",251,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# Docker for Markdown PDF\n\nThis repository provides a Dockerfile to convert Markdown files into PDF.\n\n## Table of Contents\n\n\n\n- [Features](#features)\n- [Usage](#usage)\n- [Options](#options)\n- [FAQ](#faq)\n- [License](#license)\n- [Special thanks](#special-thanks)\n\n\n\n## Features\n\nSupports the following features\n\n- [Syntax highlighting](https://highlightjs.org/static/demo/)\n- [emoji](https://www.webfx.com/tools/emoji-cheat-sheet/)\n- [markdown-it-checkbox](https://github.com/mcecot/markdown-it-checkbox)\n- [markdown-it-container](https://github.com/markdown-it/markdown-it-container)\n- [markdown-it-include](https://github.com/camelaissani/markdown-it-include)\n- [PlantUML](https://plantuml.com/)\n - [markdown-it-plantuml](https://github.com/gmunguia/markdown-it-plantuml)\n- [mermaid](https://mermaid-js.github.io/mermaid/)\n\n### markdown-it-container\n\nINPUT\n\n```\n::: warning\n*here be dragons*\n:::\n```\n\nOUTPUT\n\n```html\n

here be dragons

\n```\n\n### markdown-it-plantuml\n\nINPUT\n\n```\n@startuml\nBob -[#red]> Alice : hello\nAlice -[#0000FF]->Bob : ok\n@enduml\n```\n\nOUTPUT\n\n![PlantUML](images/PlantUML.png)\n\n### markdown-it-include\n\nInclude markdown fragment files: `:[alternate-text](relative-path-to-file.md)`.\n\n```\n├── [plugins]\n│ └── README.md\n├── CHANGELOG.md\n└── README.md\n```\n\nINPUT\n\n```\nREADME Content\n\n:[Plugins](./plugins/README.md)\n\n:[Changelog](CHANGELOG.md)\n```\n\nOUTPUT\n\n```\nContent of README.md\n\nContent of plugins/README.md\n\nContent of CHANGELOG.md\n```\n\n## Usage\n\nDownload the image from Docker Hub. Then set the environment variables and link your markdown files into the container. The ouput files should appear in the folder.\n\n### Example\n\n```\nExample for Project Folder\n\n├── [folder_1]\n│ └── README.md\n│ └── README_APPENDIX.md\n├── CHANGELOG.md\n└── README.md\n```\n\n1. Only convert 1 file\n `docker run --rm -v ./CHANGELOG.md:/data/CHANGELOG.md -e INPUT_FILE=/data/CHANGELOG.md blackrose01/markdown-pdf`\n2. Convert connected files\n `docker run --rm -v ./folder_1:/data -e INPUT_FILE=/data/README.md blackrose01/markdown-pdf`\n\n## Available Environment Variables\n\n| Environment Variable | Type | Default Value |\n| :-------------------------------------------------------- | :------------------------------ | :-------------------------------------------------------------- |\n| [DEBUG](#debug) | Boolean | false |\n| [CHROMIUM_PATH](#chromium_path) | String | /usr/bin/chromium-browser |\n| [CHROMIUM_ARGS](#chromium_args) | String (Array, comma-separated) | --lang=en,--no-sandbox,--disable-setuid-sandbox |\n| [INPUT_FILE](#input_file) | String | |\n| [OUTPUT_FILE_NAME](#output_file_name) | String | |\n| [OUTPUT_FILE_NAME_USE_FOLDERNAME](#output_file_name_use_foldername) | Boolean | true |\n| [OUTPUT_FILE_NAME_CASE_STYLE](#output_file_name_case_style) | Boolean | capital |\n| [OUTPUT_FILE_NAME](#output_file_name) | String | |\n| [OUTPUT_TYPE](#output_type) | String (Array, comma-separated) | pdf |\n| [OUTPUT_PATH](#output_path) | String | |\n| [ENABLE_SYNTAX_HIGHLIGHT](#enable_syntax_highlight) | Boolean | true |\n| [HIGHLIGHT_STYLE](#highlight_style) | String | |\n| [ENABLE_LINE_BREAKS](#enable_line_breaks) | Boolean | true |\n| [ENABLE_EMOJIS](#enable_emojis) | Boolean | true |\n| [SCALE](#scale) | Integer | 1 |\n| [PDF_RANGED](#pdf_ranged) | String | |\n| [DISPLAY_HEADER_FOOTER](#display_header_footer) | Boolean | true |\n| [HEADER_TEMPLATE](#header_template) | String | |\n| [FOOTER_TEMPLATE](#footer_template) | String | |\n| [PRINT_BACKGROUND](#print_background) | Boolean | true |\n| [OMIT_BACKGROUND](#omit_background) | Boolean | true |\n| [ORIENTATION](#orientation) | String | portrait |\n| [PAPER_FORMAT](#paper_format) | String | A4 |\n| [PAPER_WIDTH](#paper_width) | String | |\n| [PAPER_HEIGHT](#paper_format) | String | |\n| [PAPER_MARGIN_TOP](#paper_margin_top) | String | 1.5cm |\n| [PAPER_MARGIN_RIGHT](#paper_margin_right) | String | 1cm |\n| [PAPER_MARGIN_BOTTOM](#paper_margin_bottom) | String | 1cm |\n| [PAPER_MARGIN_LEFT](#paper_margin_left) | String | 1cm |\n| [PLANTUML_OPEN_MARKER](#plantuml_open_marker) | String | @startuml |\n| [PLANTUML_CLOSE_MARKER](#plantuml_close_marker) | String | @enduml |\n| [PLANTUML_URL](#plantuml_url) | String | http://www.plantuml.com/plantuml |\n| [MERMAID_URL](#mermaid_url) | String | https://cdn.jsdelivr.net/npm/mermaid@10.9.1/dist/mermaid.min.js |\n| [ENABLE_MARKDOWN_IT_INCLUDE](#enable_markdown_it_include) | Boolean | true |\n| [MARKDOWN_IT_REGEX_INCLUDE](#markdown_it_regex_include) | String | :\\[.+\\]\$(.+\\..+)\$ |\n| [JPEG_QUALITY](#jpeg_quality) | Integer | 100 |\n| [IMAGE_CLIP_X](#image_clip_x) | Integer | |\n| [IMAGE_CLIP_Y](#image_clip_y) | Integer | |\n| [IMAGE_CLIP_HEIGHT](#image_clip_height) | Integer | |\n| [IMAGE_CLIP_WIDTH](#image_clip_width) | Integer | |\n| [INCLUDE_DEFAULT_STYLES](#include_default_styles) | Boolean | true |\n| [ADDITIONAL_STYLES](#additional_styles) | String (Array, comma-separated) | |\n\n### Description\n\n#### `DEBUG`\n\n> Default Value: false\n\nEnables the debugging mode of the program.\n\n#### `CHROMIUM_PATH`\n\n> Default Value: /usr/bin/chromium-browser\n\nPath to the executable of Chromium. Normally this does not need to be adjusted.\n\n#### `CHROMIUM_ARGS`\n\n> Default Value: --lang=en,--no-sandbox,--disable-setuid-sandbox\n\nArguments which will be passed to Chromium via Pupeteer.\n\n#### `INPUT_FILE`\n\nName of the Input file which needs to be converted. This is a required.\n\n#### `OUTPUT_FILE_NAME`\n\nName of the Output file. Default is the name of the Input File.\n\n#### `OUTPUT_FILE_NAME_USE_FOLDERNAME`\n\n> Default Value: true\n\nFile name is the name of the parent folder in which the file is located. This option overwrites `OUTPUT_FILE_NAME`.\n\n#### `OUTPUT_FILE_NAME_CASE_STYLE`\n\n> Default Value: capital\n> Options: camel, capital, constant, dot, kebab, no, pascal, pascalsnake, path, sentence, snake, train\n\nName of the Output file. Default is the name of the Input File.\n\n#### `OUTPUT_TYPE`\n\n> Default Value: pdf\n> Options: pdf, html, png, jpeg, all\n\nDetermines the output format for the converter. If the all option is selected, `all` output formats are used.\n\n#### `OUTPUT_PATH`\n\nSpecifies where the generated files are to be stored. The default is where the files to be converted are located.\n\n#### `ENABLE_SYNTAX_HIGHLIGHT`\n\n> Default Value: true\n\nEnables syntax highlighting.\n\n#### `HIGHLIGHT_STYLE`\n\n> Default Value: \n\n```\nOptions:\n- 1c-light.css \\\n- a11y-dark.css \\\n- a11y-light.css \\\n- agate.css \\\n- androidstudio.css \\\n- an-old-hope.css \\\n- arduino-light.css \\\n- arta.css \\\n- ascetic.css \\\n- atom-one-dark.css \\\n- atom-one-dark-reasonable.css \\\n- atom-one-light.css \\\n- brown-paper.css \\\n- brown-papersq.png \\\n- codepen-embed.css \\\n- color-brewer.css \\\n- dark.css \\\n- default.css \\\n- devibeans.css \\\n- docco.css \\\n- far.css \\\n- felipec.css \\\n- foundation.css \\\n- github.css \\\n- github-dark.css \\\n- github-dark-dimmed.css \\\n- gml.css \\\n- googlecode.css \\\n- gradient-dark.css \\\n- gradient-light.css \\\n- grayscale.css \\\n- hybrid.css \\\n- idea.css \\\n- intellij-light.css \\\n- ir-black.css \\\n- isbl-editor-dark.css \\\n- isbl-editor-light.css \\\n- kimbie-dark.css \\\n- kimbie-light.css \\\n- lightfair.css \\\n- lioshi.css \\\n- magula.css \\\n- mono-blue.css \\\n- monokai.css \\\n- monokai-sublime.css \\\n- night-owl.css \\\n- nnfx-dark.css \\\n- nnfx-light.css \\\n- nord.css \\\n- obsidian.css \\\n- panda-syntax-dark.css \\\n- panda-syntax-light.css \\\n- paraiso-dark.css \\\n- paraiso-light.css \\\n- pojoaque.css \\\n- pojoaque.jpg \\\n- purebasic.css \\\n- qtcreator-dark.css \\\n- qtcreator-light.css \\\n- rainbow.css \\\n- routeros.css \\\n- school-book.css \\\n- shades-of-purple.css \\\n- srcery.css \\\n- stackoverflow-dark.css \\\n- stackoverflow-light.css \\\n- sunburst.css \\\n- tokyo-night-dark.css \\\n- tokyo-night-light.css \\\n- tomorrow-night-blue.css \\\n- tomorrow-night-bright.css \\\n- vs.css \\\n- vs2015.css \\\n- xcode.css \\\n- xt256.css\n```\n\nWhich syntax highlighter should be used.\n\n#### `ENABLE_LINE_BREAKS`\n\n> Default Value: true\n\nEnable line breaks in documents.\n\n```html\n

\n```\n\n#### `ENABLE_EMOJIS`\n\n> Default Value: true\n\nEnable Emojis in Markdown.\n\n#### `SCALE`\n\n> Default Value: 1\n\nScaling for the document\n\n#### `PDF_RANGED`\n\n> Default Value: \n\nOnly save specific pages in PDF document. Example: 1, 2-5, 9\n\n#### `DISPLAY_HEADER_FOOTER`\n\n> Defaul Value: true\n\nPrint a header and a footer on each page in PDF.\n\n#### `HEADER_TEMPLATE`\n\n> Default Value: \\

\\\\\\

%%ISO-DATE%%\\

\n\nTemplate for the Header.\n\n#### `FOOTER_TEMPLATE`\n\n> Default Value: \\

\\\\ / \\\\\\

\n\nTemplate for the Footer.\n\n#### `PRINT_BACKGROUND`\n\n> Default Value: true\n\nPrint the background.\n\n#### `OMIT_BACKGROUND`\n\n> Default Value: true\n\nOmit the background.\n\n#### `ORIENTATION`\n\n> Default Value: portrait\n> Available Options: portrait, landscape\n\nOrientation of the pages.\n\n#### `PAPER_FORMAT`\n\n> Default Value: A4\n> Available Options: A0, A1, A2, A3, A4, A5, A6, Ledger, Tabloid, Legal, Letter\n\nFormat of the pages.\n\n#### `PAPER_WIDTH`\n\nWidth of a page. Overwrites environment variable `PAPER_FORMAT`.\n\n#### `PAPER_HEIGHT`\n\nHeight of a page. Overwrites environment variable `PAPER_FORMAT`.\n\n#### `PAPER_MARGIN_TOP`\n\n> Default Value: 1.5cm\n\nBorder margin top. Usable with unit.\n\n#### `PAPER_MARGIN_RIGHT`\n\n> Default Value: 1cm\n\nBorder margin right. Usable with unit.\n\n#### `PAPER_MARGIN_BOTTOM`\n\n> Default Value: 1cm\n\nBorder margin bottom. Usable with unit.\n\n#### `PAPER_MARGIN_LEFT`\n\n> Default Value: 1cm\n\nBorder margin left. Usable with unit.\n\n#### `PLANTUML_OPEN_MARKER`\n\n> Default Value: @startuml\n\nOpen marker for PlantUML containers.\n\n#### `PLANTUML_CLOSE_MARKER`\n\n> Default Value: @enduml\n\nClose marker for PlantUML containers.\n\n#### `PLANTUML_URL`\n\n> Default Value: http://www.plantuml.com/plantuml\n\nURL for PlantUML parser files.\n\n#### `MERMAID_URL`\n\n> Default Value: https://cdn.jsdelivr.net/npm/mermaid@10.9.1/dist/mermaid.min.js\n\nJS file for Mermaid parser file.\n\n#### `ENABLE_MARKDOWN_IT_INCLUDE`\n\n> Default Value: true\n\nEnable inclusions of Markdown files.\n\n#### `MARKDOWN_IT_REGEX_INCLUDE`\n\n> Default Value: `:\\\\[.+\\\\]\\\$(.+\\\\..+)\\\$`\n\nDefine the pattern of the include links in a markdown file.\n\n#### `JPEG_QUALITY`\n\n> Default Value: 100\n\nQuality of the JPEG file. Only for `OUTPUT_TYPE` jpeg.\n\n#### `IMAGE_CLIP_X`\n\nX-Coordinate for clipper.\n\n#### `IMAGE_CLIP_Y`\n\nY-Coordinate for clipper.\n\n#### `IMAGE_CLIP_HEIGHT`\n\nHeight of the Image from clipper.\n\n#### `IMAGE_CLIP_WIDTH`\n\nWidth of the Image from clipper.\n\n#### `INCLUDE_DEFAULT_STYLES`\n\n> Default Value: true\n\nInclude default CSS styles.\n\n#### `ADDITIONAL_STYLES`\n\nList of local additional css files. Use absolute path in container.\n\n## FAQ\n\n### How can I change emoji size ?\n\n1. Add the following to your stylesheet which was specified in the markdown-pdf.styles\n\n```css\n.emoji {\n height: 2em;\n}\n```\n\n### Output directory\n\nIf you always want to output to the relative path directory from the Markdown file.\n\nFor example, to output to the \"output\" directory in the same directory as the Markdown file, set it as follows.\n\n```javascript\n\"markdown-pdf.outputDirectory\" : \"output\",\n\"markdown-pdf.outputDirectoryRelativePathFile\": true,\n```\n\n### Page Break\n\nPlease use the following to insert a page break.\n\n```html\n

\n```\n\n## License\n\nThis project uses the MIT license.\n\n## Special thanks\n\nThis repository based on `yzane`s VSCode extension [Markdown PDF](https://github.com/yzane/vscode-markdown-pdf).","has_starred","hub_user","immutable_tags_settings",{"_78":11,"_79":80},"enabled","rules",[81],".*","is_automated","permissions",{"_85":17,"_86":11,"_87":11},"read","write","admin","user","storage_size",3090405742,"orgData","recentTags",[94],{"_95":48,"_96":97,"_98":99,"_100":101,"_102":103,"_104":105,"_54":138,"_139":97,"_140":29,"_141":60,"_39":142,"_143":144,"_145":113,"_146":138,"_147":69,"_148":17},"content_type","creator",4325253,"digest","sha256:9b8c10072d120de2d061635056e476a8fde83b1aa360e7a0e24ac2fb77552880","full_size",349447737,"id",725191108,"images",[106,123,128,134],{"_107":108,"_98":109,"_110":111,"_112":113,"_114":115,"_116":117,"_118":111,"_119":-5,"_120":121,"_66":69,"_122":-5},"architecture","amd64","sha256:3bff9213fe5e63bd02c8ae8fb740a9d46f9dd8562f9d73e0a308bbcfe6595221","features","","last_pulled","2026-09-23T19:57:33.394864216Z","last_pushed","2024-08-02T14:57:47Z","os","linux","os_features","os_version","size",355618863,"variant",{"_107":124,"_98":125,"_110":111,"_112":126,"_114":115,"_116":117,"_118":111,"_119":-5,"_120":101,"_66":127,"_122":-5},"arm64","sha256:18fd64ddc65c9d6a7cdf950db26e8d090d54c04f6c36ff19b4baffb96e4f3f2d","2026-07-17T02:28:26.653263775Z","inactive",{"_107":129,"_98":130,"_110":111,"_112":131,"_114":132,"_116":129,"_118":111,"_119":-5,"_120":133,"_66":127,"_122":-5},"unknown","sha256:7f679d4f3cfadc283c426ca4ec17719a5661d0e72ef0713bee77a47e8ead09cc","2026-07-17T02:28:26.652513011Z","2024-08-02T14:57:46Z",15512,{"_107":129,"_98":135,"_110":111,"_112":136,"_114":137,"_116":129,"_118":111,"_119":-5,"_120":133,"_66":127,"_122":-5},"sha256:7b44b5d6d1f9b17686079d4e60fcd8a55f46ce8e6e62112c9f340759acaec17c","2026-07-17T02:28:26.651637209Z","2024-08-02T14:57:49Z","2024-08-02T14:57:49.351022Z","last_updater","last_updater_username","media_type","latest","repository",24449985,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":160,"_169":170,"_156":182,"_183":11},{"_36":161,"_46":164,"_49":50,"_51":52,"_53":11,"_54":55,"_56":57,"_58":165,"_39":31,"_28":29,"_61":62,"_63":48,"_64":65,"_66":67,"_68":69,"_70":-5,"_71":65,"_72":73,"_74":11,"_75":29,"_76":166,"_82":11,"_83":168,"_88":29,"_89":90},[162,163],{"_39":40,"_41":42},{"_39":44,"_41":45},[48],[60],{"_78":11,"_79":167},[81],{"_85":17,"_86":11,"_87":11},"tags",{"_171":67,"_172":-5,"_173":-5,"_174":175},"count","next","previous","results",[176],{"_95":48,"_96":97,"_98":99,"_100":101,"_102":103,"_104":177,"_54":138,"_139":97,"_140":29,"_141":60,"_39":142,"_143":144,"_145":113,"_146":138,"_147":69,"_148":17},[178,179,180,181],{"_107":108,"_98":109,"_110":111,"_112":113,"_114":115,"_116":117,"_118":111,"_119":-5,"_120":121,"_66":69,"_122":-5},{"_107":124,"_98":125,"_110":111,"_112":126,"_114":115,"_116":117,"_118":111,"_119":-5,"_120":101,"_66":127,"_122":-5},{"_107":129,"_98":130,"_110":111,"_112":131,"_114":132,"_116":129,"_118":111,"_119":-5,"_120":133,"_66":127,"_122":-5},{"_107":129,"_98":135,"_110":111,"_112":136,"_114":137,"_116":129,"_118":111,"_119":-5,"_120":133,"_66":127,"_122":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
3bff9213fe5e	linux/amd64	339.14 MB
18fd64ddc65c	linux/arm64	333.26 MB

blackrose01/markdown-pdf

Tags for blackrose01/markdown-pdf