版本更新 | HackMD Blog
Coming Next

Coming next

  • The Markdown editor with a new design and various improvements.
  • Table of Contents in Preview, Both and Edit mode.


✍️ 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 ↗️