Now you can directly copy the saved version of a record.
There is a copy link button on the top right, click it to copy the version link and share it with others. As long as the other person has read access, they can view it.
Image Not ShowingPossible Reasons
The image was uploaded to a note which you don't have access to
The note which the image was originally uploaded to has been deleted
You can sync your note from the editor of an empty note, or from the Versions and GitHub Sync panel. Then, choose the version you want to Push or Pull.
Image Not ShowingPossible Reasons
The image was uploaded to a note which you don't have access to
The note which the image was originally uploaded to has been deleted
On your first time linking HackMD with GitHub, you will be asked to authorize HackMD GitHub App to access your GitHub account AND the repos you want HackMD to link to. There are two levels of authorization needed: the account and the repositories.
HackMD cannot verify users through GitHub APP due to its limitations. So please connect to GitHub with the account that has Admin permission to the repo. For a team's notes, team admin, team member and invitee admin permissions will do.
1. Account Level Authorization
HackMD GitHub App needs your authorization to see the repos you have access to, including your personal repos and those of Organizations you belong to.
2. Repo Level Authorization (Installation)
Once you authorize the HackMD GitHub App to see which repos you have access to, GitHub would let you choose which repos you would authorize, or "install", the app on. Install on as many repos as you like, or come back later to authorize more repos.
On your first time pushing a note to or pulling a file from GitHub, you will choose which repo, branch, and file you want to link with the current HackMD note. You can also create a new target branch or file to push the note to by simply typing the name of the branch or file to create them.
Image Not ShowingPossible Reasons
The image was uploaded to a note which you don't have access to
The note which the image was originally uploaded to has been deleted
You can sync and edit .md/.mdx/.rmd/.markdown files in HackMD. However, HackMD does not support rendering of MDX and R syntax.
Keep your note sync with GitHub
After you link the note, the target repo and file will show on the Versions and GitHub Sync panel. You can always push further changes to, pull from, or unlink the note from GitHub in the Versions and GitHub Sync panel.
Image Not ShowingPossible Reasons
The image was uploaded to a note which you don't have access to
The note which the image was originally uploaded to has been deleted
After linking the note, you can add a badge to the top of the note by clicking the Add badge button in the Versions and GitHub Sync panel. When pushed to GitHub, the badge shows your community where to participate the discussion or contribute to the documentation.
Image Not ShowingPossible Reasons
The image was uploaded to a note which you don't have access to
The note which the image was originally uploaded to has been deleted
You can choose which named versions to push to GitHub before the push. Each named version would be pushed as a "commit" in Git, while the version name and description will be used as its commit message. Learn How to Save a Version.
Image Not ShowingPossible Reasons
The image was uploaded to a note which you don't have access to
The note which the image was originally uploaded to has been deleted
Hint: HackMD doesn't track which versions had been pushed, for this information would be misleading should someone else messes with the branch from GitHub, which HackMD could not know.
Pull from GitHub
You can also pull from GitHub and choose the branch you want to pull from. Moreover, you can choose which chunk of revisions to merge into your note, or apply all changes.
Image Not ShowingPossible Reasons
The image was uploaded to a note which you don't have access to
The note which the image was originally uploaded to has been deleted
Hint: HackMD will automatically save a version before you merge and name it before pull from <branch_name>. Because HackMD doesn't lock the note when applying changes, it is possible that someone else edit your note while you're merging, therefore, "undoing" the merge has to be done in the editor.
Install the App on More Repos
If you cannot find the repo you want to link to, cancel the synchronization first.
Image Not ShowingPossible Reasons
The image was uploaded to a note which you don't have access to
The note which the image was originally uploaded to has been deleted
Note: Note that your account authorization and repo installation are separated. You could have revoked the account authorization (and the app could no longer see what repos you have access to), yet keep the app installed on your repos (and you can still push to and pull from the repo).
Line Break Rendering Rules
HackMD follows the CommonMark Spec (the Spec) to render Markdown syntax so your notes would be compatible with other platforms. Yet there's one thing HackMD handles slightly differently: line breaks.
What are line breaks?
Hard line breaks
When you hit the Enter (or Return) key on your keyboard, you type a "newline" character. Since you most likely expect to start a new line, HackMD lets you continue on a new line (by rendering that "newline" character with a HTML break tag <br />). This rendering behavior is called hard line break in the Spec.
Image Not ShowingPossible Reasons
The image was uploaded to a note which you don't have access to
The note which the image was originally uploaded to has been deleted
There's another way to render the "newline" character: the soft line break (or just line break). The newline character will be rendered as a Space in the HTML, instead of a new line. This is how GitHub and some other services handle line breaks.
Image Not ShowingPossible Reasons
The image was uploaded to a note which you don't have access to
The note which the image was originally uploaded to has been deleted
Since HackMD and GitHub renders line breaks differently, Your notes would look differently on the two platforms if the line break rendering rules are different. But if a note won't ever be pushed to GitHub, you don't have to worry about this.
How do I change my line break rendering rule?
You can change your default line break rendering for all your future notes in your settings.
You can click the Breaks button at the bottom of the editor to choose your line break rendering rule.
Image Not ShowingPossible Reasons
The image was uploaded to a note which you don't have access to
The note which the image was originally uploaded to has been deleted