\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",{"_203":11,"_204":205},"enabled","rules",[206],".*","is_automated","permissions",{"_210":17,"_211":11,"_212":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",{"_23":24,"_165":-7,"_163":-7,"_164":-7,"_25":226,"_31":64,"_238":239,"_244":11},{"_27":28,"_29":30,"_31":32,"_33":34,"_35":36,"_37":227,"_98":99,"_100":30,"_101":102,"_103":104,"_105":106,"_107":108,"_109":97,"_110":99,"_111":55,"_112":17},[228,229,230,231,232,233,234,235,236,237],{"_40":41,"_31":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":44,"_52":-5,"_53":34,"_54":55,"_56":-5},{"_40":58,"_31":59,"_43":44,"_45":60,"_47":48,"_49":50,"_51":44,"_52":-5,"_53":61,"_54":55,"_56":-5},{"_40":63,"_31":64,"_43":44,"_45":65,"_47":66,"_49":50,"_51":44,"_52":-5,"_53":67,"_54":55,"_56":-5},{"_40":69,"_31":70,"_43":44,"_45":71,"_47":66,"_49":50,"_51":44,"_52":-5,"_53":72,"_54":55,"_56":73},{"_40":69,"_31":75,"_43":44,"_45":76,"_47":66,"_49":50,"_51":44,"_52":-5,"_53":77,"_54":55,"_56":78},{"_40":80,"_31":81,"_43":44,"_45":82,"_47":48,"_49":80,"_51":44,"_52":-5,"_53":83,"_54":55,"_56":-5},{"_40":80,"_31":85,"_43":44,"_45":86,"_47":48,"_49":80,"_51":44,"_52":-5,"_53":83,"_54":55,"_56":-5},{"_40":80,"_31":88,"_43":44,"_45":89,"_47":48,"_49":80,"_51":44,"_52":-5,"_53":90,"_54":55,"_56":-5},{"_40":80,"_31":92,"_43":44,"_45":93,"_47":66,"_49":80,"_51":44,"_52":-5,"_53":94,"_54":55,"_56":-5},{"_40":80,"_31":96,"_43":44,"_45":97,"_47":66,"_49":80,"_51":44,"_52":-5,"_53":94,"_54":55,"_56":-5},"imageWithLayers",{"_40":63,"_31":64,"_43":44,"_45":65,"_47":66,"_116":240,"_49":50,"_51":44,"_52":-5,"_53":67,"_54":55,"_56":-5},[241,242,243],{"_31":119,"_53":120,"_121":122},{"_31":134,"_53":135,"_121":126},{"_53":128,"_121":129,"_31":44},"hasPermissionToViewRepoSettings","actionData","errors"]

aceberg/diarymd:0.1.3