# Plugin: Share note online via HackMD
**URL:** https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048
**Category:** Plugins
**Created:** [27 November 2021 12:06 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048 "2021-11-27T12:06:59Z")
**Posts on this page:** 20
**Page:** 1
### Author:  [@xardbaiz](https://discourse.joplinapp.org/u/xardbaiz)
#### Post date: [27 November 2021 12:06 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/1 "2021-11-27T12:06:59Z")
Hello everyone 👋
I'm a new user of Joplin since 11 Nov 2021. This is a great app that I've always looked for 🙌
Here's the first plugin I wrote. Basically for myself, because I often share quick notes with my colleagues
# Joplin ➡ HackMD
> **[GitHub - xardbaiz/joplin-plugin-hackmd: Quick share notes on HackMD](https://github.com/xardbaiz/joplin-plugin-hackmd)**
>
> Quick share notes on HackMD
HackMD Joplin Plugin is an _unofficial_ plugin to extend the export tools of [Joplin's](https://joplinapp.org/) desktop application.
It allows sharing notes online on the HackMD website
## Features
- Saves HackMD user credentials in secured store
- Uploads note online using HackMD website (one-way share: Joplin ➡ HackMD)
> - Content: {temporary} text only _(see [Roardmap](#roadmap-8))_
> - Access for a new note by default: read - everyone; write - owner only;
- Content of already uploaded note could be updated by re-share
## Usage
### Register on [HackMD.io](https://hackmd.io)
Then create personal access token ([instruction](https://hackmd.io/@hackmd-api/developer-portal/https%3A%2F%2Fhackmd.io%2F%40hackmd-api%2Fhow-to-issue-an-api-token))
### Fill HackMD plugin settings
Open `Tools > Options > HackMD sync` and fill the `HackMD User Access Token` field
### Share
Select target note and press the `Share on HackMD` button
Wait. If everything is ok - note body will contain link to note on HackMD
## RoadMap _(sorted from high priority to low)_:
- Share with pictures
- Export tags _(partially completed)_
- Option to share on private CodiMD server
- Bulk share
- Continuous syncing _(one-way periodical sync Joplin ➡ HackMD)_
- Both ways sync (Joplin ↔ HackMD)
- [Bidirectional links](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/32)
## Thanks
- @benji300 for cool README structure in [Plugin: Note Tabs](https://discourse.joplinapp.org/t/plugin-note-tabs/12752)
(I've borrowed this page from there 👼 )
- [HackMD.io](https://hackmd.io) resource owners for a free price plan and [API](https://documenter.getpostman.com/view/68277/UVeNmhpT) 🙂
---
### Author:  [@whitewall](https://discourse.joplinapp.org/u/whitewall)
#### Post date: [27 November 2021 13:11 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/2 "2021-11-27T13:11:07Z")
Thanks for making this! It's amazing to see all the different ways people use Joplin.
Have you added the share to HackMD to the command palette? (ctrl shift p)
---
### Author:  [@xardbaiz](https://discourse.joplinapp.org/u/xardbaiz)
#### Post date: [27 November 2021 13:19 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/3 "2021-11-27T13:19:38Z")
@whitewall Thanks for your quick feedback
> Have you added the share to HackMD to the command palette?
~~Not yet. But thanks for the idea. I'll add that soon if someone needs it 😉~~
**UPD** Wow. It's actually already added 🙂 _(automatically by Joplin's command registration)_
---
### Author:  [@samej](https://discourse.joplinapp.org/u/samej)
#### Post date: [20 January 2022 04:40 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/5 "2022-01-20T04:40:43Z")
Congratulations on the plugin, I just installed and tested it and it worked perfectly. The only thing I haven't found, so to speak, is a way for tags added in Joplin to be applied to text in HackMD. Would it be possible to add this feature in a future plugin update?
Again, congratulations and many thanks for this excellent plugin! 😉
---
### Author:  [@xardbaiz](https://discourse.joplinapp.org/u/xardbaiz)
#### Post date: [20 January 2022 07:46 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/6 "2022-01-20T07:46:53Z")
@samej Wow. Thanks for the kind feedback 🤝 and congrats on the first comment on the Joplin community forum! 🙌
I've added your feature request to the roadmap _(see 1st post)_ I will add this in the next update, approximately next week
---
### Author:  [@samej](https://discourse.joplinapp.org/u/samej)
#### Post date: [20 January 2022 15:25 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/7 "2022-01-20T15:25:18Z")
@xardbaiz very grateful for the reception and for adding my request to the roadmap (_I already checked the edit in the first post above_ 😉).
As for the date of the update, let it be in your time.
---
### Author:  [@rxliuli](https://discourse.joplinapp.org/u/rxliuli)
#### Post date: [21 January 2022 05:10 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/8 "2022-01-21T05:10:45Z")
A great idea, I might consider implementing a github gist in the vscode plugin to quickly share a single note.
* * *
Update, someone has already done it in vscode
> **[GistPad - Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=vsls-contrib.gistfs)**
>
> Extension for Visual Studio Code - Manage your code snippets and developer notes using GitHub Gists and repositories.
---
### Author:  [@tessus](https://discourse.joplinapp.org/u/tessus)
#### Post date: [21 January 2022 18:56 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/9 "2022-01-21T18:56:45Z")
I was thinking about writing a plugin to share via gist, but gists can't do images (as in I can't upload images), thus I guess I won't write it after all.
This HackMD plugin is a great alternative.
---
### Author:  [@xardbaiz](https://discourse.joplinapp.org/u/xardbaiz)
#### Post date: [22 January 2022 09:04 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/10 "2022-01-22T09:04:13Z")
@tessus
Thanks 🙂
FYI: HackMD also doesn't support [image](https://imgur.com/) uploading that's why they use imgur as external image hosting. It's visible in the browser DEV console when image attachment is in progress
---
### Author:  [@tessus](https://discourse.joplinapp.org/u/tessus)
#### Post date: [23 January 2022 00:24 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/11 "2022-01-23T00:24:30Z")
I wanted to avoid writing a wrapper for imgur when publishing a gist. I wanted to have everything on gh. e.g. I can paste/upload images to issues.
HackMD does not natively do images, but I think they provide an API.
---
### Author:  [@koyj](https://discourse.joplinapp.org/u/koyj)
#### Post date: [24 January 2022 17:30 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/12 "2022-01-24T17:30:24Z")
I can't find the screen to config - can you help ?
Joplin 2.6.10 (prod, win32)
plugin version : 1.0.1
---
### Author:  [@xardbaiz](https://discourse.joplinapp.org/u/xardbaiz)
#### Post date: [3 February 2022 18:13 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/13 "2022-02-03T18:13:57Z")
@koyj it should be there. Try to reinstall the plugin
---
### Author:  [@xardbaiz](https://discourse.joplinapp.org/u/xardbaiz)
#### Post date: [3 February 2022 18:24 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/14 "2022-02-03T18:24:04Z")
@samej **your feature request status** :
I've done with tags adding to note metadata but seems like they are appearing on HackMD **only after indexation** , which can be caused by manual editing _(at least one symbol change)_ on the web interface. See GIF:
[](https://gifyu.com/image/SzzGF)
_([test note is here](https://hackmd.io/GMzbTMyASGWWqcYrzzRDAg?view))_
So it requires more time to call HackMD indexation from the plugin via WebSockets.
WebSockets operations aren't in the SDK, so I don't even know yet is it possible or not.
If it's ok for you to manually open the note each time after uploading - you can [manually install](https://github.com/xardbaiz/joplin-plugin-hackmd#manual) version [1.1.0b](https://github.com/xardbaiz/joplin-plugin-hackmd/releases/tag/1.1.0b)
---
### Author:  [@graphit0](https://discourse.joplinapp.org/u/graphit0)
#### Post date: [3 February 2022 22:39 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/15 "2022-02-03T22:39:38Z")
@xardbaiz
Out of curiosity, what's your opinion on HackMD open source forks?
- [HedgeDoc](https://demo.hedgedoc.org/): independent fork. It has quite a few public servers aside from the main demo one.
- [CodiMD](https://github.com/hackmdio/codimd): the main open source core
I don't follow the main differences, except forks allow much more freedom than HackMD (number of collaborators, size, etc). I'm just curious if you have considered the forks in your project and had a strong opinion about them or they just didn't appear on your radar?
---
### Author:  [@xardbaiz](https://discourse.joplinapp.org/u/xardbaiz)
#### Post date: [4 February 2022 07:16 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/16 "2022-02-04T07:16:13Z")
@graphit0 Yes I've explored them. But only [Hack MD](https://hackmd.io/) has a free web version with persistent notes storage. **CodiMD** & **HedgeDoc** work only on-premise, in local environment == not global.
That's why I chose HMD. To share links globally
**BTW** : talking about [your feature request](https://github.com/xardbaiz/joplin-plugin-hackmd/issues/3): I'm currently trying to run [CodiMD](https://hub.docker.com/r/linuxserver/codimd) or [HedgeDoc](https://hub.docker.com/r/linuxserver/hedgedoc) locally with Docker Compose to check my plugin compatibility. But they don't want to connect to the DB ☹
Maybe someone could help me with running those apps in Docker?
---
### Author:  [@graphit0](https://discourse.joplinapp.org/u/graphit0)
#### Post date: [4 February 2022 10:15 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/17 "2022-02-04T10:15:43Z")
> [@xardbaiz](#):
>
> **CodiMD** & **HedgeDoc** work only on-premise, in local environment == not global.
Well, once again HedgeDoc does offer [demo server](https://demo.hedgedoc.org/)/free web version and have [a list of intended for public use servers](https://community.hedgedoc.org/t/public-instances/282) (although they are not so easy to properly register on). But I agree that the service is young and not quite as reliable as HackMD. Infact, they cannot guarantee that the notes won't be deleted. In any case, gotcha!
> [@xardbaiz](#):
>
> Maybe someone could help me with running those apps in Docker?
Here's their support forum where you can describe the problem in detail and have someone guide you through the process.
> **[Support](https://community.hedgedoc.org/c/support/6)**
>
> HedgeDoc support for everyone who prefers forums over chat. This should help to build a long-term support knowledge base.
There's also a [matrix chat](https://matrix.to/#/!oaRMJImPLfUnnXzwnN:shivering-isles.com?via=matrix.org&via=kif.rocks&via=envs.net) for quick questions
In fact there's [an ongoing tread](https://matrix.to/#/!oaRMJImPLfUnnXzwnN:shivering-isles.com/$Fqf01i5v2Zio5h5wgDFc3y_iOCrdvSEOCVwyA7b4PUc?via=matrix.org&via=atteroth.de&via=shivering-isles.com) about the docker image at the moment
---
### Author:  [@samej](https://discourse.joplinapp.org/u/samej)
#### Post date: [7 February 2022 20:34 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/18 "2022-02-07T20:34:52Z")
Hi @xardbaiz, sorry for the delay in responding.
The last week has been **extremely unusual** for me. 😢
I liked the result. I downloaded v1.1.0b and will do my tests, then (in the next few hours) I'll bring you feedback.
Thank you very much for your attention and dedication. 😉
---
### Author:  [@samej](https://discourse.joplinapp.org/u/samej)
#### Post date: [8 February 2022 01:30 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/19 "2022-02-08T01:30:09Z")
Hello again @xardbaiz, as promised, here I am to bring you my feedbacks.
For some reason (I don't know), the plugin didn't work. The menu for entering HackMD login and password is not displayed in the corresponding location and the share icon does not appear on the toolbar.
Installed Plug-ins
Initially, I thought it was something related to the outdated version of Joplin, so I updated the app and it still didn't fix it. I installed other plugins that add icons to the toolbar and they worked perfectly.
Toolbar and About Joplin v2.6.10 (AppImage)
I also tested the stable version of your plugin and the result remained the same, no login/password menu and no toolbar icon.
Here are some screenshots of my computer's settings:
Neofetch
Screenfetch
**Note:** the last time I tested **Joplin-HackMD** , it was on another HD that is not installed on my computer at the moment.
If you can guide me to carry out more tests, I would appreciate it! 😉
Regards.
---
### Author:  [@xardbaiz](https://discourse.joplinapp.org/u/xardbaiz)
#### Post date: [8 February 2022 11:09 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/20 "2022-02-08T11:09:09Z")
@samej Have you tried to uninstall 1.0.1, restart Joplin and install 1.1.0b manually?
---
### Author:  [@samej](https://discourse.joplinapp.org/u/samej)
#### Post date: [9 February 2022 01:41 UTC](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048/21 "2022-02-09T01:41:49Z")
@xardbaiz, yesterday I did this three times, to be exact. And the result was the same.
Today I tested again and the result I reported above remains.
[Next page](https://discourse.joplinapp.org/t/plugin-share-note-online-via-hackmd/22048.md?page=2)