{"id":15664546,"url":"https://github.com/facelessuser/pymdown-styles","last_synced_at":"2025-07-09T09:06:42.433Z","repository":{"id":23652226,"uuid":"27022771","full_name":"facelessuser/pymdown-styles","owner":"facelessuser","description":"Pygments styles for pymdown","archived":false,"fork":false,"pushed_at":"2015-06-14T18:05:47.000Z","size":184,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-30T02:24:44.114Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/facelessuser.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-11-23T05:14:00.000Z","updated_at":"2019-01-29T11:59:06.000Z","dependencies_parsed_at":"2022-08-22T02:30:55.823Z","dependency_job_id":null,"html_url":"https://github.com/facelessuser/pymdown-styles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facelessuser%2Fpymdown-styles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facelessuser%2Fpymdown-styles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facelessuser%2Fpymdown-styles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facelessuser%2Fpymdown-styles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/facelessuser","download_url":"https://codeload.github.com/facelessuser/pymdown-styles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245366198,"owners_count":20603438,"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":[],"created_at":"2024-10-03T13:43:11.322Z","updated_at":"2025-03-24T22:45:41.762Z","avatar_url":"https://github.com/facelessuser.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PyMdown Extra Styles\n`pymdown-styles` is a package that adds additional styles to Pygments.  It was created for the [PyMdown project](https://github.com/facelessuser/PyMdown), but it can be used by anyone who wants to add the contained styles to Pygments, or just simply grab the CSS.  The idea was to have Pygments generate the CSS for PyMdown.  Also if no CSS was desired, Pygments could just write the style directly into the style attribute of the HTML tags.  If working with the Python module is not needed, then grabbing the CSS should be all you need.\n\n# Included Styles\nThese are the included styles:\n\n| Style | Description |\n|-------|-------------|\n| github | Pygments style that Github used to use before 2014 |\n| github2014 | Pygments style that was used during 2014 until Github abandoned using Pygments. |\n| readthedocs | Read the Docs Pygments style that is used in the [Read the Docs Sphinx theme](https://github.com/snide/sphinx_rtd_theme) which originally comes from [wyrm repo](https://github.com/snide/wyrm). |\n| tomorrowmorning | Pygments style from [Aprosopo](https://github.com/facelessuser/Aprosopo) based off the [Tomorrow themes](https://github.com/chriskempson/tomorrow-theme). |\n| tomorrownighteightiesstormy | Pygments style from [Aprosopo](https://github.com/facelessuser/Aprosopo) based off the [Tomorrow themes](https://github.com/chriskempson/tomorrow-theme). |\n\n## Adding New Styles\nAdding a new style is fairly easy.  Ultimately, this repo expects CSS files.  So if all you have is the CSS, you should be okay.  If you already have a Python module, then you should be able to get the CSS from that with Pygments.\n\n### Starting from a CSS File\nTo add a new style, the Pygments CSS should be dropped in the `stylesheets` directory.  The style sheets are the only files that should be added; everything else is auto-generated.  The style sheets should also be namespaced with the class `.highlight`; see the other CSS files as examples.\n\nAfter adding the new style sheet(s), `build_modules.py` should be run.  This will crawl the style sheets and convert them to Python modules in the `pymdown_styles` directory.  Pygments will use those python modules to generate CSS.  The `__init__.py` file will also get updated exposing all of the modules.  Lastly, `entry_points.py` will get updated with the proper entry points that Pygments will look for when loading the styles.\n\n### Starting from a Python Module\nIf you already have a Python Module, you should convert it to CSS first and drop the CSS module into the project following the steps outlined in [Starting from a CSS File](#staring-from-a-css-file).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacelessuser%2Fpymdown-styles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffacelessuser%2Fpymdown-styles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacelessuser%2Fpymdown-styles/lists"}