An open API service indexing awesome lists of open source software.

https://github.com/hsins/hackmd-themes

🎨 Colorful and pretty themes for HackMD. Most of them are ported from Typora Themes and Obsidian Themes.
https://github.com/hsins/hackmd-themes

hackmd hackmd-theme

Last synced: 6 months ago
JSON representation

🎨 Colorful and pretty themes for HackMD. Most of them are ported from Typora Themes and Obsidian Themes.

Awesome Lists containing this project

README

          

[![](https://img.shields.io/github/license/Hsins/hackmd-themes.svg?style=flat-square)](./LICENSE)

HackMD Themes
HackMD Themes

# HackMD Themes

🎨 _Colorful and pretty themes for [HackMD](https://hackmd.io/). Most of them are ported from [Typora Themes](https://theme.typora.io/) and [Obsidian Themes](https://github.com/kmaasrud/awesome-obsidian#themes)._

[![](https://img.shields.io/badge/HackMD-@themes-E2EB86.svg?style=flat-square&labelColor=black&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAQAAAAAYLlVAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAAmJLR0QA/4ePzL8AAAAJcEhZcwAADsMAAA7DAcdvqGQAAAAHdElNRQfmAwoINxXXHd3sAAACTElEQVRo3u2Zz0sVURTHPzPvycyDFv4IyYTo2UYMaREILtpJf4G50UVCRNAutFwVGNTGZbQoArdChdAuEDeCm3CTi9q5lZI2D5/U810XL3HUuTPnztzrA53v8t7Lmc/9zj33HGagUKGLLi9uUNkLlQPAp5dAHGeHWjaQmNUK4BLPuEdFaIbHU5YAn2Z2LyIACjWt9pWJHigU6pZ6qDqU0Sv0NeMj2hkdNUAnr5mh3NpEPoCOTOY1qfCCWcpHTFkBsqpJwPNDhHYAeEB4iCDxwDZASxGENAg3ABGENB9cARxDaA+A8Cy4BBCdBXG65ECABf6djQNezIZCXjKnL2t2HfjFEuEpt32qXOenW4BWAfzBfc2s9hzaArgJpNw7irhCbQtgik2+8DdhxR57Lh24zBueUNf2IiXe8dYlAIQMJc73xw+7vYii0pwOEwe2+XzUeiaok3G6pEFNAFZ5LCrxAVXGpEFNXkFd2GU1ErMhhwNVBtlN7bkVXfS5AbjDir6oRBTQ6wagxFWD1UKdXRpacGCL94I0VHTziCsuANZ4JYw5KgcweQUN4bom+/KgJg4Mc5eaIA27ueEG4DbLor2VCd0AQMVotQOARusDRIpKlNwAfGdedAZ6mGfABcAGH0XrfCblACZpmPPTT34HRpgWpuGQKJ4xwCAfRB2BZ+KVWRYYhZap7dWwACgAdAAGjbVQmm5CB7Aubj9k2uVb/ITuHvjENSasld8ai3yNn0r6Y9JDkPHnycln1Pmje1jSTbhjaf//9dtuuEKFzo0OACDtphjvEWdcAAAAJXRFWHRkYXRlOmNyZWF0ZQAyMDIyLTAzLTEwVDA4OjU1OjEwKzAwOjAwB+tWbQAAACV0RVh0ZGF0ZTptb2RpZnkAMjAyMi0wMy0xMFQwODo1NToxMCswMDowMHa27tEAAAAASUVORK5CYII=)](https://hackmd.io/@themes)
[![README in Traditional Chinese](https://img.shields.io/badge/README-繁體中文-8CA1AF.svg?logo=read-the-docs&style=flat-square)](./README_zh-TW.md)

## Usage

According to [Use Custom CSS Style in HackMD](https://hackmd.io/@hackmd/hackmd-new-blog#%E5%9C%A8-HackMD-%E8%87%AA%E8%A8%82%E7%AD%86%E8%A8%98%E6%A8%A3%E5%BC%8F%E8%A1%A8) and [Share CSS Style with Embedding Feature](https://hackmd.io/@hackmd/hackmd-new-blog#%E4%BD%BF%E7%94%A8%E5%85%A7%E5%B5%8C%E7%AD%86%E8%A8%98%E5%8A%9F%E8%83%BD%E5%85%B1%E7%94%A8%E7%AD%86%E8%A8%98%E6%A8%A3%E5%BC%8F%E8%A1%A8). I've published these themes for embedding use. Just use the syntax below to include the theme you need in your HackMD document.

```
{%hackmd @themes/dracula %}
```

The name of published themes will follow the naming convention `THEME_NAME` or `THEME_NAME-STYLE` (Note that `THEME_NAME` and `STYLE` should be in lowercase).

## Themes

Name
Preview
Embed Snippet

Dracula
[DEMO](https://hackmd.io/@themes/demo-dracula)

```
{%hackmd @themes/dracula %}
```

Notion
[DEMO](https://hackmd.io/@themes/demo-notion)

```
{%hackmd @themes/notion %}
```

OrangeHeart
[DEMO](https://hackmd.io/@themes/demo-orangeheart)

```
{%hackmd @themes/orangeheart %}
```

## Contribution

The syncing process of themes is handled by [HackMD API](https://hackmd.io/@hackmd-api/developer-portal/) and [GitHub Actions](https://github.com/features/actions). We can modify the `*.css` file inside `./styles` directory and then actions will automatically minimize the file and upload to HackMD. Check [`update-themes.yaml`](./.github/workflows/update-themes.yaml) for this workflow.

This project exists thanks to all the people who contribute:



## Credits

Themes are ported from [Typora Themes](https://theme.typora.io/) and [Obsidian Themes](https://github.com/kmaasrud/awesome-obsidian#themes). Credited to following people:

- **Dracula Theme**: [dracula](https://github.com/dracula), [Teyler7](https://github.com/Teyler7)
- **Notion Theme**: [adrian-fuertes](https://github.com/adrian-fuertes)
- **OrangeHeart Theme**: [zhning12](https://github.com/zhning12), [evgo2017](https://github.com/evgo2017)

## Other HackMD Themes

- [Neko250/hmd-themes](https://github.com/Neko250/hmd-themes)
- [Yukaii/hackmd-themes](https://github.com/Yukaii/hackmd-themes)

## License

Licensed under the Apache License, Version 2.0. Copyright Β© 2022-present [H.-H. Peng](https://github.com/Hsins).


Assembled with ❀️ in Taiwan.