Changelog | HackMD Blog
Coming Next

Coming next

  • Get ready for a game-changing commenting upgrade on HackMD!


Why just subscribe when you can follow Like a pro?

Gone are the days when you could only subscribe to notes. Step into the spotlight by following users or teams. Get real-time notifications of new notes or hot discussions from the people you follow.

This feature isn’t just for individuals; it’s also perfect for teams looking to expand their audience. Once you make your thoughts public, your community will be alerted and flock to read what you’ve got to say. Don’t forget to enable the commenting feature to spark and encourage discussion among your readers.

Improvements & Fixes

  • Update metadata when reconnected
  • [Beta] Batch update tags
  • Fix: correctly include note titles in notification emails.


Comments count

The new commenting experience is coming soon, but let’s start with some minor changes to get you warmed up. You’ll be able to see how many comments there are on a note from both the grid and row layout. Clicking on the icon will automatically open the note for you, making it easier to review the comments.

Consider turning on comments in the Share menu, as shown in the screenshot below.

Improvements & Fixes

  • Note menu no longer breaks in Grid layout. Kudos to 西里鳥.


Due to lower than expected user adoption of the Beta Overview and Beta Editor, the team recently reviewed the product and decided to focus on building a platform that facilitates team discussion and decision making within the community.

With HackMD, team members can efficiently collaborate both synchronously and asynchronously. Our next step is to foster vibrant team, cross-team, and community discussions to enable people to make better decisions through the efficient exchange of opinions.

This new journey will begin in two weeks with the launch of a new commenting panel.

Title and tags resettled

After tweaking the interface for editing metadata (title, tags, etc.), we received a lot of user feedback. Being able to write immediately upon opening a note was highly appreciated, so we decided to go back to the way it was and leave the title or tags for later.

You can now edit the title and tags in the navigation bar with a single click. This change also fixes the problem of duplicate titles in view mode. You can still control whether tags are displayed in view mode in “Note settings”. Learn more

Improvements & Fixes

  • Edit note titles in the note list.


Providing a metadata editing interface is a significant change for HackMD users. After the update went live, we collected user feedback and prioritized fixing the most important issues.

Improvements & Fixes

  • After creating or adding tags, clear the input string in the tag field.
  • When removing a tag by clicking on the “X,” do not open the tag menu.
  • Searching for tags is now case-insensitive. Note that tags are still case-sensitive, but searching is case-insensitive to help users find desired tags faster.
  • You can now access Note settings from the menu of the note.
  • Fixed: use the title for notification center and email notifications.
  • Fixed: a delay in updating the displayed title after exiting the title field.
  • Fixed: after removing the title, the focus of the cursor is regained after approximately 2 seconds.
  • Fixed: users with only read access should not see the Note settings (including the “i” icon and menu items) of the note.
  • Fixed: when modifying the permalink in My workspace and then clicking “Copy link,” the copied link should reflect the modified permalink instead of the previous link
  • Fixed: duplicate insertions of sections of notes.
  • Fixed: “Loading embedded note” is displayed in View mode when an embedded note is loaded.
  • Fixed: team members with edit permissions can now edit metadata. Roles that can edit metadata in a team workspace: Editor, Admin, Invitee admin.


🧚 Effortless tagging

Experience the convenience of HackMD’s intuitive tagging interface. Navigate through existing workspace tags, effortlessly apply them to your notes, and unlock a new level of organization and productivity.

With new interfaces for title, tags and other metadata, HackMD no longer uses YAML frontmatter as the note’s metadata. You will have to edit them from the note’s Settings.

You may also want to check out these tutorials:

🚚 Move multiple notes to another workspace

Admins and the librarian can now move multiple notes to another workspace at once. If you have more than one workspace or often move notes between My Workspace and a Team Workspace, this feature helps.

Try it out by turning on Preview features.

Improvements & Fixes

  • Double the length: notes in paid workspaces just got an increase in the maximum number of characters per note, 200 thousand characters for your limitless ideas.
  • Fixed a bug in beta editor that caused MathJax equations to disappear. Big thanks to Yngve.
  • Fixed a bug in beta editor that didn’t handle <br /> properly.
  • Fixed a Gist syntax XSS. Kudos to @maple3142, again.


🔐 Free users also have gated images

Free users now upload images to HackMD instead of Imgur, and they are gated with the same permissions as the note they are in. By default, only the note owner can access the note and any images uploaded to the note.

What about the images uploaded to Imgur?

HackMD transferred them for you. All images uploaded to Imgur are rendered from HackMD. This service is only available to paid users.

Check the result of the transition on the workspace settings page. You will also receive this notification in the Notification Center and via email.

Many of us have shared links to the note only to find out that the permission did not work as we expected after someone warned us. We don’t want that kind of surprise.

To reduce these incidents, we redesigned the sharing modal. This time from your perspective and crystal clear.

🌑 Dark mode (work in progress)

We hear you. There is now a dark mode available in the new design. It’s far from perfect, but we’ll continue to improve it as we get the chance.

Improvements & Fixes

  • More responsive: we have made some tweaks to improve the rendering efficiency of the notes list in the new design.
  • Fix: The profile avatar was broken and is now fixed.


We have shipped a new table of contents for the new design. Try it out by turning on Preview features.

🏂 Table of contents in all modes

Navigation is crucial for both reading and writing, even more so when working on a long form. Now you have a nice table of contents in Both, Preview and Edit mode. It is floated by default for more flexibility, and can be pinned to reduce distraction, as in the screenshot.

Also in the new design:

  • 👥 Team workspace and Trash
  • 🧹 Remove icons for work-in-progress features to tidy things up.

Improvements & Fixes


What we shipped to the new design

Get a sneak peek of HackMD’s new design by toggling on Preview features.

  • 🎡 Sync scrolling
  • 💆‍♀️ Note title
  • 📝 YAML metadata
  • 🔦 Code block: syntax highlight
  • 🟰 Code block: copy code
  • 💕 Preview and Both mode

What have been improved in the current HackMD

Improvements & Fixes

  • Export to Arweave, share right away: now you get a page of what you have just exported to Arweave instantly, and can be confident that its Markdown source code is identical to the transaction once settled. Previously, you have to wait until the transaction is settled to view this page.


✍️ Edit HackMD notes in VSCode

Now you can edit HackMD notes in My Workspace in VSCode.

Tabs for coding and for taking notes can now sit next to each other, boosting your productivity by eliminating window- and context-switching.

Remember to update HackMD VSCode extension to v2.1.0.

👉 Transfer team ownership on your own

The user who created the team workspace is the owner of it and has the highest permission over the workspace.

As the owner is about to change assignment, departure, etc., she can transfer ownership to other Admins.

Here’s how

Improvements & Fixes

  • Fix: an marketing email issue that might interrupt signup process.

What’s new in Feature Preview

  • Trash is ready. Now you can delete muiltiple notes at one time and later restore some of them from Trash.
  • Fix: various bugs in Overview.


😻 More than a new look

↑ Hello World!

We have been working on the new design for HackMD, which will be more than a fresh look. Operate with multiple notes at a time and wield many more new superpowers.

You can now have a bite of the new HackMD by toggling it on in Preview Features.

We’d like to hear your voice. There is a Help & feedback button to the lower-left. Click it to report bugs and request features.

Are you curious of the motivation behind this move and the breaking changes to come? Here’s the long version.

Improvments & Fixes

  • Clear API calls count: Now you can see how many tokens have been created and the API calls used/left in this cycle. We also updated the pricing page showing the call limits on Free and on Prime plans.
  • Fix: a behavior when pasting images from OneNote.


🚪 Access notes in VSCode like a pro

Not exactly as promised, but we delivered a more powerful VSCode extension for HackMD.

As shown above in the screenshot, now you can access the notes in the My Workspace, Recent notes, and notes in any one of your team workspace you are a member of, from the side pane in VSCode.

The extension now ask an API token to access your notes.

Improvements & Fixes

  • Swift retriever: made some tweaks and now HackMD parses hyperlinks faster.
  • Fix: an error that may occur when importing from Google Drive. Thanks Josh for reporting this bug.
  • Fix: updating notes via API will not override authorship now.
  • Fix: M-f will act as expected under Emacs mode.


🎂 7th anniversary

With you, HackMD has grown a year older. Many of you have published excellent content on HackMD, which has become a lush community, vibrant with insightful posts.

We’ve curated creative use cases under the “Community documentaries” section. Have a look at how others use HackMD.

Also, there’s a first-month-free promo code for those who haven’t tried HackMD.

Explore →

Improvements & Fixes

  • Fix: we fixed a bug that causes the styles within a book mode to go wrong. Thanks Ivan and @wendyusinggithub for reporting it.


🐾 🐾 Read more from the author

More published notes from the author are shown at the bottom of any published one. You can more readily discover other works from impressive authors. On the other hand, to our authors, your work will be spotted more easily by your audience.

🚢 Publish notes permanently and immutably

Export to Arweave makes your contents permanently accessible to everyone.

Arweave utilizes blockchain technolgies and provides permanent storage at a reasonable price.

You may like to export the note to Arweave when you would like the notes to be immutable and be hosted on a different network accessible to every one.

:bulb: Consider exporting to Arweave when publishing sensitive, controversial, or anything not intended for anyone, including yourself, to change.

You can also import notes that you have exported from HackMD to Arweave.

Learn more →

Improvements & Fixes

  • Fix: a bug of notification for new comments on a note.


💅 UI polishing

Have you noticed the little tweaks at the upper-right corner of the editor?

As the default permission set to “Only me” can read and edit for notes created in My Workspace, HackMD is still a product born out of the eagerness to share one’s thoughts with the world. So we has made the “Share” button bigger and more catchy. Press it more often to share what you care about with other people.

We have relocated the permission note into the Sharing menu. You can get how others may or may not access your note in a concise sentence.

Do you like the tweaks? DM us on Twitter or email us to share your thoguhts.


🔒 Better privacy

Now notes’ permissions are set to only you can read and write so you don’t have to worry about their accidentally seen by strangers.

On the async hand, now users have to sign in first to comment on a published note. You can change this setting at the Sharing menu.

🏃‍♀️ More active SEO for published notes

Now HackMD more actively sends metadata of published notes to search engines. People around the world have a greater chance to discover your published notes than before. Keep writing, keep publishing!

Improvements & Fixes

  • Stay relevant: now you can sort full-text search results by relevance and we’ve made it the default sorting option.
  • Stay relevant when back online: if you were the only one connected to the note and happened to lose connection, when you are back online, HackMD will write your work during disconnection back to the note.
  • Update Permalink via API: very handy for those who publish notes on HackMD.
  • Draw Gitgraph in mermaid: we’ve updated mermaid.js to version 9.1 so that you can draw Gitgraph like this:
commit id: "Normal" tag:"v1.0.0"
commit id: "Reverse" type: REVERSE
branch develop
commit id: "Highlight" type: HIGHLIGHT
checkout main
merge develop
  • Sometimes you would like better legibility: we added an option to auto-wrap in code blocks. You can add a ! at the end of the name of the programming language manually, too.
  • Fix: we fixed various issues to ward off XSS insecurities. Thanks to our user maple3142 and @splitline for reporting these vulnerabilities. HackMD has become more secure thanks to your efforts.
  • Fix: the cursor position now correctly lands at the end of the next line after closing the menu of a code block. Thanks @markz for reporting this bug.
  • Fix: mermaid rendering height error in Firefox. Thanks @pnkfelix for reporting this bug.


💰 Yearly payment

Many of Team/Billing admins have been applying for reimbursement every month. We don’t like bureaucracy either.

To reduce the paperwork to once per year, now you can pay annually and enjoy a nice discount.

You can change from billing monthly to yearly at any time, but only until the end of the yearly billing cycle if you’d like to change it back.

Learn more about paying yearly →

Improvements & Fixes

  • Number it or not: we improved the contextual menu to the code block to choose adding line number more aptly.


Team Admins can now create a link to invite new members to the team and don’t have to know their emails or usernames beforehand.

Invite link works best with large organizations and when new members come frequently and regularly.

Generate one and pin it to the Slack/Discord channel of your docs team.

Improvements & Fixes

  • You can now switch between match only titles and tags or full-text search. With a specific scope, comes more accurate results. 👣👣 🔍
  • In the meantime, at Zapier, you have got new triggers and actions:
    • Trigger: Get Team Notes
    • Action:
      • Get Team Note
      • Get My Note
      • Create Team Note
      • Update Team Note
  • Fix: uploaded images are properly restored when restoring notes from Trash.


🕶️ Spoiler alert

HackMD has spoiler alert at the block level (begins with :::spoiler [optional title], in case you don’t know), and now you have its inline counterpart.

Clap words between || and they will be masked in View mode until clicked.

Handy for making customized flashcards, even better with the API to automatically append new words to the note.

Speak of the API, it has got some updates.

🔧 Change note permissions with the API

You can now change note permissions in bulk with the Update endpoint. This can be useful for Team Admins and in cases, for example, when you need to un-publish numerous notes.

Improvements & Fixes

  • Fix: scrolling out of sync in Both Mode when encountering an opened Spoiler block with list items inside.
  • Fix: a bad feedback when creating an API token without giving it a name.


Improvements & Fixes

  • Large notes: now can be correctly indexed and searched in full-text search.
  • Fix: default note permission in Enterprise Edition now respect the server config.
  • Fix: notes transferring between teams and users now can be correctly indexed and searched in full-text search.


Improvements & Fixes

  • Reduce unnecessary API calls in full-text search.
  • Fix: a bug in the full-text search indexer which falsely remove records.


Now you can search in note contents besides titles and tags in paid Workspaces.

We are collecting user feedback regarding search experience. Please share your thoughts ↗️

Improvements & Fixes

  • Fix: now only team admins see the add team member shortcut button.

Release notes

Read full release notes ↗️