\n \nDiaryMD

\n
\n\n[![Main-Docker](https://github.com/aceberg/DiaryMD/actions/workflows/main-docker.yml/badge.svg)](https://github.com/aceberg/DiaryMD/actions/workflows/main-docker.yml)\n[![Docker Image Size (latest semver)](https://img.shields.io/docker/image-size/aceberg/diarymd)](https://hub.docker.com/r/aceberg/diarymd)\n\nMarkdown editor written in `Go` and `SolidJS`:\n- Fully configurable Themes\n- Tabs\n- WorkSpaces\n- Simple Blog\n- Full screen mode\n- Works with a given directory (could be a `git` repo). No DB needed\n\n![Screenshot](https://raw.githubusercontent.com/aceberg/DiaryMD/refs/heads/main/assets/Screenshot_05.png)\n\n## More screenshots\n

Expand

\n\n![Screenshot](https://raw.githubusercontent.com/aceberg/DiaryMD/refs/heads/main/assets/Screenshot_04.png)\n![Screenshot](https://raw.githubusercontent.com/aceberg/DiaryMD/refs/heads/main/assets/Screenshot_03.png)\n![Screenshot](https://raw.githubusercontent.com/aceberg/DiaryMD/refs/heads/main/assets/Screenshot_02.png)\n\n

\n\n## Quick start (Docker)\n

Expand

\n\n```sh\ndocker run --name DiaryMD \\\n -e \"TZ=$YOURTIMEZONE\" \\ # your TZ here\n -e \"REPOPATH=/repo\" \\ # path to diary dir\n -v ~/.dockerdata/DiaryMD:/data/DiaryMD \\ # config\n -v ~/.dockerdata/DiaryRepo:/repo \\ # diary\n -p 8854:8854 \\\n -u $(id -u):$(id -g) \\ # run as current user, so created files will be owned by user, not root\n aceberg/diarymd\n```\nMounted volumes must have write permission for non-root user:\n```\nsudo chown $(id -u):$(id -g) ~/.dockerdata/DiaryMD\nsudo chown $(id -u):$(id -g) ~/.dockerdata/DiaryRepo\n```\n\n

\n\n## Install Binary\n

Expand

\n\nAll binaries are available in the [latest](https://github.com/aceberg/DiaryMD/releases/latest) release.\n

\n\n## Auth\n

Expand

\n\n**DiaryMD** does not have built-in auth option. But you can use it with SSO tools like Authelia, or my simple auth app [ForAuth](https://github.com/aceberg/ForAuth). \nHere is an example [docker-compose-auth.yml](https://github.com/aceberg/DiaryMD/blob/main/docker-compose-auth.yml).\n\n

\n\n## Config & WorkSpaces\n

Expand

\n\nApp config and config for `Default` workspace can be done through environment variables or `config.yaml` file. Also, `Default` workspace config and colors can be set through `GUI`.\n\nOther workspaces have their own paths and themes, which can be configured through `GUI` (recommended) or `workspaces.yaml` file.\n\n> :warning: **Note** \n> While `Default` workspace stores open tabs in browser, other workspaces keep them in `workspaces.yaml` file, so, if you want to access the same tabs from different devices, do not use `Default`.\n\n#### App config\n| Variable | Description | Default |\n| -------- | ----------- | ------- |\n| TZ | Set your timezone for correct time | |\n| HOST | Listen address | 0.0.0.0 |\n| PORT | Port for web GUI | 8854 |\n\n#### Default workspace config\n| Variable | Description | Default |\n| -------- | ----------- | ------- |\n| REPOPATH | Path to diary dir or repo | |\n| BLOGPATH | Path to dir with `blog.json` file | |\n| PAGE_STEP | Items per page in blog | 3 |\n| THEME | `dark`, `gray`, `lake`, `night`, `sand` or `CUSTOM` | sand |\n\nIf `THEME`=`CUSTOM`, colors can be set individually.\n\n#### Colors\n\n| Variable | Description | Default |\n| -------- | ----------- | ------- |\n| C_FONT | Font color | #313136 |\n| C_MENU | Menu color | #dfb377 |\n| C_EDIT | Editor back color | #faeddc |\n| C_BACK | Background color | #f8e6cc |\n| C_OUTLINE | Outline color | #616161 |\n\n

\n\n## Options\n

Expand

\n\n| Key | Description | Default | \n| -------- | ----------- | ------- | \n| -d | Path to config dir | /data/DiaryMD | \n\n

\n\n\n## Blog\n

Expand

\n\nBlog option is still under development and a bit experimental. \nTo enable blog in the workspace, set `BLOGPATH` to directory, where `blog.json` file is stored.\n\nExample of `blog.json` file. Here `path` is relative path inside the dir, specified in `BLOGPATH`. File `blog.json` must be at the root of the dir.\n\n```json\n[{\n \"date\": \"2024-11-03\",\n \"name\": \"Auth for WatchYourLAN and other apps\",\n \"path\": \"/IT/ForAuth.md\",\n \"tags\": [\"my-apps\"]\n},\n{\n \"date\": \"2024-10-06\",\n \"name\": \"WatchYourPorts\",\n \"path\": \"/IT/WYP.md\",\n \"tags\": [\"my-apps\"]\n},\n{\n \"date\": \"2024-10-02\",\n \"name\": \"Replace HDD in RAID1\",\n \"path\": \"/IT/Raid-replace.md\",\n \"tags\": [\"linux\", \"hardware\"]\n}] \n```\n

\n\n\n## Thanks\n

Expand

\n\n- [EasyMDE](https://github.com/Ionaru/easy-markdown-editor) editor\n- All go packages listed in [dependencies](https://github.com/aceberg/DiaryMD/network/dependencies)\n- Favicon and logo: [Flaticon](https://www.flaticon.com)\n- [Bootstrap](https://getbootstrap.com/)\n\n

","has_starred","hub_user","immutable_tags_settings",{"_202":11,"_203":204},"enabled","rules",[205],".*","is_automated","permissions",{"_209":17,"_210":11,"_211":11},"read","write","admin","user","storage_size",654120196,"isOrg","reponame","tag","canDeleteTags","isHubSbxKitsEnabled","currentTab","tagAttestations","displaySecurityMetadata","routes/_layout.layers.$namespace.$reponame.$tag.(images).($imageUrlDigest)._index",{"_22":23,"_164":-7,"_162":-7,"_163":-7,"_24":225,"_30":74,"_237":238,"_243":11},{"_26":27,"_28":29,"_30":31,"_32":33,"_34":35,"_36":226,"_97":98,"_99":29,"_100":101,"_102":103,"_104":105,"_106":107,"_108":96,"_109":98,"_110":54,"_111":17},[227,228,229,230,231,232,233,234,235,236],{"_39":40,"_30":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":43,"_51":-5,"_52":33,"_53":54,"_55":-5},{"_39":57,"_30":58,"_42":43,"_44":59,"_46":47,"_48":49,"_50":43,"_51":-5,"_52":60,"_53":54,"_55":-5},{"_39":62,"_30":63,"_42":43,"_44":64,"_46":65,"_48":49,"_50":43,"_51":-5,"_52":66,"_53":54,"_55":-5},{"_39":68,"_30":69,"_42":43,"_44":70,"_46":65,"_48":49,"_50":43,"_51":-5,"_52":71,"_53":54,"_55":72},{"_39":68,"_30":74,"_42":43,"_44":75,"_46":65,"_48":49,"_50":43,"_51":-5,"_52":76,"_53":54,"_55":77},{"_39":79,"_30":80,"_42":43,"_44":81,"_46":47,"_48":79,"_50":43,"_51":-5,"_52":82,"_53":54,"_55":-5},{"_39":79,"_30":84,"_42":43,"_44":85,"_46":47,"_48":79,"_50":43,"_51":-5,"_52":82,"_53":54,"_55":-5},{"_39":79,"_30":87,"_42":43,"_44":88,"_46":47,"_48":79,"_50":43,"_51":-5,"_52":89,"_53":54,"_55":-5},{"_39":79,"_30":91,"_42":43,"_44":92,"_46":65,"_48":79,"_50":43,"_51":-5,"_52":93,"_53":54,"_55":-5},{"_39":79,"_30":95,"_42":43,"_44":96,"_46":65,"_48":79,"_50":43,"_51":-5,"_52":93,"_53":54,"_55":-5},"imageWithLayers",{"_39":68,"_30":74,"_42":43,"_44":75,"_46":65,"_115":239,"_48":49,"_50":43,"_51":-5,"_52":76,"_53":54,"_55":77},[240,241,242],{"_30":118,"_52":119,"_120":121},{"_30":140,"_52":141,"_120":125},{"_52":127,"_120":128,"_30":43},"hasPermissionToViewRepoSettings","actionData","errors"]

aceberg/diarymd:0.1.3