
Mathematics is the language of the universe. It’s woven into everything we do. But its complex symbols and equations can often pose challenges in the digital world.

How do you type formulas, notations, symbols, to the power of, square roots, and the rest in a clear, concise way? It’s a time consuming venture that will probably leave you frustrated.

Enter LaTeX and MathJax.

Your comprehensive solution for all your documentation needs.

But what exactly are they, how do they work together, and how can you harness them for your documentation?

We’re glad you asked…

### What is LaTeX and MathJax?

LaTeX is a high-quality typesetting system for anyone creating mathematical documentation on the internet. And [MathJax](https://hackmd.io/c/tutorials/%2Fs%2FMathJax-and-UML) is a tool that brings the power of LaTeX to your fingertips.

In plain speak: they allow you to write complex equations and symbols directly in your online documents. Authors can create a dynamic and visually appealing representation online that closely mirrors its traditional handwritten sibling.

AKA: Bringing blackboards to the web.

At its core, MathJax uses a combination of web technologies like HTML, CSS, and JavaScript to transform LaTeX, MathML, and AsciiMath notation -- two other mathematical markup languages --into high-quality, scalable, and accessible math expressions. 

But from those three languages, LaTeX serves as the primary input format for MathJax.

Great. Now that we have that covered, let's dive into the why.

### Benefits of LaTeX

#### 1. Enhanced online learning

LaTeX and MathJax significantly elevate the online educational experience. 

For educators, it enables the creation of interactive learning materials, lecture notes, and digital textbooks with clear, beautifully rendered equations for not only math but also cryptography, physics, and even quantum mechanics. 

Students then benefit from a more intuitive and visually comprehensible representation of these concepts, facilitating better understanding and retention.
    
#### 2. Cross-browser compatibility and accessibility

And for those writing with MathJax for a far reaching audience, one of MathJax's significant advantages is its compatibility across various web browsers and devices. 

Whether it's Chrome, Firefox, Safari, or Edge, MathJax ensures a consistent and high-quality rendering of mathematical notation, making it accessible to many. It doesn't require any additional plug-ins, fonts, or special setup for the reader. 

#### 3. Streamlined documentation and research

LaTeX and MathJax serve as powerful allies for authors, researchers, and scientists, offering a suite of tools to streamline the documentation and dissemination of mathematical content.

In the era of online research, academic blogging, and breakneck innovation LaTeX and MathJax play a crucial role in presenting content for math and the like with clarity and precision.

Whether it's creating blog posts discussing complex theories for quantum mechanics, sharing physics research findings, or presenting the latest technical breakthrough in cryptography, authors can rely on LaTeX and MathJax to present equations and formulas in an elegant and professional manner. 

This not only enhances the visual appeal of the content but also ensures that the intricacies of notation are accurately conveyed to the readers.

Collaborative writing platforms and academic publishing systems can also benefit from MathJax's capabilities.

### Using LaTeX and MathJax in HackMD

As we just hinted at, authors collaborating on mathematical content can easily [share and edit equations within HackMD](https://hackmd.io/c/tutorials/%2Fs%2FMathJax-and-UML), ensuring consistency and accuracy across different contributors. 

Equations retain their high-quality rendering, enhancing readability for collaborators.

Here are a few implementations of LaTeX and MathJax:

- **Enclosed formulas:** Add two `$` before and after your equation to create in-line notations.

$$
x = {-b \pm \sqrt{b^2-4ac} \over 2a}
$$

- **Superscripts and subscripts:** Use `^` and `_` to indicate super and subscript variations.

$$
y^2 = 2x+16
$$

- **Fractions:** Write `\over` or `\frac` to create fractions.

You can explore the [full list of uses here](https://math.meta.stackexchange.com/questions/5020/mathjax-basic-tutorial-and-quick-reference). 

We [recently upgraded MathJax capabilities in HackMD](https://blog.hackmd.io/blog/2023/11/28/effortless-editing-mathjax-revealjs-hackmd-updates) to further improve speed and stability. Elevate your documentation and knowledge sharing -- start exploring LaTeX and MathJax on HackMD today.

We can't wait to see what you create.

Demystifying LaTeX: The future of online mathematics


Over the past few weeks, we've rolled out a series of updates that enhance your experience on HackMD. From effortless editing to MathJax and Slide Mode updates, you're now able to more deeply build out documentation for your team and community.

## Introducing "Edit from here"
Imagine you're reading through a comprehensive document and you come across a section that needs editing. 

With this new feature, you can simply select the specific text you want to modify, click on "Edit from here," and watch as HackMD swiftly responds by opening the editor and automatically scrolling to the precise location of your paragraph. Your cursor is in place and ready for edits.

This functionality is a game-changer for those handling extensive documents, collaborative projects, or anyone who values accuracy and efficiency in their editing process. 

Gone are the days of tediously scrolling through pages of content to find the exact spot that needs revision. "Edit from Here" simplifies this process, allowing you the freedom to focus on refining your work without the hassle.

![Editfromhere_HackMD](https://hackmd.io/_uploads/SkKIBY9Vp.gif)


## Enhanced MathJax and Slide Mode capabilities
MathJax, a critical solution for representing mathematical and scientific symbols, has always been integrated into HackMD. 

But in our latest V3 update, MathJax has undergone substantial improvements in speed and stability. This  ensures a smoother and more reliable rendering of mathematical equations and scientific notation within your documents.

Similarly, Reveal.js, a powerful tool for crafting slides using markdown, has received a substantial upgrade. 

With this update, HackMD has broadened its support for Reveal.js, introducing several new features to the popular Slide Mode that enhance the presentation creation and viewing experience:
1. **[Gradient Slide Backgrounds](https://revealjs.com/backgrounds/#gradient-backgrounds):** Users can now add gradient backgrounds to their slides, adding a touch of visual appeal and customization to their presentations.
2. **[Jump to Slides](https://revealjs.com/jump-to-slide/):** This feature allows for seamless navigation within presentations. Users can easily jump to specific slides, improving the overall presentation flow and accessibility.
3. **[Scroll View](https://revealjs.com/scroll-view/):** HackMD now supports a scroll view within presentations, enabling users to scroll through slides. This functionality provides a presentation experience reminiscent of platforms like Evernote, offering greater flexibility and ease of navigation.

These enhancements aim to enrich your presentation creation process, making it more dynamic, engaging, and tailored to your preferences. Whether you're delivering lectures, workshops, or sharing ideas, these updates empower you to create visually captivating and interactive presentations effortlessly.

Haven't created a slide with HackMD yet? [Learn all about it here](https://hackmd.io/c/tutorials/%2Fs%2Fhow-to-create-slide-deck?utm_source=twitter&utm_medium=social-post&utm_campaign=teams-promote).

## A better experience for you
We're dedicated to providing a robust and user-friendly platform for collaborative writing and presenting. And with both the enhanced editing and updates to MathJax and Slide Mode, we're excited to see the positive impact. 

Keep an eye out for more updates as we continue to innovate and improve your HackMD experience. 

And in the meantime, we can't wait to see what you create!

Effortless editing, MathJax, and Reveal.js: HackMD product updates


Whether you're a seasoned developer or new to the game, understanding the significance of a README document is pivotal for any project. It serves as a guide for users and collaborators alike, offering insights into your project's functionalities, usage, and structure. 

But knowing exactly what to include and understanding the nuances of crafting a clear and informative README can significantly boost your projects visibility and usability.

Today, we're diving into just that. Learn all the essential components, best practices, and step-by-step strategies for creating a README that stands out. 

Let's get to it!

## What is a README?
First things first. 

A README file is text file (usually in markdown) that serves as an introductory guide or manual for users, developers, and collaborators of a project. It's an entry point to understand the project and sets the tone.

So why should you write one? 

A well-crafted README is vital for several reasons:
1. **Project Understanding:** Helps others grasp the projects purpose and functionality.
2. **Onboarding made easy:** Facilitates a seamless onboarding process.
3. **Encourages collaboration:** Provides guidelines for contributors and clarifies expectations.
4. **Showcases strengths:** Highlights the project's advantages and strengths. 

If you're working on any programming project -- especially one likely to involve external contributors -- creating a README is crucial. Ideally, it should be created before the project begins. This acts as a North Star and eliminates the need for retroactive work.

## Crafting an effective README document
### 1. **Understand the purpose**
This one is self explanatory, but an important component that will effect the rest of your document. 

Before starting, you should understand the primary audience and objectives of your project. Who will interact with your README -- developers, end-users, or both? What are the project's goals and what does the README aim to achieve. 

A good way to think about it? For a software project, your audience might include developers seeking usage guidelines, while the README's objectives could involve defining the software's purpose, along with clear guidance on installation and usage.

### 2. Structure and formatting
Once you've identified your audience and objectives, you'll want to scope out the formatting and structure of the document itself. 

What are the main points you want to cover in your README and how can you strcuture that information in the clearest, most concise way? 

It may seem obvious, but effective (and consistent) use of headings, subheadings, bullet points, and formatting styles helps users quickly find the information they need.

If you have a large README file, it's useful to create a table of contents at the top of your document. This will help your audience seamlessly move through the document and onboard quickly.

### 3. Content elements
Each section within your README must serve a clear purpose and layout all necessary information. 

While some areas may seem self explanatory, you should create your README with the possibility that someone reading your document is a novice in the space and needs a little extra guidance. Integrating visual aids like diagrams, screenshots, or gifs complements textual context and offers a more comprehensive understanding.

The following sections are great starting points:

- **Title and Description:** Don't skimp here! Provide a solid title and a detailed project description. What problem does your project solve? What makes it stand out? Why did you start this project? What are the challenges?
- **How-to:** Offer a step-by-step walkthrough of how to use the project, including any commands or configurations.
- **Installation guide:** If your audience needs to download your project first, give a detailed installation guide. This is also the area to add any specific context (re: specific operating system or other dependencies).
- **Contribution guidelines:** State here your project's contribution policy, requirements, and onboarding steps.
- **Roadmap:** Document your long-term proejct vision, if applicable. 
- **Citation file:** Reference any materials used to build the profject or materials that may help contribute.
- **Acknowledgements:** Who maintains and contributes to the project? Give them a shoutout here to show your appreciation.
- **Project status:** Don't forget to keep your project status up to date. Especially if the project has been halted for whatever reason, this should be clearly noted for other contributors.
- **Liscence:** Clarify project licensing terms and usage rights.  

Every project is different, so be sure to strategize what's needed for your own README to be successful. 

## Craft your READMEs with HackMD
Now that you're ready to hit the ground running, [HackMD](https://hackmd.io/) can help you create a streamlined, effective README document. Dive into the intuitive, feature rich markdown editor to craft your README with collaboration in mind.

We can't wait to see what you create.


Mastering README: Creating your project's essential guide


Almost two years ago, we explored the age-old conundrum facing businesses today: [cloud vs on-premises knowledge-sharing solutions](https://blog.hackmd.io/zh/blog/2022/02/22/cloud-vs-on-premises). And today, we're diving back into the world of enterprise knowledge management to discover the best approach for your organization. 

Let's get to it!

### Choosing the best solution for your business
Running a successful company demands a robust knowledge base. The savviest companies employ tailored approaches for storing, managing, and sharing their knowledge systems.

And in today's age of the internet, the importance of integrating remote collaborative work and secure sharing into your knowledge base cannot be overstated. 

But this business need presents a significant challenge for both owners and IT departments. Whether it's remote department employees, outsourcing partners, customers, new hires, or senior decision-makers, each case requires a user-friendly internal and external knowledge platform.

Choosing the right solution for your company depends on your unique needs and circumstances. Instead of merely following competitors, it's better to consider factors like:

1. **Cost:** What's your budget? Do you need a sophisticated console, or is a lower cost more appealing?

2. **Benefits:** Is your knowledge base complex and necessitates internal and external expertise? Do you have the manpower to manage it effectively, and will it enhance productivity or customer satisfaction?

3. **Security:** Who's responsible for information security analysis and risk management? Who owns and manages the information systems, and does this encompass your customers or suppliers?

Once you have these key points figured out, you can begin evaluating solutions to find the right fit for you. 

### Streamline your team with HackMD
Now, let's briefly introduce HackMD's solution for reference. HackMD is a user-friendly cloud service for collaborating, developing, and managing corporate knowledge files. It allows you to focus on your business without worrying about hosting.

HackMD also offers self-installed services for corporate users with their own hosted solutions. This easy-to-use packaged code enables in-house knowledge management while outsourcing tasks like people management, program development, version upgrades, software maintenance, and technical customer support to HackMD.

With that in mind, let's delve into the concepts and applications of cloud and on-premises solutions.

### Embrace the cloud

A cloud solution deploys storage devices, computing power, operating systems, and software applications in -- you guessed it -- the cloud. This Software as a Service (SaaS) approach saves costs, offers agility in workflows, and provides robust information security management. 

Benefits include:

1. **Cost Savings:** Subscription-based SaaS is typically more cost-effective than purchasing and maintaining your servers and software. You can try before subscribing, and scaling up is easy.

2. **Efficiency:** A cloud-based knowledge base enables agility in collaborative work, allowing employees to access it from anywhere with an internet connection.

3. **Security:** SaaS operators often provide advanced security measures, encryption for data transmission, data backup, and protection, mitigating security threats.

For companies unsure about managing their solution directly, cloud software services could be a great fit.

### Manage it yourself

If your company has a technical department and director, you may prefer to host your own knowledge-sharing solution. 

This on-premises solution involves daily maintenance, security management, user access, and system upgrades. While it can be more costly initially, it offers customizability and full control. Consider:

1. **Cost:** You need sufficient resources to manage your servers, software, network traffic, and manpower.

2. **Control:** The on-premises solution provides ownership and control, making it suitable for companies with a strong technical team.

3. **Security:** Managing your host requires comprehensive security measures and expertise.

### HackMD is built for your every need
Whether you choose cloud or on-premises, [HackMD's enterprise plan](https://hackmd.io/enterprise) offers flexibility and cost-effectiveness solution for your knowledge-sharing needs. 

For small to medium-sized enterprises with limited staff, the cloud subscription is most likely the best option for you. It offers low starting costs and unlimited functions. And for those needing full control over document management and security, HackMD's self-built solution is a solid choice. While the initial cost is higher, it offers control and customization. 

Ultimately, the choice depends on your company's resources, long-term strategy, and specific needs. Why not give it a try? [Schedule a demo today](https://hackmd.io/pricing).

Cloud vs On-Premises Revisited


The key to collaboration is creating a central source of truth. For both teams and individuals building with HackMD, a dedicated workspace is provided for organizing and housing all internal documents. 

But what if you want to share select notes or information publicly? Posting links across your social platforms is an option, but what if there was a more efficient way to manage all your public notes? 

Well now there is. 

Enter: Profiles

## **Introducing Profiles**
Everyone using HackMD has a public profile. You can customize your profile a number of different ways to reflect who you are, what you're working on, and who you're collaborting with. Start by personalizing basic information such as username, URL, bio, and photo.

### **Showcase your work**
Take it a step further by showcasing your published notes. Within your workspace, you can decide which notes to make public. Once a note is published -- or made public -- it appears on your profile. 

This is when your profile becomes your central source of truth for your community. Anyone interested in following you or learning more about your work has only to visit your profile to quickly get up to speed. Sharing your work becomes effortless, and collaboration thrives when you build in public.

### **Connect with your community**
As we touched on above, with HackMD you can follow and be followed by others in your industry. Discover like-minded indivials and create a network of collaborators by following their profile. You can always [manage your follower and following list](https://blog.hackmd.io/blog/2023/10/11/announce-connect-react-new-features-hackmd) to curate your network and ensure it's relevance.

So now that you've built your profile with all your public notes and a curated network, you might be wondering how to share timely information with your community...

### **Harnessing the power of Announcements**
Earlier this month we [launched updates to  Profiles](https://blog.hackmd.io/blog/2023/10/11/announce-connect-react-new-features-hackmd), including the introduction of Announcements. This new feature is designed to help you easily update your community with important information and news. 

Whenever you have something to share -- a new event, document, project, or research paper -- you can push an announcement directly to the top of your profile. Once the announcement is published, everyone following you will receive a notification with the information. 

## **A better way to collaborate**
Profiles and Announcements empower you connect with others in the space, share ideas, and ultimately collaborate more effectively. We're excited to bring more features to HackMD that streamline your workflow and make collaborating with others easier than ever.

Whether you're a developer, educator, team leader, or anyone in-between, you can update your profile or share your first announcement today at [hackmd.io](https://hackmd.io/).

We can't wait to see what you create.


Kick-start your collaboration with Profiles


Last week, we rolled out a series of new updates designed to enhance your collaboration experience on HackMD. From improved workspace settings to the ability to post announcements and replying to comments with emojis, these updates will empower you and your team to communicate and work more effectively.

Let's dive in!

## **Manage your network with ease**
Within your Workspace Settings, you'll find new functionality in your Network Settings. You can now [customize the visibility of your follower and following list](https://hackmd.io/z-bY7uqeTl66WgkFW6Rnyw?view#How-do-I-or-my-team-manage-my-privacy-settings-about-who-can-see-my-followers-and-who-is-following-me), deciding who can (or can't) see your connections on platform.

You can also directly manage your follower and following lists. Curate your network and ensure you stay connected with the right people. It's worth noting that teams have only followers -- they cannot follow others -- so you won't need to manage a following list.

## **Post an announcement to your community**
Just as it sounds, you can now [post an announcement on your page or your team's page](https://hackmd.io/@docs/post-announcement-en) to easily update your community with helpful information. Promote an upcoming event, update your status, or share your latest work, all using this new feature. Take it a step further and add a link to a note within your workspace to direct followers to more information. 

Centralize information and streamline access for everyone with the click of a button. ✨

## **React to comments with emojis**
Emojis have become an integral part of online communication -- from social media to Slack channels to blog posts like this one. You can convey recipt of review, express emotions, or engage your community with the click of a button. We understand the power of emojis in facilitating communication and are delighted to integrate the ability to reply to HackMD comments with emojis.

## **Building towards a more dynamic and user-centric platform**

HackMD continues to evolve, and these new features exemplify our commitment to enhancing your collaborative experience. As you explore these new features, you'll discover how they can streamline your work, improve your communication, and make collaboration more enjoyable. Whether you're building out your next project in stealth or part of a team, HackMD is here to help you achieve your goals. 

We can't wait to see what you create.


Announce, connect, and react: A closer look at new features on HackMD




In the ever-evolving landscape of online collaboration and document creation tools, HackMD strives to be a versatile platform for developers, teams, and everyone in-between. Updating and shipping exceptional tools is a big part of that.

We are building the best product possible for YOU. So it only makes sense that we bring you into the fold. 

So today we are highlighting a feature that does that just. You can experience new, upcoming features first with **Beta Mode**. 

## A glimpse into the future
But what is it exactly? HackMD’s Beta Mode is a tool you can utilize to interact with upcoming features and improvements before they’re officially rolled out. 

It’s designed to give you the opportunity to provide feedback, test new functionality, and actively contribute to the development of HackMD.

## Here's how it works...
1. **Access Beta Mode** in your settings. From there, simply navigate to the “Preview features'' tab. From there you’ll be able to view all the Beta features available to you and toggle on the ones you’d like to use.
2. **Try out new features** with the click of a button. Experience a curated selection of cutting-edge features that the HackMD development team is currently building out. These features cover a wide range of functionalities, from enhanced collaborative tools to improved user interfaces.
3. **Provide feedback** to improve your experience. Users who take advantage of Beta Mode can provide valuable feedback directly through the platform. This feedback mechanism allows the HackMD team to gather insights, identify bugs, and make the necessary adjustments before the official release. Share your thoughts by opening the comment section and clicking “Feedback”.
4. **YOU are helping to shape the product** you know and love. You are now a critical part of the development process and we are honored to build with you!

![](https://hackmd.io/_uploads/rJTt-9he6.png)

## Shape the future of collaboration
However you use HackMD – planning your next project, collaborating with your team, ideating your DAO’s vision – you have the chance to unlock tomorrow’s features today and help shape the future of collaboration.

We can’t wait to see what you create.


Unlock the features of tomorrow with Beta Mode.

Join the Conversation: Commenting Just Got Easier on HackMD

Disqus

詮釋資料的重大改變及轉移建議

HackMDのメタデータに重要な変更が迫っています！準備をお願いします！

Important Changes Coming to HackMD Metadata: Brace Yourself!


## 9,000,000 images at risk

With the recent announcement from Imgur regarding the implementation of updated terms of service effecting from May 15, 2023, a specific section directly affects HackMD and its users. According to the policy, low-traffic images uploaded by unregistered users and unused old images will gradually be removed. This policy change could potentially impact the users of HackMD who upload images to Imgur.

HackMD has always prioritized user privacy, so our development team has swiftly transferred all user-uploaded images from Imgur to HackMD's cloud storage. This ensures that HackMD users will not be affected by any changes made by Imgur, preserving the wholeness of their original notes.

**TL;DR: after May 15th, if Imgur begins mass deletion of images, HackMD's paid users will not be impacted in any way.**

After Imgur's announcement, we received numerous inquiries and suggestions from users. Now, we invite HackMD's CTO, Max, to share their experience with the backup process.

## Mission: leave the notes intact

HackMD is a small team that handles daily website maintenance and actively develops new features. Faced with unexpected challenges, the team must make quick decisions and execute them promptly, which is the greatest challenge in this situation.
  
- **How did the HackMD team process such a large content volume in such a short time?**

- ==Max:== HackMD boasts a well-organized team that handles routine maintenance and works on numerous ongoing projects. Faced with this sudden challenge, we needed to assess the scale of the problem quickly. Here are the steps we took.

    -  Checked the system for any usage of Imgur uploads:
        - Images uploaded in notes 
        - User-uploaded avatars 
        - Team space logos
    -  Counted the number of images that needed to be processed.
    -  Identified the relevant implementation code and discussed it with the engineer familiar with it.
    -  Carried out the migration in multiple stages:
        a. Extracted images and their associations from the notes.
        b. Transferred each image to HackMD's image space, note by note.
        c. Enabled all users to utilize HackMD's image space, avoiding future migrations.
        d. Provided automatic conversion of image URLs for paid users. 
        e. Notified users who uploaded images to Imgur from HackMD that the migration was completed.
    
- **Did you encounter any difficulties during the implementation?**

- ==Max:== First and foremost, We had to process around 9 million Imgur images, amounting to 1.8TB of data, scattered across 1.27 million notes contributed by approximately 150,000 users and 10,000 teams. The challenge lay in transferring the images without change the note content, and it was indeed a significant challenge and difficulty.

- **How did the HackMD team successfully overcome it?**

- ==Max:== We considered allowing free users to continue using Imgur or switching to other services. However, there could still be future instances requiring another migration. We decided to grant all users access to HackMD's image space to safeguard user privacy, strengthening privacy measures for good. However, considering the immense number of images, the original estimate was that it would take a week to complete the transfer. After discussions, we opted for a parallel processing approach using AWS Lambda, running up to 15 jobs simultaneously, with a backup rate of approximately 50-100 images per second. Ultimately, it took three days to complete the migration.

- **Some users suggested HackMD should have offered a paid plan for the transfer. Why did you decide to proceed with the migration directly?**

- ==Max:==  We cannot anticipate when users will subscribe or which images Imgur may remove. Many free users have shared valuable content publicly over an extended period. Therefore, we wanted to ensure that no images would be lost in any of the notes (excluding a small portion used for illegal purposes). We took a comprehensive approach during this process, transferring all images regardless of when they were uploaded. Users can check the total number of images they have completed the migration on the note settings page (Settings → Notes).

![](https://hackmd.io/_uploads/rkSAmWKBh.png)


## Join the journey to a better HackMD

To enhance user experience, our team has been actively working on numerous feature updates and adjustments since last year. We have also interviewed various teams from the globe to gain further insights on how users work together. 

We are thrilled to announce that the new version of HackMD will be launched in the second half of this year, and those who are interested can get a sneak peek of the new interface through Preview features.

Of course, the [Beta features](https://hackmd.io/settings#preview-features) are still in developing and undergoing continuous testing. If you encounter any issues or have suggestions, please feel free to give us feedback via support@hackmd.io or join the Discord server.

### Official Discord Server 📣

We are announcing the official launch of HackMD's Discord server 🎉  
  
👉👉👉 [Click here to join](https://discord.gg/qTvkp6vdKV)

Transferred 9M images for better privacy


# HackMD 圖片大搬遷，9 百萬張 Imgur 圖片備份大解密！

相信 HackMD 使用者這幾天應該都有收到我們寄出的轉移完成通知吧？

日前 Imgur 官方宣佈，於 2023 年 5 月 15 日起採用更新版本的服務條款，其中與 HackMD 最為相關的部分為「Imgur 非註冊用戶上傳的低流量圖片、未被他人使用的舊圖也將陸續遭到刪除」，這項政策可能會連帶影響上傳 Imgur 圖像的 HackMD 免費用戶。

HackMD 一直以來都相當重視用戶隱私及使用權益，所以開發團隊決定在最短的時間內將所有使用者上傳至 Imgur 的圖片全數轉移至 HackMD 的雲端空間，確保每位用戶的權益不會因為 Imgur 的更動而影響到原本的筆記內容。

**簡而言之，5/15 以後、如果 Imgur 開始大量刪除圖片，HackMD 付費用戶的筆記不會受到任何影響，仍會正常顯示圖片。**

Imgur 釋出消息後，同時我們也收到來自四面八方的訊息，社群平台上的討論尤其熱烈，礙於先前人力及時間有限無法一一回應大家的提問，現在就由小編和技術長 Max 與大家分享我們的處理流程吧！

## 目標：「0 影響」！

「Imgur之亂」似乎完全沒有影響到你的筆記，正是因為我們在 2 週內將所有使用者的圖片全部都轉移完成啦！

- **小編 : HackMD 是如何在短時間內處理完這麼大量的筆記內容呢？**
- ==Max== : HackMD 是一個編制相當精緻的團隊，除了日常維護工作外還有許多新項目正在進行，面對突然出現的挑戰，我們必須非常快速的釐清問題大小，以下是我列出本次的處理步驟，與大家分享：
  - 清查系統中有用到 Imgur 上傳的部分
     - 筆記中上傳的圖片
     - 使用者上傳的 avatar
     - 團隊空間的 logo
  - 統計需要處理的圖片數量
  - 定位到相關的實作程式碼，並找到熟悉該工作的工程師討論
  - 分成多階段進行
    1. 先將筆記中的圖片與關聯抽出來
    2. 逐筆進行圖片轉移到 HackMD 的圖片空間
    3. 讓全站使用者都使用 HackMD 的圖片空間，避免未來又遇到需要轉移的狀況
    4. 讓付費使用者享有圖片網址自動轉換
    5. 通知曾經有在 HackMD 上傳圖片到 Imgur 的使用者已經轉移完成

- **小編 :實際施作上有遇到什麼困難嗎？**
- ==Max== : 首先，統計圖片和筆記的數量時我們就已經知道會是有點複雜的工作了，這次需要處理的Imgur 圖片約有九百萬張，轉移的資料為 1.8TB，這些圖片遍佈在 127 萬份筆記中，分別屬於 15 萬個用戶以及約一萬個團隊，要如何在不變更筆記內容的狀況下轉移圖片是非常大的挑戰和困難。
- **小編 : 是如何順利解決的呢？**
- ==Max== : 我們有想過如果讓免費使用者繼續維持用 Imgur，或是轉用其他服務，未來還是有可能會遇到相同要轉移的狀況，為了保障使用者的隱私，這次決定讓所有使用者都能用到 HackMD 的圖片空間，強化隱私並一勞永逸。不過如此大量的圖片，原訂是需要耗費一週才能轉移完成，經過討論我們決定透過並行的方式批次處理，本次使用 AWS Lambda 同時最多跑 15 個 jobs，每秒可以備份約 50～100 張，最後花了三天才轉移完成。
- **小編 : 有一些使用者建議我們推付費方案轉移，為什麼最後選擇直接進行轉移呢？**
- ==Max== : 我們一直都以維護「每一位」用戶的使用權益為原則，我們無法預期使用者何時會付費也不知道 Imgur 會移除哪些圖片，有很多免費的使用者長期公開分享很多有價值的內容，因此希望所有筆記中的圖片都不會遺失（當然不包含違法使用的小部分），在這次處理時我們做得相當周全，無論是什麼時候上傳的圖片都會進行轉移，每一位使用者都可以在筆記的筆記設定（Settings → Notes）頁面看到自己總共有幾張圖片已經完成轉移。

++如下：進入個人筆記頁面左下角點選 ⚙ Settings ➤ 側邊欄點選 Notes++


![](https://hackmd.io/_uploads/HkBVOy4Bh.png)

## 感謝使用者們的支持與愛護 ♡

HackMD 以開發者為本，我們非常喜歡使用者之間在社群上討論解法的互動方式，透過大家的互動我們也感受到許多溫暖，在轉移的消息公布後有許多使用者轉換付費以行動支持我們，原來團隊長期默默耕耘是有被看見的（拭淚），希望我們的努力有回應到大家的討論和期待。

為了提升使用者體驗，團隊從去年開始如火如荼的進行許多功能更新和調整，也陸續的訪談許多國際工作團隊，近一步了解用戶協作的需求。預計於今年下半年推出新版的 HackMD，有興趣的朋友可以透過 [Preview features](https://hackmd.io/settings#preview-features) 一窺新介面。

當然，Beta功能都尚在開發和不斷地測試中，有問題也歡迎透過 support@hackmd.io 回饋完整的建議給我們。

### HackMD 的 Discord 來了

同時我們也新設立官方 Discord 伺服器。<small>對！沒錯！我們終於跟上 Discord 了！🎉</small>

👉👉👉 [點此加入](https://discord.gg/qTvkp6vdKV)


這是一個嶄新的交流空間，目前試營運中，日後我們也會將 HackMD 的第一手資訊公告在頻道上，也讓各位關心、好奇 HackMD 的朋友，直接與團隊互動。

未來我們會在頻道上進行有趣活動，與你一起塑造屬於 HackMD 的社群文化。期待每一個你！



HackMD 圖片大搬遷，9 百萬張圖片備份大解密！

Better privacy after Imgur migration

保護隱私，免費使用者享圖片儲存空間

What will happen after metadata migration?

Where is HackMD heading to?

# Four special experiences with HackMD by Treezi

<iframe src="https://hackmd.io/@hackmd-blog/usecase_treezi_slide" width="100%" height="400"></iframe>

<style>
    iframe {
        border: none;
    }
</style>

Four special experiences with HackMD by Treezi


# NOJ students sharing their experience with HackMD

## About NOJ

We are the development team of Normal Online Judge (NOJ), an open source online judge designed for education purposes. NOJ currently supports C, C++, and Python, and plans to support more flexible question types, such as file processing. Our user base consists of students from the NTNU CSIE.

## Experience with HackMD

As a team consisting of CSIE students, it is natural for us to use markdown for writing. Therefore, HackMD is an excellent platform for team collaboration compared to other choices.

HackMD is a tool that allows teams to quickly and easily record ideas and collaborate in real-time. It offers many useful features that make it an ideal choice for software development team.

One of the key advantages of HackMD is its ability to quickly capture ideas and thoughts. Its simple, intuitive interface allows team members to quickly write down their ideas and share them with others.

HackMD also has a slide mode that allows users to quickly create presentations. This is very useful for team members who need to make presentations, as it allows them to easily organize their ideas and share them with others.

The recently released HackMD API offers the possibility of automating workflows. I had personally used it to create massive notes from templates which are created manually before. We are still investigating how to use this to help improve our productivity.

In short, HackMD is an ideal team collaboration tool that allows team members to quickly and easily collaborate and offers a wealth of features. Its simple, user-friendly interface and support for markdown syntax, as well as the official API and slide mode, make it a great choice for team collaboration.

## Examples

Here are two examples of our team notes. First one is introduction for the course "service learning". The second one is overview of our team and some notes about system design.

- [110-1 service learning (Mandarin)](https://hackmd.io/@noj/H1UCLHzdt)
- [NOJ Overview (Mandarin)](https://hackmd.io/@noj/overview/)



NOJ students sharing their experience with HackMD


# Taiwanese musician edit sheet music with HackMD
![](https://hackmd.io/_uploads/BJYlYcuLo.png)

## Experience with HackMD
**HackMD is an extremely convenient editing platform**
The most common way for music producers to edit scores is to use commercial score software. The completed score must have specific software to open or save as .pdf to read, after I knew HackMD supported ABC Notation, I had a new option. When I want to edit, I use ABC Notation to write music, and share music scores through HackMD directly.

My article is mainly introduce the use of ABC Notation and recommend that if you want to play with the ABC notation, using HackMD is a convenient platform.

currently music producers make scores, they still mainly use mainstream paid software packages (such as Sibelius). Hope my experience of HackMD can that more people try this different way to create music.

>**在 HackMD 上面使用 Markdown 寫譜真是快速輕量又方便**
一般製作音樂的人在編輯樂譜時，最常見的方式是使用商用樂譜軟體
因此打完的譜必須要有特定的軟體才能打開或是另存成.pdf才能閱讀
hackmd支援有ABC Notation語法後，我有了新的選擇，當我想要打譜時，可以直接在線上使用 ABC Notation 寫譜，並且透過網址連結輕鬆地分享樂譜
我的文章是以介紹ABC Notation使用為主和推薦大家如果想要玩玩這個打譜的語法時，使用 HackMD 是個方便的平台
當然目前音樂業界在製譜的時候，還是以主流的付費套裝軟體為主 (例如 Sibelius) 希望透過分享 ABC Notation 的用法以及 HackMD 的使用經驗，讓更多人可以試試這種不一樣的創作方式


## [ Music sheet_*Jay chao "Cold hearted 紅顏如霜"*](https://hackmd.io/udGUBOnYRgiBrFOIzrKUFw?view)

### Melody:
```abc
X:1
T: 周杰倫 - 紅顏如霜 (前奏)
T: (melody)
C: transcription by yuntao雲濤
L:1/4
K: Bb
{F,1G,1B,1CDFGBcdfgbc'}| d'2 z1/4B1/4F1/4G1/4 B1/4{c}d1/4c1/4B1/4| c2 z1/4{gf}d1/4c1/4d1/4 c1/4B1/4G1/4F1/4 | B2 c2 | d>{FFF}F F1/4G1/4B1/4c1/4 d1/4f1/4g1/4b1/4 |
f2 z1/4B1/4F1/4G1/4 B1/4{c}d1/4c1/4B1/4| c2 z1/4{gf}d1/4c1/4d1/4 c1/4B1/4G1/4F1/4 | B2 z1/2G1/2c1 | B4  |
```

```abc
X:1
T: 周杰倫 - 紅顏如霜
T: (melody)
C: transcription by yuntao雲濤
L:1/4
K: Bb
F1/4F1/4 | G1/4B1/4B1/4G1/4 c G1/4B1/4B1/4G1/4 c1/2d1/2 | c1/4c1/4c1/4c1/4 c1/2d1/2 c1/2B1/2G1/2F1/2 | z1/2G1/4F1/4 G1/2B1/2 z1/2G1/4F1/4 G1/2c1/2 |  z1/2c1/4B1/4 c1/4B1/4c1/4B1/4 c1/2d1/2G1/2F1/2 |
G1/4B1/4B1/4G1/4 c G1/4B1/4B1/4G1/4 c1/2d1/2 | c1/4c1/4c1/4c1/4 c1/2d1/2 f1/2{f}g1/2{d}c1/2B1/2 |  z1 c1/4B1/4c1/4B1/4 d1/2G1/2B1/2c1/2 | _B4|
z1 c1/4d1/4c1/4B1/4 c1/2c1/2 d | z1 B1/4G1/4B1/4G1/4 d1/2G1/2B1/2G1/2 | z1 c1/4d1/4c1/4B1/4 c1/2c1/2 d | b1/2a1/4g1/4 f1/2d1/2 g<f   |
z1 G1/4B1/4B1/4G1/4 c1/2c1/2d1/2c1/2 | z1 G1/4B1/4B1/4G1/4 B1/2B1/2G1/2F1/2 | z1 d1/4d1/4d1/4d1/4 g1/2f1/2d1/2B1/2 | d<c z1/2B1/4B1/4 c1/4B1/4G1/4B1/4 |
c1/4d1/4d1/4d1/4 d1/2d1/2 z1/2B1/4B1/4 c1/4B1/4G1/4B1/4 | c1/4d1/4d1/4d1/4 d1/2d1/2 z1/2g1/4f1/4 g1/4f1/4d1/4B1/4 | c1/4d1/4d1/4d1/4 d1/2c1/2 z1/2c1/4c1/4 d1/4c1/4B1/4G1/4 | c1/4c1/4c1/4d1/4 G1/2G1/2 z1/2B1/4B1/4 c1/4B1/4G1/4B1/4 | 
c1/4d1/4d1/4d1/4 d1/2d1/2 z1/2B1/4B1/4 c1/4B1/4G1/4B1/4 | c1/4d1/4d1/4d1/4 d1/2d1/2 z1/2g1/4f1/4 g1/4f1/4d1/4B1/4 | c1/4d1/4d1/4d1/4 d1/2c1/2 z1/2c1/4c1/4 d1/4c1/4B1/4G1/4 | c<(B B2) | 
```

```abc
X:1
T: 周杰倫 - 紅顏如霜 (間奏)
T: (melody)
C: transcription by yuntao雲濤
L:1/4
K:Bb
_B1/2>G1/2 _B1/2c1/2 d1/2f1/2c1/2d1/2 | G<(F F2) | _b1/2f1/4(g1/4 g1/4)d1/4f1/2 c1/4d1/2_B1/4 c1/2G1/2 | F3 z1 |
```
```abc
X:1
T: 周杰倫 - 紅顏如霜 (前奏)
T: (chord analysis)
L:1/1
K: Bb
"Ebmaj9"[EGBdf] | "Dm(b13)"[DBcf] | "Cm11"[CGBf]1/2 "F7(9,11)"[FGBf]1/2| "Bbmaj9"[B,1Fcf]1/2 "Bb"[B,1FBd]1/4 "Bb7"[B,1F_Ad]1/4 | 
"Ebmaj9"[EGBdf] | "Dm(b13)"[DBcf] | "Cm11"[CGBf]1/2 "Cm7"[CGBe]1/2| "Bbmaj9"[B,1Fcf]1/2 "Bb"[B,1FBd]1/2 | 
```
```abc
X:1
T: 周杰倫 - 紅顏如霜
T: (chord analysis)
L:1/1
K: Bb
"Ebmaj9"[EGBdf] | "Dm(b13)"[DBcf] | "Cm11"[CGBf] | "Bbmaj9"[B,1Fcf] | 
"Ebmaj9"[EGBdf] | "Dm(b13)"[DBcf] | "Cm11"[CGBf] | "Bbmaj9"[B,1Fcf] | 
"D7"[DAca] | "Gm7"[G,1FBf] | "D7"[D^Fca] | "Gm7"[G,1FBf]|
"Ebmaj7"[EGBd] | "Dm(b13)"[DBcf] | "Cm11"[CGBf] | "F7(9,11)"[FGBf] |
"Ebmaj9"[EGBdf] | "Dm(b13)"[DBcf]1/2 "Gm9"[GABf]1/2 | "Cm11"[CGBf]1/2 "F7(9,11)"[FGBf]1/2| "Bbmaj9"[B,1Fcf]1/2  "Bb7"[B,1F_Ad]1/2 | 
"Ebmaj9"[EGBdf] | "Dm(b13)"[DBcf]1/2 "Gm9"[GABf]1/2 | "Cm11"[CGBf]1/2 "F7(9,11)"[FGBf]1/2 | "Bbmaj9"[B,1Fcf] | 
```

```abc
X:1
T: 周杰倫 - 紅顏如霜 (間奏)
T: (chord analysis)
L:1/1
K: Bb
"Ebmaj9"[EGBdf] | "Dm(b13)"[DBcf]1/2 "Gm9"[GABf]1/4 "Db7(add9)"[_DF_A_c_e]1/4 |
"Cm11"[CEGBd]  | "Gbmaj7"[_GB_df]1/2 "F7(9,11)"[FGB_e]1/2| 
```

```abc
X:1
T: 周杰倫 - 紅顏如霜 (尾奏)
T: (chord analysis)
L:1/1
K: Bb
"Ebmaj9"[EGBdf]1/4 "Dbmaj9"[_DF_Ac_e]1/4  "Bmaj9"[=B,1^D^F^Ac]1/4 "Gbmaj9"[_G,1_B,1_DF_A]1/4 | 
"Bbmaj7(add 9,13)"[B,1FGcd] ||

```
### Score grammar
ABC Notation: https://en.wikipedia.org/wiki/ABC_notation

### Know more about music producing from Tao Chen
- [Facebook](https://www.facebook.com/jioufen.yuntao)
- [Instagram](https://www.instagram.com/taochen1114/?fbclid=IwAR1J4k4zVFTxirtIPgOFuWmk9MeTJRs1S9HF2U7PqvvYKOH8VVkTMauGW_A) 
- [Blog](https://violin-tao.blogspot.com/2022/10/abc-notation_26.html?fbclid=IwAR2BZ3TWV4chfgI75tNZflmbFfa7K9mY5Kvs6bJzXp_zc5K3jfWbEU-xs7I)







Edit music sheet with HackMD


# Build LINE chat bot with Hackmd API

## Why I use HackMD

- I am a training/educator, often need to organize projects, teaching documents, but also need to assign homework and collect return homework, tried different software services in the market, HackMD is the most convenient, lightweight, based on the sharing of knowledge platform!
- HackMD is already a part of life.

## Awesome usage
- Organize a series of 30 articles containing [Youtube videos](https://www.youtube.com/playlist?list=PL5vxsagL2iDDBRcNORi7zx7Q_cD6AlJlK) in [HackMD book mode](https://hackmd.io/@wiimax/intro-hackmd), and organize the [articles](https://ithelp.ithome.com.tw/users/20121130/ironman/5793) through grammatical components [Sliders](https://hackmd.io/@wiimax/intro-hackmd-slides) with `{%hackmd noteid %}` are all done by HackMD. 
- Now I manage my favorites information centrally through the LINE APP, it will automatically sync to hackmd!

## The LINE chatbot built with the HackMD API

-   The [code of the LINE chatbot built with the HackMD API](https://hackmd.io/@wiimax/HySvndc-j) has been made public[  GitHub](https://github.com/willismax/hackmd-line-bot-on-fly)。

### What problems can be solved

- You phone pictures, text, and links can eazily share to your LINE official account, and they will be automatically synced to HackMD for subsequent editing.

| ![](https://i.imgur.com/o5xMA5A.jpg =270x) | ![](https://hackmd.io/_uploads/HJxLrFvBj.png) |
| --- | --- |
| Photo/text/link/share to LINE APP | Automatically sync to HackMD |

### How the chatbots works

-   There are many ways to build a LINE chatbot, for example, first you need to create an [LINE Developers](https://developers.line.biz/zh-hant/) channel, then get the [HackMD API](https://hackmd.io/@hackmd-api/developer-portal), and get [Imgure](https://imgur.com/account/settings/apps) ID. You need to modify the code to add the necessary parameters and deploy it in the [Fly.io](http://fly.io/), and finally fill in the Fly.io's exclusive URL  like `https://[APP Name].fly.io/callback` to LINE WebHooks.
-   The easy steps are below to collapse the list, or refer to my [tutorial](https://hackmd.io/@wiimax/HySvndc-j#%E5%A6%82%E4%BD%95%E5%BB%BA%E7%AB%8B-LINE-bot).

https://github.com/willismax/hackmd-line-bot-on-fly

:::spoiler easy steps

- [ ] Download the code from [<i class="fa fa-github" aria-hidden="true"></i> GitHub](https://github.com/willismax/hackmd-line-bot-on-fly), can be downloaded `zip` unzip or `git clone` down. You can Fork it!
- [ ] Get [HackMD API](https://hackmd.io/@hackmd-api/developer-portal) `Token`, fill in `HACKMD_API_TOKEN`, and assign an `TEMP_NOTE_ID` in  `config.py`.
- [ ] Create an exclusive Channel in [LINE Developers](https://developers.line.biz/zh-hant/), get `Token`, `Secret`, fill in `CHANNEL_ACCESS_TOKEN` and `CHANNEL_SECRET`.
- [ ] Get the  [Imgure](https://imgur.com/account/settings/apps) `Client ID`, and fill in `IMGURE_CLIENT_ID` in `config.py`.
- [ ] Create a cloud service on [Fly.io](http://fly.io/) and establish a development connection environment.
- [ ] Finally, fill in your [Fly.io](http://fly.io/) link `https://[APP Name].fly.io/callback` into your LINE Channel Webhook, and enable Webhooks.

:::

Build LINE BOT with Hackmd

Build your productivity flywheel with automation

How to keep your team workspace tidy and organized?


# 善用 Google Meet 搭配 HackMD ，開一場非同步的協作會議

去年，教育部因應疫情趨勢跟數位創新，首度辦理「線上審議」來討論青年心理健康議題，其中，示範場次便選用了 Google Meet 跟 HackMD 搭配組合，讓參與者可以自由決定用哪種方式參與，可以露臉說話，可以說話不露臉，可以不露臉不出聲音只打字，只要能舒適自在地參與討論就好，體現了涵容（Inclusiveness）的精神。

這一場示範場次，是由台灣勞工陣線主辦的[「青年貧窮下的托育及居住心理壓力如何解？」非同步協作會議](https://hackmd.io/@enen/Letstalk-2021)，全日的工作坊，有邀請專家學者來演講，參與者則有台灣北部、南部以及歐洲留學的年輕人，將近三十人全程參加，共同針對青年心理健康問題背後的社會成因做討論。


:::success
![](https://hackmd.io/_uploads/rJ7onHZ45.png)
<figcaption>▲ 2021/11/13 活動資訊總站，以 HackMD 書本模式製作。</figcaption>
:::


## 另類參與：視訊聆聽，非同步打字協作，不用整天都「視訊對話」

若要參與者待在電腦前一整天，戴著耳機、觀看鏡頭並且專注地參與討論，可能會使人覺得太辛苦。反之，提供一個選項，與會的人可以在自己舒服的狀態下，隨時以打字的方式，隨時在 HackMD 對講者提問，拋出想法，或者在「閒聊區」任意打字，那就會提升參與的意願，以及待滿全程的動力。

一開始，教育部青年署為了辦理系列活動，已經採購了 Google 的服務，但是 Meet 內建的文件功能，其實還是以視訊為主，編輯體驗並不好；首選是大家都很熟悉的 Google Doc，原本版面都已建置完成，然而，在主辦團體的實際測試時，與會者同時打字的輸入干擾很嚴重，版面也有點混亂。

最後，同樣在大家的實際測試之下，HackMD 簡潔版面及打字體驗，勝出。活動的頁面、問卷、聊天室網址、文件協作網址跟議題手冊，順勢以書本模式來滾動更新了。
	
數位文件的討論頁面，搭配議程，把每個區塊劃分開來，參與者如果分心了，也可以回到上一個段落看看，或是到下一個段落發表意見、打字閒聊，非同步的參與方式，讓大家更能夠全程參與。
	
## 重點是「讓想法落成文字」，不需要「很會用 HackMD」

原本主辦單位擔心，與會者都是從來沒有用過 HackMD 的人，會不會因為不熟悉黑白雙欄的介面跟 Markdown 語法，而感到卻步呢？

實際上，如果把打字的區塊設定好，引導到指定標題底下留言，加上分享螢幕時的簡單操作示範，所有人都能夠輕易地在文件上留下想法，並不需要複雜的功能教學。

尤其，一份好的討論文件，除了既定的議程，也需要非正式的閒聊區，透過註解功能或是 `>[name=]` 語法，單單靠文字的互動就很踴躍。當與會者看到其他人使用簡單的 Markdown 語法，也會自然而然透過學習，逐步長出比較進階的用法。

實際上，對於討論來說，「想法」才是重要的，排版只是其次，所以重點便是「如何讓大家輕鬆地把想法表達出來」，而 HackMD 原本便是特別適合「從想法變成文字」這一段的工具，即使是從來沒聽過 Markdown 的與會者，也能從產品設計跟實際體驗上，感受到這一個特性。

:::success
![](https://hackmd.io/_uploads/SJrlTBZV9.png)
<figcaption>▲ 當天，許多第一次使用 HackMD 的與會者，已經可以踴躍在數位文件上討論起來。</figcaption>
:::


## 便利的數位文件，就像工作坊裡的便利貼

有趣的是，在這種穿插著高度知識性內容的審議討論裡面，以文字來做交流，提問才更踴躍，大家「比較敢發表意見」，就跟許多實體工作方當中，若以便利貼、白板等文具來輔助，往往會挖掘到更多有價值的想法。有些人很有想法，但口條不好；有些則敏感體貼聽話者的心情，為斟酌用詞而遲疑，反而讓人聽不明白他的意思。這時，可以來回修改的文字，讓人更願意表達。

比便利貼跟白板更有效的是，內容會自動留存下來。因為是文件，有一定的標題順序，只要有適切的引導，與會者的內容不容易流於破碎發散，比較像是一張趨近完整的發言單，但彼此的發言又可以即時互動，能夠在當下有「對話」的特性。

## 用文件加入討論，激發更多潛藏的意見

事後，有人回饋意見是 **「平常不敢在視訊會議中發言，是擔心自己想法沒有辦法整理好，佔用大家時間，會很緊張，但是先在文件上打好，讓我參加的壓力小很多。」** 這呼應了教育部青年署以心理健康的主題出發，其實參與議題的討論，不需要造成大家壓力，而是邀請讓更多人一點一點參與進來。

好的活動，總是各種元素與工具測試、搭配而成。線上的工作坊、線上的想法激盪、線上的會議，或許有純視訊講話以外的選擇。教育部青年署的實驗性活動，已經帶頭做了鮮明的示範，即使不是疫情，透過更加涵融及多元管道的方法，更能夠收集到全面的意見，把大家真正拉在一起。


善用 Google Meet 搭配 HackMD ，開一場非同步的協作會議

Build connections with your audience, even with handouts

How to communicate effectively across functional teams?

付費學員限定的講義，適合用HackMD的三大原因：哲學講師朱家安的使用經驗


# 雲端 VS 地端，數位轉型怎麼選？


凡經營公司一定有企業知識庫，累積其中的經驗與本事，是你超越競爭對手的重要關鍵。精明的公司通常會有一套適合自己的做法，來儲存、管理和共享企業知識系統。

你已經聽了很多關於企業知識庫的好處，特別是當今成熟的網路時代，加上百年一遇的全球疫情，如何在知識庫中加入遠端協同工作與安全共享的必要性，對於企業主和IT部門又是一大考驗。不論是異地辦公的各部門員工、來自四面八方的外包供應商、拜訪網站的老客戶與新用戶、剛加入的菜鳥員工，或是管決策的智慧高高層，都需要易於管理的內外知識平台。

## 選擇無對錯，端看你需求

為了滿足複雜的資源需求，企業一定是期待有更好的選擇，所以打算新建一套或是優化目前的知識分享系統。要上雲端，還是本地端？前往目標，要找代駕，還是自己開？

然而，在開始討論之前，得先有個認知：適合其他公司的方案，不見得適合你的公司。除了參考競爭者的作法，考慮自己的條件與需要更為明智。例如：

* 成本：預算是多少？你希望擁有主機嗎？成本是不是越低越好？
* 效益：內外需求的專業知識複雜度高嗎？有適合的人力進行管理嗎？可以提高生產力或是客戶服務滿意度嗎？
* 安全：資訊安全層級分析與風險承擔由誰負責呢？誰擁有資訊系統的管理與所有權呢？這個安全性，包括你的客戶或供應商的管理嗎？


這裡，我們快速介紹一下 HackMD 的解決方案給大家參考參考。眾所周知，HackMD 就是好用的雲端服務，協作、開發、管理企業知識文件，登入就行了，系統全年無休。你只要管業務，不用考慮主機在哪裡。

大家比較不熟悉的是，HackMD 也提供自架設的服務給擁有主機的公司用戶。打包好的程式碼方便上手，知識管理在自己家，愛怎麼架就怎麼架，這個服務適合有專屬 IT 人員的公司。至於使用過程中的人數管理、程式開發進版、軟體升級維護和技術客服林林總總，請交給 HackMD。


接下來，我們分享一些，Cloud 雲端方案和 On-Premises 地端方案在概念和應用上的看法。



![](https://i.imgur.com/lBJEeSv.jpg)

## 輕巧上雲端

這裡，我們先定義的雲端方案，是指整體基礎架構，包括儲存設備、運算能力和作業系統、軟體應用，都佈署在雲端。以這種方式提供服務的軟體，一般稱為 SaaS（Software as a Service，軟體即服務），可以省下自行維護機器的辛勞。

選擇雲端解決方案的最大好處，就是：節省成本，享受敏捷的工作流程，以及輕鬆享有必要的資安管理。



### 節省成本

SaaS 通常採訂閱制，費用較為透明。一般而言，會比採購伺服器和安裝軟體便宜不少。

付費前，您通常會有機會先試用，確認服務能解決您的問題再訂閱。付費後，隨著公司成長、需求增加，要擴充也很方便。企業完全不用擔心設備的前期採購、後續安裝與維護，也不必操心軟、硬體升級問題，管理上簡單許多，因此廣受歡迎。


### 高效能

將企業知識庫架設在雲端，無論員工身在何處，只要能連網，都能登入並使用業務系統，達到協同工作的敏捷性，確保業務進行的可靠性。

HackMD 有用戶就是在廠區使用。使用者一邊視察，一邊拍照，隨手就傳上 HackMD 作為報告附件。


### 安全性
不只是低成本、高效能，SaaS 業者對安全層級的要求、所採取的安全措施，通常優於小型團隊或中小企業的做法。

SaaS 業者會跟進並採用最先進的安全管理，確保自身和受委託的數據安全性，業者所具備的能力，包括了：資料傳輸的加密能力、資料搬移或是儲存管理的保護與備份，以避免來自虛擬網路或是實體層的安全威脅。

如果對資安管理沒有把握的企業，我們會強烈建議採用雲端的軟體服務。

![](https://i.imgur.com/Yx8qp2k.jpg)

## 地端自己管

從另一方面來看，企業本身如果有技術部門，也有技術主管，那委託在雲端難免覺得受制於人，因此會考慮自架主機。

簡單來說，您的公司希望擁有自己的機器嗎？對於資料管理或資訊安全需要客製化的平台嗎？如果答案是「YES」，SaaS 的選項就可以直接跳過了。接下來，我們很快了解 On-Premises 地端方案的可行性。


地端方案，核心的觀念就是企業擁有自己管理的實體主機，由公司內的團隊負責其中的日常維運、安全管理、用戶訪問，以及系統升級。主機的地理位置可以實際安裝在公司內部，例如企業總部和各分公司的地點，或是透過租用機房遠端管理，運用 CDN 佈署和管理的技術，來分散風險。


### 成本

會考慮擁有主機的公司，通常面臨三大需求：頻寬流量大、使用者或會員人數多、資料存取量大且運算複雜等情況，所以通盤考慮後，選擇由公司負責管理伺服器和網路架構。

能自行維運主機的公司，也意味著有能力負擔相應的成本，包括主機的軟硬體成本、網路流量、人力與管理成本，以及後續的升級。

自行處理上述需求，起初成本雖高，但也能按企業的需求客製化。如達到一定規模，成本有可能比使用 SaaS 還低，端賴技術長與工程人員的明智規劃。

### 可控
On-Premises 地端方案的最大誘因在於三個字：所有權。

是的，資金、開發人力、和專業知識都到位的企業，採用 On-Premise 地端方案不會是問題。這裡要特別提到一個觀念，有自信能管理主機的公司，通常也不會只有一台主機，主機群組上乘載的數據內外兼修也是常態，包括公司的業務營運資料、ERP進銷存、知識庫、客戶／供應商／會員資訊、客服體系、甚至是對外的業務服務主機等等。

選擇地端，絕對是評估過雲端方案優缺並呈後的決定。常見的決策點例如：

- 公司在營運初期就習慣在本地伺服器管理自己的業務系統，遷移的不確定性與委由他方管理沒有必要；
- 業務資料十分敏感，有動搖國本之可能，公司的團隊取得完全掌握權，高管層峰比較安心；
- 市面上的雲端方案並沒有適合公司業務的客製化服務。
 
如果公司的 IT 部門管理得更好，為什麼要上雲呢？尤其當公司的大客戶十分關切資料隱私和資安，由公司掛保證的團隊與專屬主機，似乎是較為妥當的銷售策略。

說到底，假使貴公司的業務知識是別無分號的專業，技術團隊人力充沛，那麼選擇本地端方案的好處確實無可取代，值得仔細考慮。



### 安全
網路架構環境日益複雜，除非業務所需，你的公司不會沒事去申請 ISO27001 等資安認證，畢竟各家認證都牽涉一整套風險管理的標準化流程，不僅資訊團隊要很清楚如何管理安全等級，評估公司所有業務的風險，還要監督、培養全公司——不只是IT人員——高度的資安意識。當威脅來臨時，事前怎麼防範、事中如何應變、事後如何修補，還得要時時操練，定期檢驗。

資安是重中之重，這給你的團隊帶來更多責任。除了外部攻擊外，各種低級錯誤也可能導致系統災難，例如清潔人員挪動椅子碰到主機保護罩、沒人教的菜鳥按到重開鍵，或是產品韌體沒寫好導致賣出的大量設備向網站瘋狂發送數據請求以致崩潰主機。

穩定的團隊，一是熟悉，二是安逸。這年頭世事多變，你我都不相信你公司裡有全知、全能永久可信的 IT 人才，精明的企業在組織之外，會雇用外部的雲端專家協助監測，同時把不同資安等級的公司業務體系，以雲端加地端的混合系統來分散管理，確保地端效能的完全發揮，也降低對內部成員的完全依賴。




# 結語

拜雲端應用大勢所趨，多樣化的 SaaS 服務成為新創獨角獸，技術發展非常之快。完全採用雲端，或是混和型態已成為主流，特別是當職場中的新世代工作者，早已是擁抱雲端應用的數位原生代，即使公司採用地端方案，也無法避免員工或外部供應商透過各種便利的網路工具進行協同作業。

無論是雲端或地端，HackMD的[企業方案](https://hackmd.io/enterprise)提供充分選擇，我們的收費方案十分合理，歡迎預約免費試用。

對於人手不足的中小型企業，建議可以選擇 HackMD 的雲端訂閱制，有多少成員就支付固定的費用，起始成本非常低。每個用戶的使用範本／版本紀錄／GitHub 同步推送等許多功能，付費後均無上限的，可以盡情使用。

如果你的公司，需要一個自定義網域和首頁的文件社群，同時必須完全掌控機密文件的生成與管理流程，那麼 HackMD 的自架設方案會是不錯的選擇。我們的企業方案提供 Docker 容器化佈署以及主機代管兩種架設方式，確保您的公司將擁有文件中心的所有管理權限。當在本地機房或是雲端主機架設 HackMD 系統時，IT 人員可以自定義使用者的登入方式、角色權限與相應的識別管理，強化跨部門同仁的資訊透明化與即時合作。也可以充分配合 GitLab 同步的文件流程。所有的文件都可以輸出成 .md、.html 等格式，自由彈性永遠有效。

企業自架設的地端成本初期肯定比 SaaS 訂閱制高出許多，但是把時間拉長遠來看，自有主機的長期成本可以攤提，而且文件內容和作業系統的掌控權都在公司內部，這個工作社群將始終存在，不會因為取消訂閱而停止運作。

以工作平台加企業知識中心的需求來看，不論你的公司使用何種方式，內部一定要有專職的管理人員，負責例行維護。至於雲端好，還是地端好呢，如同本文一開始就提到的，還是要回歸檢視企業目前可投入的資源以及中長期發展策略來總體考量。斟酌再三何不就試用看看，歡迎現在就[聯繫 HackMD](https://airtable.com/shrC8Ow2JkIIf1wzk)，預約業務為您導覽。



雲端 VS 地端，數位轉型怎麼選？


The HackMD Team has released a beta version of HackMD API, which could produce more value for you, by integrating HackMD with other apps.

## Take a productivity leap with the API

An API is a collection of entrances that each leads to a specified room, which fulfills a certain functionality of the app. By "calling" these entrances, you can ask HackMD to

- list the notes that you have visited, 
- create a meeting minute before the meeting, 
- save contents that you have clipped from websites, 
 
and a lot more, automatically. For all the steps that HackMD has a role in your workflow, you don't have to click repetitively to go through them anymore. Your time should be spent on more creative works.

So bring this news to your fellow developers and begin to replace manual works with programs.

## There is an economy in the API

Beyond the time and efforts saved, as a developer building products, consider building a service that exploits the assets that HackMD has already accumulated. For example, 

- a **blogging** service that publishes contents written on HackMD to a custom domain, 
- an **issue tracker** that collects todo items from HackMD notes and syncs them two-ways, or 
- a **customer support** widget living on the webpages that offers visitors on-the-spot knowledge from the contents on HackMD.

Various opportunities lie in Web3 as well.

To summarize, HackMD API can be a productivity leap by saving manual works for you. Moreover, it can be a source of revenue as well. With HackMD API, you can concentrate efforts on the unique value that your product offer, capitalizing on what HackMD has been good at, and build a minimum viable product more quickly and monetize whenceforth.

Let's get started.


[Go to Developer Portal →](https://hackmd.io/@hackmd-api/developer-portal?utm_source=blog&utm_medium=cta&utm_content=api-beta-announcement)

Be more creative with HackMD API


<figure>
<img src="https://hackmd.io/_uploads/ryU0OvD19.gif" style="display:block;max-width:100%;margin:auto" />

    
<figcaption>▲ 範例：用 cURL 指令對 HackMD RESTful API 發出更新請求，即時更新筆記內容。</figcaption>
</figure>

----

HackMD API 即刻開放測試，你可以在設定頁建立 API token 來操作筆記。廢話不多說，這裡直接放上 API 文件供各位開發者參考，請大家用力玩起來 :arrow_down_small: 

>API 文件與使用說明：https://hackmd.io/@hackmd-api/developer-portal

你也可以參考社群的 [HackMD API Book](https://hackmd.io/@docs/HackMD_API_Book/) 共筆案例、補上實作文件，HackMD 團隊將準備致贈給熱心開發者的回饋品。馬上加入測試的行列吧！

## 社群貢獻的指標案例

:pushpin: **自動開筆記**：如果以 Google Calendar 安排工作，用日曆事件觸發，文件就能連動行程的時間，例如該開會的時候，會議紀錄就會自動開起來。以 Zapier 自動化平台為例，在建立 Action 時可以寫 Python 或 JavaScript 程式碼，請求 HackMD 建立筆記 API。

:pushpin: **更新網站內容**：可以運用 HackMD 的筆記列表 API 來取得團隊空間內的筆記內容，再利用靜態網頁產生器（Static site generator），搭配 CI 工具建置自動化流程，定時或手動觸發，讓 HackMD 成為能夠自訂的內容管理系統。

## 開放測試，實作你的理想組合技

HackMD 開放了筆記 API，你會想用來做什麼？你把 HackMD 用在學習、工作、專案、娛樂與生活，但以前只有 HackMD 單打獨鬥。如果，能跟其他你常用的軟體結合，互相加乘，一定更省心省力。

API 在手，就能實現生活與工作的自動化。

畢竟，筆記軟體這麼多，為什麼大家持續使用 HackMD？

過去你會這樣回答：筆記方便、協作流暢，版本紀錄直觀可靠。

API 釋出後，你還可以這樣說：
- 因為 HackMD 配合我行事曆自動開筆記，寫起來快，又不怕忘記；
- 因為 HackMD 直接串我部落格，不用屈就於卡卡的編輯器；
- 因為 HackMD 做網站 CMS，非工程夥伴都很容易編修、上架文章；
- 因為 HackMD 跟我常用的 ____ 可以互串，加乘放大彼此的優點！

**專注做好一件事，跟好的軟體一起玩。將 HackMD 串進你的工作與生活。**

![](https://hackmd.io/_uploads/r1rclssTK.png)

如何取得 Note API 的 token：https://hackmd.io/@docs/issue-revoke-api-token-zh

API 文件與使用說明：https://hackmd.io/@hackmd-api/developer-portal

HackMD API Book：https://hackmd.io/@docs/HackMD_API_Book/


HackMD API 開放測試


# HackMD vs. Confluence

![](https://hackmd.io/_uploads/SJxOUgARt.png)

[toc]

![](https://i.imgur.com/x9IU9FZ.png)

During the pandemic, the work environment has been shaped in a hybrid working model. Whether you are a C-level executive or a small potato, you must be no stranger to participate in video conferences, instant chat, or working at the same platform to collaborate from a distance. 

I believe most of us were already using those tools for day-to-day jobs. However, if you are searching for more valuable tools now, I recommend two platforms for collaborative work and offer my view on them, which may help you to decide which one fits you and your team better.

# The Mindset: How are they different?

### HackMD is developer-centered

HackMD cares more about developers than Confluence does. So, suppose your work, your team, and your product must be in close communication with software engineers and developers, and the completion of product development is an essential indicator of your company's output. In that case, HackMD is a must-have tool.

Beside using Markdown, a plain-text lightweight language, onto which HackMD added features that developers can take advantage of. For example, handy code blocks that can customize line numbers easily, syncing individual notes with GitHub repos, and API for operating notes from terminal and command palette.

![](https://i.imgur.com/7Uu2GUL.jpg)


### Confluence means the Jira ecosystem

Confluence is an online documentation platform built for Atlassian Jira users. Though people usually view Confluence as a module in the Godzilla, eh, Jira ecosystem, it can be used as a standalone platform.

In the development project, not everyone is an engineer or a tech-savvy person. For non-technical staff in the team, Confluence provides a visualized workspace with many fancy templates to select from. There are templates for designers and HR people, marketers, and strategic planners.

![](https://i.imgur.com/82hdr46.jpg)

# Simplicity: Which One is Easier to Learn


### HackMD is simply the best workspace speaking Markdown

The HackMD platform itself is as convenient and lightweight as Markdown is. It takes minutes for Confluence to prepare your site for the first time, but only seconds to get into the editor of HackMD.

Developers can import files on GitHub, or just begin to make documents. Users who do not know any programming language, taking notes, sharing ideas, and working together on HackMD are intuitive.

It's in collaboration where HackMD really shines. Send the link of the note you are editing to other team members, with proper permissions set, they will get onto the same page as you in seconds.

![](https://i.imgur.com/jURACgt.jpg)


### Confluence is resourceful with templates

Confluence is easy to learn in that it not only looks like the old pals in the Office, one can basically use it as using Word. For employees who are reluctant to learn new things, Confluence is a path with less resistance.

The ample templates in Confluence also boost non-developers to produce acceptable documentations in relatively short time.

![](https://i.imgur.com/ZixbX4C.jpg)


# Accountability: Who should respond to this change?


### HackMD is not only about co-editing but also featuring the contributors

When numerous people working on the same document, you lose accountability, but not in HackMD. It marks edited segments with subtle colors in real-time and the editor's username is revealed on hovering. 

![](https://i.imgur.com/Gr5w3Vd.png)▲ Subtly colored underlines marking who's edited this part of text


All participants will be notified of changes in in-app notification center and/or via email.

Recognizing contributions is crucial in teamwork. HackMD fortifies accountability with design.

Moreover, this design emphasizing accountability further catalyzes decentralization. Every team member can work at her full pace individually, while never lose the pace of the team as a whole.


### Confluence: Centralizing means you may still need a go-to person


While organizations with the burdens of Office spontaneously welcome Confluence, it brings with it the centralized way of working together.

For example, there has to be a person being the primary generator of documents. This often leaves the project manager to be the one responsible for the documents and task assignment.

Living with the pandemic, a hybrid way of working is the condition your team must adapt to. Thorough centralization is never coming back. Choose wisely the documentation service that is more compatible with this movement.

# Portability: You don't want to be locked-in

Documentations can increase the productivity in large companies where collaboration goes on across various teams and numerous cohorts of engineers.

That said, if your documentations got locked in a certain platform, it will be a chronic headache.

While Confluence supports PDF, DOCX, and XML on exporting, its counterparts in HackMD are Markdown, HTML, and ODF. Confluence caters to bureaucratic needs in enterprises, while HackMD works in an environment of open standards.

Both HackMD and Confluence have API, though HackMD may play better with other apps, for most modern apps support Markdown, at least partially.


# Conclusion

To conclude, as we stated at the beginning, HackMD is a platform for developers, and Confluence is built for Jira users. 

Using Markdown as its foundation, HackMD is inherently open, flexible, and lighting-fast, and in just a few years, it has been loved and supported by over 500,000 users around the world, most of them are developers.

Since its launch, HackMD has been trusted as a collaborative project management platform and business knowledge center by enterprise users. Some enterprises rather not to put their data onto the clouds, they would opt for the on-premise version of HackMD.

If your company has adopted Jira, Confluence seems to be the go-to software when building a knowledge center. However, you should be careful of locking your organization in the Atlassian ecosystem. Being locked-in is an additional burden in a time of the pandemic, in which you would like the flexibility to opt for other choices to accommodate the harsh situation.

HackMD versus Confluence


{%hackmd ByjGFU4Kc %}

# *"Lez is more"* × HackMD
![](https://hackmd.io/_uploads/r1rQkKuUi.jpg)


## Product Experience

As a loyal user of HackMD, "Lez is more" is proud to introduce this user-friendly platform and explain how HackMD enables our work smoothly. 

First of all, *"Lez is more"* is a non-profit organization with team members working at various hours of the day and in different time zones. With the asynchronous co-editing feature, HackMD allows team members to cooperate and communicate on projects during their preferred time.

HackMD has a powerful full-text searching engine  - this specific feature improves work efficiency.

The great reputation of HackMD's domain inevitably creates a superior SEO (Search Engine Optimization), which enhances the exposure of our websites (and of course all the lovely contexts).

Regarding editing features, HackMD has numerous elements for creating pages beyond anyone's wildest imagination. The elements include but are not limited to tags, code blocks, different embedding services, and UML diagrams. Making a "wikihow" page or an "SOP" is considered a piece of cake with HackMD's typesetting and formatting system. HackMD's cross-device compatibility is beyond satisfactory in the viewing mode, however, it might not be the best idea to edit certain contexts (e.g. mandarin) on cell devices.

Overall, we are pleased with this platform and would like to share our experiences.

## Examples

Let’s make an example from the notes of the second issue of *"Lez is more"* EDM#2 (excerpts) down below:

:::spoiler EDM＃2（excerpt in Mandarin）

## EDM#2 嘿，你是不是也被這一切搞得好亂😵

### 1. 標題設定
本期大標題：嘿，你是不是也被這一切搞得好亂😵
真正的主題：同志社群不（只）是用來討拍

### 2. 寄發時間
改設平日，比對EDM#1假日寄發成效。

### 3. 連載專題
專題「生態域守則」是否連載？
> [name=Shin] 依據#2電子報會議2-2，暫停幾期，直到成員有空繼續發展後續守則，再依據屆時的電子報主題插入專欄。

### 4. 上期回饋
（正式取消，改為模板招呼）

嗨，深海收發機之前的訊息都傳送到[這裡](https://lezismore.org/author/sound-noise/)。


### 5. 社群回顧
主題專欄：過時的生態分類！

###### 參考資料：國立台灣大學建築與城鄉研究所_性別與空間研究室出版_《研究室通訊》第五期（1998-7-15），鄭敏慧〈女同志網站的一些側寫〉，頁135－143。

●性別與空間研究室大事紀
http://www.bp.ntu.edu.tw/?page_id=117

●《性別與空間研究室通訊》相關評論
https://women.nmth.gov.tw/?p=2134

**撰寫方向：**
#### 1)回應社群的標籤問題。
#### 2)依據論文中虛擬空間的觀察發展，虛擬酒吧與酒吧文化的建立，係依據空間使用者，集體記憶所及，並以對話建構而成。

我是誰？到處都是標籤貼紙，我要貼不貼？該選哪些來貼？

我們習慣先學習群體樣貌，再選擇一個位置，放置自己，一旦認同社群，就想捍衛並擴充這個想像的、虛擬的共同組織。我們攜帶這個身份在虛擬世界充實空間，確認自己，同時排擠他人。

真正的自我是什麼？在虛擬族群中建構自我，過程中，我有沒有得到充分探索的空間？顯然，我們對族群規則的辨認、理解、適應──甚至因此受罰──在這些情況花的力氣更多。

明明知道標籤無法適合每一個人，難道不該用吶喊的力道，讓自己透過表達，再次降生嗎？我們想要被愛，就只能用說出的每一個描述，創造真實。

 > [name=finezi] 能在現實生活中擁有愛，是因為成功讓人對你有真實的認識。也惟有真實認識你，才能愛你。

 > [name=Shin] Q：怎樣對於經驗分享來說，是相對好的描述方式？
A：
**○ 認知到現實與邊界**：
如果需求和慾望與自我/他人的性別身分高度相關，就需要把這點認知表達出來。
**X 反例**：
完全不講自己的認知，但是著重提出對他人的欲望跟要求。

###### 延伸閱讀 國立台灣大學建築與城鄉研究所_性別與空間研究室出版_《研究室通訊》第五期（1998-7-15），鄭敏慧〈女同志網站的一些側寫〉，頁135－143。

#### 3)回應社群想像的需求V.S.探索真正自我的需求

###### 頁135 網際網路最初確實是為了發動戰爭而生的，也許這就是為什麼我們現在也總在網路上發動戰爭：）1997年的時候，還只有學生和資訊從業人士會使用它，如今，你可能找不到完全不使用網路的人了。

###### 頁136 這個螢幕與鍵盤建立起來的世界，由於它的互動載體參照和現實生活中不同，人們會依據意願，重新建立專屬網路的互動人格。

 > [name=finezi] 本文特別關注匿名性，是否可以造成特定族群累積發言能量，以及，透過參與和表現，展現出現實生活中不能擁有的真實？

###### 頁137 美國社群網站the Lesbian Cafe，是一個模擬美國酒吧同志文化的網站，點酒、選位置、交談，營造虛擬空間中的真實感，也可以進行現實生活中不一定能夠進行、具有性意涵的對話。

###### 頁138 常客、新人、潛水族、惡意騷擾者
 > [name=Shin] 是否可以運用這個整理和觀察，發展虛擬對話的角色？

###### 頁139 這些角色的發展，也包含談論性的時候，語言使用的進展。透過共識，建立起凝聚共識的替代性社區。以便這裡一切豐足，而不需要回到現實世界。

###### 頁140 台灣部份，展現出一些蔓延到生活中的相關需求：租屋、購物、聚會。而淡江蛋捲廣場之拉子天堂事件，展現當時人們困擾於「辛苦建立的虛擬環境，被入侵就是遭到破壞」、「不想被窺探」的思維。

 > [name=Shin] 維護這些，需要建立「定義完善」的專屬區域，同時也限制了自身展現異質多樣的情慾論述、不同族群的情慾流動。
 > **回頭檢視**：邊界是什麼？如果沒有不正常，還需要凝聚共識嗎？→或許就不會需要→是的，我們非常，並且為付此出代價，但也有我們的路要走。
 > **繼續推進**：瞭解、建立情慾主體性需要什麼？→在濡沫消失之前，儘可能模糊邊界，但清晰化自身主體性的自由。

### 6. 網站介紹
推廣概念：濡沫更像/也期待是共異體

###### 參考資料：〈高雄作為一座好客的城市：與洪世謙談民主、人民、政「峙」〉，2018年11月30日《破土》編輯陳黃金菊採訪中山大學哲學研究所教授洪世謙。

https://newbloommag.net/2019/06/29/hung-shi-chian-interview-tw/

**撰寫方向**

為「女同志」畫下疆界，並產生相應罰則，那並不是找出「我是誰」唯一方法。濡沫更像共異體，互相漂浪、彼此激盪的生態域。

> [name=Shin]1. 「容納」有非常現實的極限，也有代價。
> 2. 聲音無論如何都具有破壞性，但每個人都覺得別人會破壞我、自己卻不會破壞別人。
> 3. 現實就是濡沫(或任何交友平台)都「無法」做到「排除」這件事。

###### ▲轉化段落A 把「城市」理解為一種環境／介質（milieu），就是一群差異的人來這裡找尋自己生活的方式。所以，城市所呈現出來的整體風格，其實與裡面居住的人對這個城市有什麼樣的理解和想像有關。城市其實是一種共構而成的構體（corps），在構體裡，因為每個人有不同的願望、想像和生存的環境，所以會呈現出一種「共異體」的樣貌。「共異體」指的是差異的個別存在，只是這種存在，在最後會顯示出一種特異（singularity）的樣貌，所以其實是一種「環境」的概念。

###### ▲轉化段落B 每個人都是移動的參與者，只是移動的時序先後有所不同，但每個人都可以在此空間中找到自己想要生存的方式。

###### ▲轉化段落C 不同的階層的人會有彼此之間不同的生活關係，但如果這種生活關係是共構且相互影響的，我們要問的是，要如何讓那些在經濟、文化資本、社會資本弱勢的人，依舊有能力活在這個城市裡。所以我認為這是一個環境，一個複雜的共生系統，複雜共構、共生才讓這個城市有各種不同的樣貌，才得以顯現不同的活力、生機、動能等等。

###### ▲轉化段落D 所謂的「無疆界」指的是保留疆界變動的可能性，疆界是一個隨時可以挪移並不斷擺盪（bascule）的過程。

###### ▲轉化段落E：民主的防禦機制 假設我們認為民主該是有各種歧義、各種差異的聲音，那麼，任何對於讓各種差異的聲音不再可能的事情，我們都必須要預防。換句話說，疆界劃分出來之後，有一群人屬於該處，另一群人就遭到排除；如果疆界可以不斷吸納各種人，每一個人才能都成為移動的參與者。我們在這裡遇到衝突的問題：假設這些移動者，和原居民有價值觀衝突，該怎麼辦？

> [name=finezi] 究竟是先廣招住民，再逐漸修正排斥意識，還是一開始就應該以移動參與者的目標招募原住民？

 > [name=Shin] 當我們思考的不是把疆界作為排除的線，而是作為我們可以容納到何種範圍的線：誰還不是？誰被排除了？

> [name=finezi] 如何擴大疆界，直到我們能夠自由而深刻的生活？只要這裡是你生存的環境，是你賴以生存的空間，你就會參與其中，直到取得能夠容納自己認同身份的生存環境。

:::

:::spoiler How to use *"Lez is more"* community（Mandarin）

https://hackmd.io/@lezismore/forum-instructions

:::

## About *"Lez is more"*
[![](https://scontent.frmq4-2.fna.fbcdn.net/v/t39.30808-6/309042372_417875037134955_6512056882869513612_n.jpg?_nc_cat=100&ccb=1-7&_nc_sid=e3f864&_nc_ohc=HRQGUh4wrfoAX9R0mgl&_nc_ht=scontent.frmq4-2.fna&oh=00_AfCgV9C0sfz6d2LmecnxzBYMdCXOoYRN1GBVnj99ReTklg&oe=63642ACB)](https://lezismore.org)

Women, lesbians, and sexual minorities have been suppressed from their sexuality by mainstream society, not only in the heterosexual world but also in the LGBTQA community. Instead of embracing all the possibilities throughout the sexual spectrum, we use labels to compartmentalize and even marginalize some groups. We neglect their needs to express themselves, their desires, their urges, and their sexualities.

"Lez is more "' aims to deconstruct unnecessary stereotypes and stigma, expand the spectrum (of women, lesbians, trans, and others..etc), and embrace all possibilities beyond our imagination.

The Chinese idiom "xiangruyimo" 相濡以沫 means sharing/merging resources by moistening others with spittle - if explained literally. Our website is named after the phrase with modification. "Lez is more" has not only similar pronunciation as "xiangruyimo", it also represents multiple meanings, and different perspectives - "let's/less/les be more".





Lez is more× HackMD


# 資訊整合：使用者需求「即時性、社群化」的應用


## 餵養時代，被淹沒的「有效資訊」

你我是否都習慣了「資訊餵養」？

資訊擁擠，社群媒體及通訊軟體上的**資訊**隨手可得，卻很難判別正確性。更糟糕的是誤用，造成假訊息的傳遞。

為整合即時且正確的**有效資訊**，需要一個開放共筆、且能不斷更新的平台，快速登打文字，加以段落補充、修訂。爭奪「注意力」的戰爭，更需要簡化排版、置放圖片或插入影片連結，開放留言補充、查核更正，展開討論。

基於上述需求及平台特性，使用者們，造就了 HackMD 資訊整合的應用。

>「協助**社群組織知識**，以便他們能夠**把自己組織得更好**。」
>[name=Jeff Jarvis - 媒體失效的年代]

## 	搭建平台，群策群力，人人皆可貢獻

過去幾年，當災情或疫情發生時，都可看見使用 HackMD 來統整重要資訊，其中 [g0v 零時政府](https://g0v.tw/) 是最具代表性的社群組織，以 **「不要問為什麼沒有人做這個，先承認你就是沒有人」** 的精神搭建資訊平台，使人們免於流失在擁擠的資訊海當中。從 2018 年開始，便將 HackMD **即時協作** 的特性，發揮到淋漓盡致。

![](https://hackmd.io/_uploads/HJtGvS_it.png)

使用**書本模式**，預先結構好需要的資訊章節，將不斷更新的官方資訊置頂，相關的媒體報導，能夠收整歸納。同時，讓急難救助等急迫、有效的最重要資訊得以凸顯。資訊整合，都歸功於自發性的群策群力，追求「去中心化」的社群組織，讓每個人都有機會「鍵盤」發聲，為其貢獻。

#### :bulb: 災情、疫情的資訊整合平台的應用
[【COVID-19 Info 疫情資訊野生整合平台 powered by g0v.tw】](https://g0v.hackmd.io/@yitzu/covid-19)
[【2021-04-02 太魯閣號列車脫軌事故災情整合平台】](https://g0v.hackmd.io/@jothon/20210402TarokoCrash)

#### :bulb: 使用者公開分享「災情整合平台」的範本
> [HackMD 災情整合平台範本](https://hackmd.io/@brlin/hackmd-disaster-information-integration-platform-template/https%3A%2F%2Fhackmd.io%2Fs%2FryP31Chom) [name=credited by 林博仁]

## 書本模式的特性：數位文件整合平台
不論是資訊整合或是知識管理，[書本模式 (Book Mode)](https://hackmd.io/c/tutorials-tw/%2Fs%2Fhow-to-create-book-tw) 的使用扮演了極為重要的角色，做為[企業知識管理的解決方案](https://hackmd.io/@hackmd/Knowledge_Management)，也常見製造業客戶用於**紀錄標準作業流程 (SOP)**及各類管理文件**（例如：環安衛管理手冊、ISO 文件化管理等等）**。

總結書本模式的特色如下：
* 匯集單篇文件
* 編輯主題章節
* 支援外部連結
* 書本閱覽體驗

## 整合平台的應用，解決「資訊爆炸」的弊病

以即時文件協作做為基礎，不論是個人、組織到企業，延伸應用皆是為了解決**資訊爆炸**的問題。整合呈現、邏輯化、平台化的需求，以及使用者自發性應用的解法，正是 HackMD 作為數位生產力工具的價值所在。



資訊整合：使用者需求「即時性、社群化」的應用


# 線上學校與數位文件的完美搭配：ALPHA Camp 如何使用 HackMD

![](https://hackmd.io/_uploads/rybKH82W9.png)

ALPHA Camp 是一間以創新教學方法著稱的線上學習網站，重視職涯導向的教學與陪伴，涵括了「不只是寫程式」的課程內容。HackMD 的創辦人 Max ，也曾經到 ALPHA Camp 分享他做產品的心法：「解決自己會有的問題，打造自己會用的工具」。

聽聞 ALPHA Camp 的教練團隊也使用 HackMD 時，我們非常開心。一直以來，HackMD 的使用者當中，**開發者**和**教育社群**（老師、學生）的佔比最高，ALPHA Camp 不僅兩者兼備，而且他們的「學習教練團隊」非常重視「溝通」，不僅是團隊內部的溝通，在教練跟學員之間，前者更像護法一樣，一路扶持後者成為獨當一面的開發者。所以 ALPHA Camp 選擇利用 HackMD 協助團隊實現這項價值，是一項深刻的肯定。

在這道學習橋樑上，HackMD 是穩定、合用的數位協作平台。讓我們接著了解 HackMD 是怎麼協助教練和學員溝通的。

## 注重學員溝通的「學習教練」

我們邀請了學習教練團隊的 Yunju 與 Ken 受訪分享他們的使用心得。一開始，他們便很熱心說明教練的使命與任務，說明這項介於課程與學員之間的陪伴工作，是幫助學員成功的重要關鍵。

課程有沒有效、如何管理學習目標，都是教練群的重要任務，每個月，有高達上百位學員同時進行溝通，因此他們說：「文字是很重要的媒介」。

原來，學習教練團隊內部的文件，都是存放在 HackMD 的團隊工作空間裡面，所有教練都能看到彼此建立的文件。他們用標籤管理數個分類，再各分類下創建、更新文件。新教練一加入，就能看到團隊累積的所有知識。過去，他們也曾用過 Google Doc 來放文件，但對這群重視協作、溝通品質，也特別在意編輯器體驗的夥伴而言，HackMD 仍是首選。

>[name=Yunju（ALPHA Camp 學習教練）]「編輯器太強了！文章在上架官網前，我們會先在 HackMD 編輯。」

>[name=Ken（ALPHA Camp 學習教練）]因為跟學員的溝通訊息，需要根據他們的狀態去做編修，HackMD 同時把筆記存放在工作區，只要針對每次修改刪減的內容去編輯就可以了。

除了編輯體驗、協作方便以及筆記存放在共同的工作區，HackMD 有哪些功能，是他們特別善用且帶來幫助的呢？教練們提到，其實跟學生權益有關的事項，會需要非常細緻保存版本，為每次的細節增修留下紀錄，因此除了 HackMD 本身的版本紀錄外，重要文件還會==一鍵推上 GitHub 備份==，兩地同步既方便又添一層保障。

另外，許多進階的 HackMD 使用者，都會透過==客製化 CSS==來設計自己喜歡的樣式。在 ALPHA Camp 的使用案例中，他們有官網跟不同課程的教材，使用 HackMD 來搭配官網和教材的顏色與字體，又能設計出相同的風格，讓官網與文件各司其職，也能達到整體一致性。

## 學習教練，是搭配多元的數位工具來「寫東西」

當然，教練們不只使用 HackMD，也會用 Notion 做個人筆記，只是使用的時機不同：如果要放檔案、呈現公開頁面，多功能整合的 Notion 是熱門選擇。不過教練們也分享其中的差異。

他們認為，「Notion 的編輯器難用，typing 體驗差」，有時是程式碼要 code 起來，或是複製貼上等指令，使用起來會相對「卡」。開發者社群更注重編輯器本身的流暢度，最好一切操作都能用鍵盤完成，而 Notion 需要大量使用滑鼠則是一個劣勢。

HackMD 目前還沒有手機版的 app，用瀏覽器編輯也會遇到「卡」的時候，所以他們也提到會用 Typora 做搭配。重點是，只要用 Markdown 寫作，不同軟體來輔助手機操作或者離線編輯，都可以透過簡單的複製貼上回到 HackMD 的團隊工作空間，夥伴之間的查看與協作，不會漏接。

教練跟學員之間的溝通，需要透過文件的更新與資訊對齊來達成；同時，教練與教練之間，仍可以選用不同的個人筆記方式，再回到共同的 HackMD 工作空間協作。

對於數位協作平台的摸索、搭配官網及其他工具的選用，ALPHA Camp 的夥伴們會互相配合、包容彼此習慣的工具，也會確保彼此合作流暢與同步，體現了他們既自由也重視合作的精神。

## API 開啟全新可能

往後，HackMD 還可以如何協助 ALPHA Camp 的教學使命？對於經常需要撰寫文件、上架公告的教練而言，他們還是強調「編輯器很強」，最希望能串接到學習平台與官網。

HackMD 剛釋出 API，==開發者可以利用團隊筆記 API，取得團隊內筆記列表與其內容==，將良好的編輯體驗與工作空間，活用在各個團隊及企業當中，或許，這也是 ALPHA Camp 跟其他專案團隊夥伴可以探索的一塊新的應用場域。

從學習教練的使用經驗，我們能看到一個成功的團隊，善用各種數位工具來搭配既有的網站和業務內容。這些 ALPHA Camp 的靈魂人物，相當善用 HackMD 的快速、設計彈性與可課責性等特徵，讓「以文件串接彼此」的高效溝通，幫助學生獲得最豐富的成長。



線上學校與數位文件的完美搭配：ALPHA Camp 如何使用 HackMD


# HackMD vs Notion

![](https://hackmd.io/_uploads/Hk2-51_ot.png)


[toc]

## Overview: HackMD is more focused

Both enjoyed by many, HackMD and Notion have often been compared, especially among developers. This post will give you an overview to alleviate the burden of deciding which one to adopt.

HackMD was built by developers who see the importance of, but also the snags in making, documentations. Its focus is to get what's on your mind in Markdown quickly, offering enough extensibility to the content at the same time.

On the other hand, Notion labels itself as an "all-in-one workspace," which highlights the generalist approach in designing the product.

So if you are in a hurry, just take this idea away: Notion is for persons who handle volatile tasks and whose missions involve frequent context switching. ==For a team of developers, HackMD may be a better option== for it is lightweight and lightning fast.

## Note-taking

Notion is about building a system. HackMD gets you to the note-taking way faster.

You can create databases, issue trackers, plan projects with Notion, and people are not wrong about it for that part, albeit you probably don't have time toying around in Notion. You have greater missions than that.

HackMD lands you to the full-fledged editor once signed up, and you can jot down what you think right away. Notes are all in your workspace and you can locate them easily with the [Tag List](https://hackmd.io/c/tutorials/https%3A%2F%2Fhackmd.io%2F%40docs%2Fhow-to-use-tag-list-filter) and search.

While there are no fancy blocks in HackMD like in Notion, HackMD's editor is fully capable of [embedding different sources into the note](https://hackmd.io/s/features#Externals).

## Portability

Both apps can export all notes in a workspace into Markdown files.

HackMD works from bottom up and recommends its users to write documents in Markdown in the first place rather than parse the content into Markdown, like how Notion exports.

Due to its recommendation, HackMD has the merit of keeping content indeed as Markdown.

## Ease of use

HackMD is easier to learn than Notion is.

While you can build a car that you can drive with LEGO, you will not drive one on the road. For the same reason, you can take notes with Notion, but you should choose HackMD for it's the car that can carry you in the real world.

## Administration

Notion has a better admin toolset than HackMD does.

You can create permission groups in Notion, while in HackMD, you have to set permission for each member one by one.

## Pricing: Notion costs more for teams

Both HackMD and Notion are affordable for individuals. However, HackMD is 37.5% more affordable than Notion in teamwork, since the latter charges US$ 8 per month (paid annually), while its counterpart charges US$ 5.

It's crucial that you are not paying for irrelevant features. For a team focusing on writing documents and referring to them in one's workflow, HackMD could be a more viable choice.

## Final thoughts: HackMD may suit you better

You may find a lot of fun in Notion building all kinds of tools, but at the end of the day, expressing yourself, leaving traces for other people to follow up your train of thought, is the central value team wiki apps can propose. In that case, HackMD is better than Notion.

Not everyone takes a generalist approach, you can be a more focused doer.

HackMD versus Notion


# 混成教學(Blended Learning)：師生協作，強化自主學習成效

![](https://hackmd.io/_uploads/rkeyFs4KF.png)


疫情不只影響全球企業，也加速傳統教育的轉型，根據 OECD 於 2020 年的調查，在歐洲，超過 5 成的國家認為虛實融合的「混成教學」[^blended-learing]模式將成為新趨勢。

[^blended-learing]:https://www.oecd-ilibrary.org/education/teachers-as-designers-of-learning-environments/blended-learning_9789264085374-7-en

過去一年，國內外許多大學教授紛紛來信詢問 **HackMD 教育方案**，原先已經在使用 HackMD 做為教學工具的頻率也大幅增加。

究竟，文件即時協作服務是如何成為了遠距教學不可或缺的利器？

## 後疫情時代的教育關鍵字：混成教學 (Blended Learning)

>教育部資科司長郭伯臣表示：「遠距教學建議採取雜揉同步和非同步併進的「混成教學」 (Blended Learning)模式。」

何謂「混成教學」，其實並未有一致的標準，主要概念以課程內容以線上同步及非同步的方式搭配進行，其主要目的是為了強化學生整體學習的 **參與感（Engagement）及自主學習（Active Learning）** 的能力。混成學習不是將實體課程及教材搬到網路上進行，教師需要掌握以下重點來重新設計適合的課程。
- **設計明確的教學目標**
- **創造互助學習的機會**
- **強調自主學習的能力**
- **重視師生協作及互動**
- **紀錄學習過程及成果**

## 關注課程執行和師生互動的成效
>「從 2016年 開始，成功大學的[『Linux 核心設計相關課程』](http://wiki.csie.ncku.edu.tw/linux/schedule) 採用 HackMD 作為師生協作平台，直到現在 2021 年仍持續使用中。HackMD 的即時線上筆記協作，對課程執行和師生互動的成效有顯著的幫助，讓我可以在強調實作的課程當中，藉由師生的相互協作，去追蹤學員個別的課後學習狀況。」
 [name= 黃敬群 (Jserv) 助理教授]

黃敬群助理教授表示：「對於實作導向的課程來說，學生是否在課堂時段『專注』，不是最關鍵的議題，例如課程提供講解的錄影，學生若是無法會意，課後可以看錄影複習。但傳統的問題一直都是，無法即時知道學員的實作狀況，但有了 HackMD，就能要求學員更新作業並由系統主動發訊息告知，我還能在及時給予眉批和改進建議，而不用等到作業繳交截止日才知道。」

學生透過 HackMD 提交作業，教授可直接於作業內進行審閱及意見回饋，不但支援多種程式語言的程式碼 highlight 顯示，相較一般文書軟體，數學式及流程圖都需要較為複雜的編輯，在 HackMD 上都可輕鬆編輯。

程式碼範例：

![](https://hackmd.io/_uploads/rkBbjkMYK.png)

```javascript=
var i = 0;
```
此外，對自己期許較高的學生，教授也會利用共筆，額外指派作業要求和精進的建議，學生就會受到鼓舞，並得以在專業上強化，利用數位工具輕鬆達到因材施教的目的。教授還利用 HackMD 讓學員相互評論彼此的作業，互相指出優缺點，教學相長。


除提供學生製作專題文件有很好的呈現效果，有許多學生也利用 [**書本模式(Book Mode)**](https://hackmd.io/s/how-to-create-book-tw) 將過去的學習成果收整成自已的 **學習歷程(E-Portfolio)**，或者編輯自已的 **個人履歷(Resume)**，有豐富的情境可以運用。

## 同步及非同步兼具的互動協作
黃敬群助理教授進一步分享：「隨堂測驗也使用 HackMD 來進行，事先建立個別學生的筆記，要求學員在測驗期間作答，助教和我就一邊評分，還能互動地給予講評和改進建議，這樣就能讓測驗期間也有學習效果。」

利用 HackMD 同步協作的特性，課程進行時，學生們可將其問題留言於文件內的「問答區塊」，助教可即時回覆或整理問題後交由教授統一回答；至於課堂上來及不完成的，就交給非同步解決。

課後，除了可持續於文件內留言提問，學生之間也透過共同筆記進行分享及討論，讓不常在課堂上發言的同學也有機會參與，除賦予學習延伸性也強化學習動機。

## 創造自主的學習環境
使用數位工具並重新設計教學方式，目的是透過互動討論與實作，讓學習者能提升自主學習的能力，而非單純的接收知識，教師也需要轉換角色，不再只是講者，而是引導、帶領學生創造自主的學習環境。

>Blended learning seeks to use the potential of new technology to offer more individualised teaching and direct instruction.[name=Teachers as Designers of Learning Environments(OECD iLibrary)]

新科技、新工具輔助的混合教學，有國際理論與在地經驗的實證。文件即時協作服務，成為了遠距教學不可或缺的利器。

混成教學(Blended Learning)：師生協作，強化自主學習成效


# 文件：後疫情時代的新課題，企業如何管理遠端協作並保持生產力


自疫情爆發，Work From Home 已經成為工作常態，許多國內外的企業紛紛鼓勵員工在家工作，甚至大方贊助居家辦公所需用品，只為了降低員工感染的風險。

如今疫情減緩，當企業要求員工回到辦公室恢復過去的辦公型態，多數的員工卻希望維持「遠端工作」，甚至不惜主動辭職尋求可以遠端工作的職務，企業主這才發現一切都回不去了。

實體、遠端工作的溝通與轉換，該怎麼辦？

## 遠端工作是趨勢，如何管理保持生產力是新課題

2019年 VMware 的《數位化員工體驗調查》顯示，78% 的亞太地區受訪者希望能 **「更輕鬆地在辦公室以外的地方工作」**。

而最新一期的《麥肯錫季刊》表示，自 2021 年 4 月以來掀起了大離職潮 (The Great Resignation)，已有超過 1,900 萬美國員工主動辭職（持續增加中），人們並沒有在逐漸復甦的經濟下擁抱工作，反而選擇在高失業率的狀態下，離開現有的工作型態，其中遠端工作的職務成為了熱門選擇。

產業結構發生變化，部署遠端工作的企業組識，該如何管理遠端協作並保持生產力，成為了新的課題。

## 線上會議效率不佳，可能乎略了會議紀錄的重要性

因為疫情無法進行實體會議，企業大量啟用各家視訊會議服務來進行會議討論，少了面對面的監督，發生了許多問題讓會議效率大打折扣，除了會議無法準時開始、話語權不均、容易離題或分心，更嚴重的是，因為缺乏組織性的管理及紀錄，最容易發生 **「會而不議、議而不決、決而不行」** 三種狀況。

文字紀錄，是為了為確保與會者對過程及結論的認知一致，此時會議紀錄的重要性更為突顯。

**掌握會議紀錄三大重點**
* 議程（Agenda）
* 關鍵人物（Key Person）
* 執行決策（Action Item）

## 建立議程，任務指派，進度追蹤


公司成員分佈在兩個時區，基本維持遠端辦公 (Remote-Work)，會議都需以視訊方式進行，讓我們來看看 HackMD 業務團隊如何使用自家的文件協作服務來完成會議紀錄。

1. 事前準備效率加倍
    - 在例行會議的前一週，就預先建立會議文件並套用設定的範本，團隊成員就會各自依照議程大綱編輯內容，需要補充的檔案資料或圖片，可透過上傳、嵌入 iframe 或使用建立連結的方式整統於會議文件內，這樣一來會議上需要討論及決策的項目也可以明確有效的進行溝通。

2. 善用標記帳號功能
    - 若有需要同仁協助或是指派任務的事項，在文件內 @標記帳號，負責執行的同仁便可收到通知並進行確認回覆，這樣一來也大大減少因課責不明產生的問題。

3. 協作編輯權限分層
    - 難免會遇到臨時性的會議，與會者以即時協作編輯的方式將會議討論過程給紀錄下來，內容上有誤解或落差的部份也可立即提出修正，主要為了能將會議過程還原並確認共識，若有需要補充之處，會後也可編輯修改，HackMD 會自動標註編輯者及版本控管功能。
    - 若需要與客戶或外部合作夥伴進行會議時，因文件與使用者權限各自獨立，可邀請訪客到指定的議文件協作，並設定編輯或閱讀不同的權限管理。

4. 紀錄問題臨時動議
    - 會議過程中，團隊成員也習慣先將問題紀錄下再進行討論，避免影響議程的進行，造成會議時間延宕。

5. 留言討論追蹤進度
    - 紀錄好決策項目並標記各項的負責人後，剩下的就是追蹤執行進度。過程中，除了在通訊軟體上即時溝通，由於分屬兩個不同的時區，有時太過即時的通訊軟體反而是種打擾；所以，團隊習慣在 **文件段落內使用留言功能**，除了讓討論重點更聚焦，也方便隨時補充重要資訊讓內容更完整。

## 效率來自信任，打造高效、數位的工作環境

打造數位工作環境需先盤點自身的需求，制定遠端工作策略並選擇最適合團隊運作的協作工具組合。除此之外，企業管理者需積極建立團隊溝通及協作的管道，培養注重結果的工作文化，而非固守既定辦公形式。

從微觀管理 (Micromanagement) ，轉向尊重與信任，讓人才無論在什麼地方，都能夠發揮所能。信任，是後疫情時代的課題，也是企業如何留住人才提升競爭力的關鍵。



文件：後疫情時代的新課題，企業該如何管理遠端協作並保持生產力


# 技術：なぜ漢字をタイピングする際、漢字が割れますか？

![](https://i.imgur.com/TSqyqSg.png)


漢字を入力するあなたは、「漢字割れ」という苦境に陥ったことありますか？例えば、「共同」と二文字を入力したいのに、「kyoudou」になってしまって、そのままウェブページに表示されて、どうしても漢字に合成されません。

この問題について、テキストエディター自体は「コンポジションイベント」がちゃんと処理されなかった可能性があります。フェースブックメッセンジャーもちゃんと「コンポジションイベント」が処理されなかっただろう…毎回更新すると痛い目に遭う。

今回の内容は皆さんに簡単に「キーイベント」と「コンポジションイベント」、またこのイベントと「グループウェア」の関連性を紹介します。

この紹介を通して、 HackMD の中にどんな技術を秘めているのかを理解するための最初の礎になると思います。
 
:point_right: [HackMD Blog](https://hackmd.io/@hackmd/blog-tw)

## タイピングは入力するだけなのでは？キーイベント（Key Event）を紹介する

![](https://i.imgur.com/280Cfej.gif)

ウェブブラウザーの文字は、キーボードを押した瞬間に、「キーイベント」が執行されます。簡単な動きに見えますが、実は三つの操作が含まれます：keypress, keydown, keyup.

ここは先に **keydown** と **keyup** を紹介します。==Keydown==とは、名前通り、「押した瞬間」とのことで、キー毎に相応なキーコードが存在し、キーを押すと、そのコードが取得できます。同じに、==keyup==とは「指を離した瞬間」とのことです。

例えば、「h」キーを押した際、キーボード上は「h」と書いて、モニター上のウェブページも「h」と表示されて、非常に単純なことです。

```
keydown: h
keyup: h
```

だが、漢字を入力する際、例えば「共」という文字を入力する場合、発音入力の間、「共」が出てきて、更にスペースキーを押すことで、リストから「共」を探すため、もっとスペースキーキーを押します。

ではどうなるんでしょうか？


```
keydown: k
keyup: k
keydown: y
keyup: y
keydown: o
keyup: o
keydown: u
keyup: u
keydown: Space
keyup: Space
keydown: Space
keyup: Space
keydown: Enter
keyup: Enter
keydown: Enter
keyup: Enter
```

ここまで見れば、英語と中国語がウェブページに入力する際の違いが理解できるだろうと思います。

### keydown と keyup は違いますか？

上の down と up のコロン以降の内容は同じじゃないですか？と思えるかもしれません。

先ほど説明した down とは「押した瞬間」とのことですが、もし一瞬間押すではなく、押しっぱなしになると、キーイベントは「連続発生」になり、逆に、 up とは指を離した瞬間のことですので、連続発生ができません。

「共」の例から見ると、例えば家の猫 :cat2: がキーボードを踏んで、「kyou」を入力した直後、猫の手で「スペース」何秒押しっぱなしにすると、キーイベントがどうなるんでしょうか？ 

```
keydown: k
keyup: k
keydown: y
keyup: y
keydown: o
keydown: u
keyup: o
keyup: u
keydown: d
keyup: d
keydown: o
keydown: u
keyup: o
keyup: u
keydown: Space
keydown: Space
keydown: Space
keydown: Space
keydown: Space
keydown: Space
keydown: Space
keydown: Space
keyup: Space
```

そこで六つの keydownがあると分かります。ただ keyupが一つだけです。そうすると、両者の関連性が分かると思います。キーボードでパソコンゲームを遊んだことがある人なら、ここでなんとなく分かるだろうと思います。~~~射撃する際、押しっぱなしでは連続発射できますが、狙ってキーを離した瞬間に発動するボムだと一回しか投げれません。多分そうした仕組みで射撃とボム投げがよくkeydown と keyup と設定されるだろう。~~~

### では keypress とは何でしょうか？

続きまして、 keypress とは何でしょうかを紹介します。名前通り、押さえることです。でもこれって keydown と同じじゃないでしょうか？いや、ここの操作は「文字キー」と「非文字キー」の間に差が出ます。

例えば、「h」を押すと、一つアルファベット「h」が表示されますが、「enter」キーだと「文字を表示」というイベントではないので、これに相応する keycodeしか執行されません。

**keypress は「文字を入力するキー」しか効果ありません。**「Esc」、「Enter」みたいなキーでは効果がありません。

例えば「英語の大小文字」の件ですが、キーが同じ「h/H」でも、 keypress という操作があるからこそ、違う keycode を取得することが区別できます。これは down と up だけでは判断できないことです。

## ではなぜ漢字をタイピングする際、割れることになるんでしょうか？コンポジションイベントを紹介（Composition Event）

Keydown、keypress、keyup を皆に紹介するのはもう一つ重要なことを強調したい目的があります。

先ほど説明していた keypress は「文字を入力するキー」しか発生しませんので、漢字を入力する際、次の問題が気付くかもしれません。

平仮名を入力するタイミング、漢字が入力されてますか？

平仮名では keypress の操作が発生しますか？ほどんとの状況が「ノー」です。:no_entry_sign: 

先ほど「共」を入力する際、キーボードイベントから keydown と keyup の動作を分解しました。 down もしくは up がまだ個別のスペルだけで、==まだ漢字出てませんよね==？


```
keydown: k
keyup: k
keydown: y
keyup: y
keydown: o
keyup: o
keydown: u
keyup: u
keydown: Space
keyup: Space
keydown: Space
keyup: Space
keydown: Enter
keyup: Enter
keydown: Enter
keyup: Enter
```

:eight_spoked_asterisk: ここでポイントです。もしテキストエディターの中に CJKを使いたければ （中国語、日本語、韓国語）、例えば中国語入力みたいなことで、私たち必要なのはキーボードイベントだけではなく（Key Event）、 **コンポジションイベント（Composition Event）** も必要です。

例えば、先ほど入力法で入力した「共同」の場合
「Kyoudou」の後はまた漢字リストから正しい文字を選びます。コンポジションイベントはこうなります： 

```
Composition Events:
compositionstart:
compositionupdate: k
compositionupdate: ky
compositionupdate: きょ
compositionupdate: 喬
compositionupdate: 喬d
compositionupdate: きょうど
compositionupdate: 匈奴う
compositionupdate: 共同
compositionupdate: 共同
compositionend: 共同
```


コンポジションイベントの過程では キーイベント の「Space、Space、Enter」と同時にコンポジションイベントの「きょうど、匈奴う、共同」に転換することに見えるでしょう？

これこそコンポジションイベントで、キーイベントと違って、「合成が必要な言語」しか出てきません。

>P.S.：ブラウザー毎のデスクトップ、モバイルの違いによって、違う結果も出てきます。[私たちの開発者 Maxさんから作った codepen](https://codepen.io/jackycute/pen/EvNmWv)でテストしてみましょう。 

## 「コンポジション」を処理するがどうかによって、結構違います

なぜたまにソフトウェアサービスが良いのに、更新した後、中国語入力がスムーズに使うことができないんでしょうか？よく「割れ」が発生し、コンポジションがうまくいかないでしょうか？~~例えばよくアップデートする フェースブックメッセンジャー~~

実は、色んな文字編集の方から「コンポジション」を受け取る際、「合成する間、現れた『字』」という要素の考慮を欠けていて、テキストエディターの中に、処理しなかった可能性があり、もしくはソフトウェアを更新する際、言語テストを忘れる可能性もあります。

>この文書を書いてる同時、私たちのメンバー [Yukai]((https://hackmd.io/@Yukai)) さんも VSCode に対して、コンポジションイベントの文章を発表することを気づきました。 PR: [Fix backspace in IME composition on iOS Safari](https://github.com/microsoft/vscode/pull/40546)。

## 更に「コラボレーション」！

もしテキストエディターは言語入力の中に、「コンポジションが必要な言語入力」を考慮しなければ、keypress 側は「コンポジションの間に生まれる『準文字』」が漏れることになります。
勿論、考え方を変えると、もしコンポジションの言語のユーザーがいなければ、このような需要や問題も存在しなくなる。

更に重要なのは、もし「コラボレーション」エディターはキーボードイベントだけでなはなく、コンポジションイベントのことも考慮しないと、リアルタイムコラボレーション（Realtime Collaboration）上では様々な難関が出るだろう。

ソフトウェア毎にターゲットが違い、例えば Notion は同一ブロックのコラボレーション処理が少な目です。同時編集の際、相手がどこにいるのか見つからなくて（カーソルが表示されません）、同時同じブロックを編集すると、一方が上書きされます。

>「コラボレーション」をテストする一番厳しい試験は皆が一緒にエディターの中で同じ行を入力してみて、何が起こるのか確認します。

キーボードイベント、コンポジションイベントを紹介する目的は将来「コラボレーション」という技術を説明する際、解決策を理解できるようになるためです。

## テキストエディターが「コンポジション」を処理したことがどうやって分かるんですか？

文章の最初に、「中国語割れ」という状況を提起しましたが、これは多くの人がGoogle Doc、Dropbox Paperを使用する時、同時入力する際遭った経験です。 

コンポジションイベントを邪魔する要素は色々あって、ソフトウェアのアルゴリズムをもたらしたい体験によります。

HackMD は keypress のほう、「コンポジションの過程」（注音入力法に言うと、注音符号を合成して漢字を選ぶ）も一つのイベントとしてお送りますので、パートナーと一緒に作業する際、相手側の「コンポジションの過程」が見れます！

ミーティング、共同編集は丸見え感があるかもしれません。入力する過程が全部リアルタイムで表示されます。

## お使いになるソフトウェアはコンポジションイベントを送ったりしますか？


違うエディターとメモ用ソフトウェアによって、やり方が違います。思い出してみてください。

>「コンポジションの過程」はグループウェアのドキュメントに出たことありますか？ 

例えば共同作業の方が「共同」二つの漢字を入力したい場合：

- ドキュメント上は ==「Kyou共 Dou同」== のような表示見たことありますか？ 

それとも、相手は直接「共同」が出てくる

- その後、0.X秒の間隔で、カーソルカラー、アンダーバーが点滅し、また相手は「協同」、「教導」、「京道」の文字が出てきますか？


もしくは、何秒待った後、相手は既に入力済み。

- その後、また「共同」二文字に見えますか？

やり方はそれぞれメリット、デメリットがあります。タイピングの流暢性、文字入力の速度を優先するHackMD にとって、コンポジションの過程も考える必要があって、同時にサーバー側に負担も重くなる。これをプロダクトのコアバリューによります。

## メモ用ソフトウェアかと思っていたが、オンラインゲームだった

HackMDの開発者 Max さんはある一言が言っていた：**「これはマルチプレイオンラインゲームみたです！」**

一人入力だけで、テキストエディターにタイピングし、文字入力の表示の速さだけでも重要な体験でした。

二人、三人、三十人など、同時に同じテキストエディターに閲覧、編集の際、まるでマルチプレイオンラインゲームみたいです。あるプレイヤーは一つの動きをし、もう一人のプレイヤーがフィードバックを受け取る。ゲーム内のキャラクターは複数キャッチボールや干渉を処理し、うまくクリアできるのか。

一つ嵌めることで、巨獣がいきなり飛んでくるみたいな感じで、プレイヤーが逃げる時、ポータルを使って、戦場から安全地域に戻る。あと、チームワークでパートナーと戦術を連携するなどみたいな感じで、グループウェアの中でもそういったシチュエーションがあります。

**キーボード、コンポジション、マルチユーザー、リアルタイムでドキュメントに入力する、尚且つスムーズ、これは思ったより複雑な作業です。**

ゲーム体感のコンセプトから始まり、「皆に楽しくメモする」がコアとしてプロダクトを開発、これは私たちのコアバリューです。

こちらの技術はまだ色々深堀できる面白い内容があります。また少しずつシェアしましょう。

### 参考文献
- [現代ブラウザのスペルMaxWu @ COSCUP 2017](https://hackmd.io/@MaxWu/HackMD-COSCUP2017#/)
- [Composition Eventsを通じて、非ラテン入力法の入力ボックスに対するサポートを強化](https://kuro.tw/posts/2016/10/11/%E7%AD%86%E8%A8%98-%E9%80%8F%E9%81%8E-Composition-Events-%E5%A2%9E%E5%BC%B7%E9%9D%9E%E6%8B%89%E4%B8%81%E8%AA%9E%E7%B3%BB%E8%BC%B8%E5%85%A5%E6%B3%95%E5%B0%8D%E8%BC%B8%E5%85%A5%E6%A1%86%E7%9A%84%E6%94%AF%E6%8F%B4/)
- [keydown, keypress, keyup の違い](https://github.com/jijigo/notes/issues/30)
- [keydown, keypress, keyup の違いを比較](https://medium.com/@yitailin/%E6%AF%94%E8%BC%83-keydown-keypress-keyup-%E7%9A%84%E5%B7%AE%E7%95%B0-4e873ba17e81)


技術：なぜ漢字をタイピングする際、漢字が割れますか？


# 製造業主管如何善用數位文件，讓第一線專注作戰

所有的公司，所有的行業，都需要文件。有些行業愛用紙本，有些全面數位化，也有一些夾雜在兩者之間的複雜排列組合之中，徒增同步對齊的「工人智慧」。

在台灣，基礎規模已經相當巨大、利潤營收也很穩定的傳統製造業，面對數位轉型的洪流及疫情衝擊，也需要趕上這一波智慧城市、智慧產業的趨勢，各產業紛紛購置更多、更新潮的軟體。

但，最根本的「轉型」關鍵，其實是在作業現場，工作人員的手裡，始終沒有被取代掉的那一張「紙」、那一隻「筆」，還有通訊軟體及版本爭議的無止盡衍生困擾。

HackMD 成功替台灣製造業工廠，打造了一套以管理者為本的「數位文件」模式。

## 問題：龐大的溝通成本，隱藏在工作流程之中

傳統製造業的工廠裡，頭戴安全帽的廠長、作業員與廠商代表，手拿著夾板，夾著好幾張待勾稽的文件。廠長從上衣口袋中，掏出原子筆，在生產線機台旁一一湊近，查看這次修繕的項目，是否都已經確實完成。你看完，我看完，拿筆，紙上打勾。

為了避免爭議，甲乙方相關人員都在現場，手機拍照記錄現場的狀況跟問題。實地保修計畫結束後，組內工作人員回到辦公室，才用文書軟體統整繕打。

影印出來，檢核確認；通訊軟體傳出去，檢核確認；管理系統提交，退回檢核確認。

**這樣來來回回的過程，從來沒有計算過，消耗了多少人、多少時間。**

除了人員的工作文化，紙本工具、老舊軟體的路徑依賴，導致隱形而龐大的「溝通成本」。

數位化洪流之中，想要「轉型」卻難以察覺內部工作流程上的致命弱點，就是「**文件**」。

## 解法：不是工人配合工具，是「數位文件，配合作業情境」

不久前，HackMD 與這位四十歲的李姓工廠廠長接洽，他提到，工廠每季需要例行的大型維修保養計劃，工期往往需要兩到三個月，也需要與外部的廠商合作。

過去，都是工期結束後，才由乙方提出工作報告，讓甲方進行驗收。然而，因為沒有「即時確認檢核項目」，過程中的溝通，雜亂的內容又散落在通訊軟體裡，無法統整。

結果，就是溝通上的爭議：小則來回幾次文字訊息、電話釐清、傳送照片附件處理，大則重要回現場再請人員檢查方能解決。若是衍生雙方之間的合作誤解與衝突，更是得不償失。

**紙本**，仍然是許多製造行業的習慣。面對數位接軌的需求時，為了「電子化」而將文件掃描成電子檔，只是多一道工，卻還是難以查找文件、再次取用文件內容，文件的資料價值也隨之封存。

**數位協作文件**，過去被認為是屬於資訊業、軟體工程人員的專屬，但在本土產業轉型、智慧化的趨勢當中，以本土筆記軟體起家的 HackMD ，以最輕便、簡單的線上文件形式，透過長期陪伴、與傳統製造業的廠內夥伴共學，打造了一種最有利於多方稽核單位的模式。

- 由負責管控保修程序的廠長，事先寫好一份 HackMD 數位文件；
- 同個網址，現場人員僅需一起打開手機，即時勾稽同步；
- 現場拍照，由廠長統一將照片，歸至文件當中，簡化協作步驟；
- 各方人員都可以隨時，在數位文件中追蹤即時更新的版本；
- 事後查找每個動作都可以被系統記錄、具有可課責性，查詢版本紀錄；
- 匯出成文字檔案，保存容易；架設廠內伺服器，完整保障隱私。

## 以管理者為本的「高主導、低協作」模式：數位文件，因地制宜

![](https://hackmd.io/_uploads/HJSswVpEt.png)

不需要所有同仁都「完整學會、應用所有功能」，反而是幫管理者設計一套操作流程，讓身為主管稽核的主事者，能夠在簡潔的頁面上，最快速將他的想法與意志，轉換到數位文件上。

**李姓廠長善用數位文件的彈性，為第一線的人員準備好文件，列出所有需要勾稽的項目，為第一線人員節約心神，專注在複雜的現場，仔細做好檢核工作。**

介面簡潔、載入快速，不需要複雜「協作共筆」，只需要拿起手機現場掃 QRcode ，點開預先建立好代辦項目的工單，所有人可以「同時」地看見哪些項目被勾選、更新；僅需要少數的甲乙方對口，在文件內以文字或照片的方式進行補充，所有人都能查找、同步溝通保修計畫的內容。

數位轉型（Digital Transformation），不是要求所有「人被轉型」，而是在技術數位化的基礎之上，讓所有工作人員，透過數位工具的因地制宜，將工作流程及工作方法「轉型」成一種真正能夠節省承辦成員、一線作業人員的壓力，並解決所有人一起長期埋下的溝通課題。



製造業主管如何善用數位文件，讓第一線專注作戰



# HackMD Prime 個人方案 詳細介紹


:::success
:tada: 免費試用升級版一個月「折扣碼」，即將於中秋連假（9/18）正式公開。
:::

>:point_left: 回到 [HackMD 中文官方部落格](https://blog.hackmd.io/zh) :point_right: [本文單篇連結](https://blog.hackmd.io/zh/blog/2021/9/15/Personal_Prime)
> :penguin: [English version: HackMD Prime Personal](https://hackmd.io/@hackmd/Prime_Personal_english)



<style>
.hmd-primer-logo {
    background-image: url(https://hackmd.io/_uploads/HkrpIo3MK.png);
    background-size: cover;
    width: 1em;
    height: 1em;
    min-height: 18px;
    display: inline-block;
}

</style>


![](https://hackmd.io/_uploads/rJENhWkmF.png)

## <span class="hmd-primer-logo"></span> HackMD Prime 個人方案，是什麼 :question:

為什麼 $A'$ 後面那個角分符號 "Prime" 看起來特別熟悉？因為演算法、數學式大量使用在 HackMD 核心技術之中。我們把更好的、上等的、加值過後的產品，取名為 <span class="hmd-primer-logo"></span> **HackMD Prime**。

HackMD 是一個台灣團隊，使用者眾多，也經常有人許願；我們將陸續實現。而你，成為 Primer ，為真正幫助到你思考學習的軟體，付費訂閱。

### :sunrise: 首波功能升級

2021 年 9 月，初登場的 Prime 個人方案，最優先新增的功能，就是解決最多使用者反映「圖片隱私」問題：以前，照片拉進筆記會上傳到免費空間 imgur ；現在，升級 Prime，將是你的私有雲端空間，每張圖片都受到保護。

### :sunrise_over_mountains: 未來陸續推出 

我們將筆記邀請者的數量、版本紀錄的數量、範本的數量，以及預設套用的功能，都保留給 Prime 的使用者；不久後，「回收桶、標籤樹、筆記 API」 也會陸續上線；明年，更力求實現「資料夾、全文檢索」等功能。

#### HackMD 陪伴你成長，希望你也陪伴 HackMD 升級，一起茁壯。


## 你可能會問，為什麼要升級 <span class="hmd-primer-logo"></span> Prime :question:

所有軟體服務都希望你訂閱，但哪些軟體，真正幫助你滿足實際的需求？根據我們的調查，HackMD 的使用者，有很高比例是每週超過三天的高頻率使用、甚至每天都會用。

專注於「輕量、彈性、快速」，點開 HackMD 的筆記，你不會有非得要達成完美的心理負擔；反之，是簡約的版面、即時的效能感。沒有花俏的模塊跟過量項目的干擾，最有利於「將散落的想法，快速地結晶化」。接著，成為一份可以累積、可以分享、可以協作的價值文件。

珍貴的討論協作情境，可遇不可求。因為是 HackMD ，點開同一個網址馬上同時打字也不干擾、不打斷、不蓋過任何的意見；尤其在 CJK（中、日、韓） 語言的組字輸入不打架。這樣的場景，或許不是天天發生，但這樣的內容，若能保存起來，更加珍貴稀有。

### 為真正幫助到你的軟體付費 :clinking_glasses: 

很多人都說「免費版就很好用了。」但是升級 Prime 之後，還會更好用，或許你也會發現有一些以前沒發現的用法。讓工具陪伴你，在進步的挑戰區，更往前推進一點。

升級 Prime 方案，是延續你良好的學習累積習慣；是與知識朋友交往，落實合作精神時更隱私、更彈性的辦法；也是在關鍵時刻，能最全力以赴將你努力的成果，付諸實現的路徑。

## 哪些人，最需要升級 <span class="hmd-primer-logo"></span> HackMD Prime :question:

你是[開發者](https://medium.com/starrocket/hackmd-product-story-1e332f83d343)，寫文件跟寫 code 的一致介面最親和，管理 repo 跟套用範本將省下更多力氣；

你是[筆記家](https://hackmd.io/@hackmd-marketing/primerusecase)，將獲得更完整的知識痕跡留存；`參考更多`:arrow_forward: [來自 Primer 的範本](https://hackmd.io/@hackmd-marketing/primerusecase)

你是[學術工作者](https://www.facebook.com/hackmdio/posts/4466103463446828)，程式碼、數學式支援與合作撰寫溝通，跨領域的合作愈來愈頻繁；

你是[接案工作者](https://www.facebook.com/hackmdio/posts/4448953288495179)，圖片隱私保障，最迅速的專案管理、溝通交付，也透過彈性權限來實現；

你是[團隊主持](https://www.facebook.com/hackmdio/posts/4460955603961614)，管理會議紀錄、行政文件，無上限的編輯人數跟版本紀錄，無後顧之憂；

你是[寫作者](https://www.facebook.com/hackmdio/posts/4458332684223906)，純文字專業者，值得專業編輯器，無限制版本紀錄，節省大腦空間。

## <span class="hmd-primer-logo"></span> 訂閱價格＆優惠期程

使用折扣碼，將享首月免費試用。訂閱期滿一個月，會自動扣費續訂，你也能繼續享有秋季的早鳥優惠價格：==每個月 US$4== （換算台幣約一份麥當勞套餐）。

冬季到來以前，我們會推出更有利於使用者的**年繳功能**。屆時，方案將恢復原價==每個月 US$6== ；若選擇年繳，則能繼續享有每個月 US$4 的優惠計價[^秋季早鳥優惠延續]。

[^秋季早鳥優惠延續]: 如果您在秋季早鳥期間訂閱 HackMD Prime，未來年繳方案上線後，您仍舊維持月繳 US$4。不過，如果您解除訂閱，重新訂閱時就會套用當時的計費方式。

別擔心，年繳功能上線前，我們會優先通知所有 Primer ，你不會錯過第一時間的年繳折扣。而且，只要在早鳥期間訂閱，你就會持續享有每個月 US$4 的優惠價，也將持續擁有未來上線的新功能。

# 優惠方案，中秋啟動

:::success
:tada: 免費試用升級版一個月「折扣碼」，即將於中秋連假（9/18）正式公開。
:::


<span class="hmd-primer-logo"></span> HackMD Prime 個人、團隊方案，即將啟動**最優惠**的「免費試用」及「早鳥優惠」。

我們會在電子報、社群媒體即時公告，請密切注意。
> :penguin: [English version: HackMD Prime Personal](https://hackmd.io/@hackmd/Prime_Personal_english)

>團隊方案，將同樣適用折扣碼優惠；
>已訂閱團隊方案者權益不受影響，並自動升級 Prime 版本。


>想了解更多，歡迎你跟我們互動 :point_right: 
>-  追蹤 [Facebook 粉絲專頁](https://www.facebook.com/hackmdio)
>-  Follow Our [Twitter](https://twitter.com/hackmdio)

>想要更深度的內容，歡迎你跳進來 :point_right: 
>- 訂閱 [Primer News電子報](https://airtable.com/shrcv8ye0qwrqe7YY)
>- 加入 [Facebook Primer 社團](https://www.facebook.com/groups/hackmd)

>:point_left: 回到 [HackMD 中文官方部落格](https://hackmd.io/@hackmd/blog-tw/https%3A%2F%2Fhackmd.io%2F%40hackmd%2Fblog-home) :point_right: [本文單篇連結](https://hackmd.io/@hackmd/Personal_Prime)


HackMD Prime 個人方案詳細介紹


# Try HackMD Prime Personal, first month is on us


:::success
:tada: Try HackMD Prime Personal with the promo code "PrimerONE" for 30 days.
:::

<style>
.hmd-primer-logo {
    background-image: url(https://hackmd.io/_uploads/HkrpIo3MK.png);
    background-size: cover;
    width: 1em;
    height: 1em;
    min-height: 18px;
    display: inline-block;
}

</style>


![](https://hackmd.io/_uploads/rJYvhby7F.png)

>[URL for this article](https://hackmd.io/@hackmd/Prime_Personal_english)

## <span class="hmd-primer-logo"></span> What is Prime Personal plan :question:

You are already familiar with the "prime" symbol ($'$) as in $A'$, because it's everywhere in algorithm and mathematics, on which are the bricks the core technologies of HackMD build.

<span class="hmd-primer-logo"></span> **HackMD Prime** is the first-class, value-added flavor of HackMD.


### :sunrise: What you get right now

Upgrade to Prime Personal to strengthen privacy to your data, for you will have dedicated cloud storage for uploaded images, whose permissions follows the containing notes.

There will be **unlimited** number of invitees, templates, and you can set default permissions to your note to save time.

### :sunrise_over_mountains: And more is coming

Note API for connecting your notes to other apps. Recycle bins where you can recover deleted notes. Folders for better arranging your notes.



## Why <span class="hmd-primer-logo"></span> Prime :question:

Every app craves your subscription, not all of them are essential to your productivity. HackMD is lightweight, flexible, and fast. No blocks. No modules. No databases. Just jot down your thoughts.

With collaboration and sharing in its DNA, HackMD boosts your productivity by decreasing the frictions for others to get their hands on. For freelancers whose works often involves contacts in other organziations, custom permalink, flexible permissions, full-fledged version control and quietly colored editing marks, all holds your work to be accessible and accountable.

HackMD comes with a Free version, which is free forever, yet Prime is for those who see the value in it and would like to use it without limitations.

Pay for what truly helps :clinking_glasses: 

## Does <span class="hmd-primer-logo"></span> HackMD Prime fit your use case :question:

**Are you a developer?** HackMD can simulate Emacs and vim, provides comprehensive keyboard shortcuts, code blocks with custom line numbers, GitHub integration, and much more.

**Are you promoting an idea?** HackMD is great for publishing your thoghts. Invite people to work together, to comment on your piece, and get notified for your publishings in one place.

**Are you an academic member?** Communicate with your colleagues or students with native languages of your discipline(s). LaTeX, mermaid.js, Graphviz, [slide mode](https://hackmd.io/c/tutorials/%2Fs%2Fhow-to-create-slide-deck), and much more.

**Are you an administrator?** Manage meeting minutes and all the admin documentations in one place. Onboarding is a lot easier with [Book Mode](https://hackmd.io/c/tutorials/%2Fs%2Fhow-to-create-book).

**Are you a writer?** Novels, poems, screenplays, translations, copys and everything in plain text are what HackMD is good at. A stable and fast editor, auto-save, traceable versions, plus excellent collaboration. 

## How much does <span class="hmd-primer-logo"></span> HackMD Prime cost?

Use promo code to get Prime, the first month is on us. You will be charged ==US$4== at the beginning of the next month.

Later this year, you will be able to pay anunally, then the monthly fee of Prime Personal will be US$6/paid monthly or US$4/paid annually. If you subscribe to HackMD before the annual plan, you can keep US$4 plan and save 33% every month ever after, until cancellation.


# Get the promo code this weekend! (updated)

:::success
:tada: Try HackMD Prime Personal with the promo code "PrimerONE" for 30 days.
:::

>Learn more :point_right: 
>-  Follow Our [Twitter](https://twitter.com/hackmdio)
>- Email us: support@hackmd.io

Try HackMD Prime Personal, first month is on us


# 人物：吳承翰，以及他的 HackMD Prime

疫情間難得到辦公室上班，離開前 Max（承翰的英文名）說他聞到佛手柑的香味，我心想怎麼可能，我用的是複方精油，而這間辦公室明明都是一些宅宅男性，竟有人聞得出其中有佛手柑。

今年收費方案要改版上線，社群經理覺得取一個通俗的名字比較好，煞有其事地搞了民主投票，最後還是被 Max 的「角分符號論」打動。好，就叫做 HackMD Prime。

聞得出佛手柑的工程師，瀏覽器預設卡娜赫拉的男人。我相信他。

>:point_left: 回到 [HackMD 中文官方部落格](https://hackmd.io/@hackmd/blog-tw/https%3A%2F%2Fhackmd.io%2F%40hackmd%2Fblog-home) :point_right: [本文單篇連結](https://hackmd.io/@hackmd/max_and_prime)

# 為什麼升級版，要叫 Prime？

![](https://hackmd.io/_uploads/B1HnEcdft.png)

前幾天，我在 HackMD 粉絲專頁發了一個輕鬆的貼文：Why ==Prime==？

這個問題，對使用者而言，或許一點也不重要，重要的是「升級付費之後，產品究竟能不能幫助我更多？」不過 HackMD 一向都是有點浪漫色彩的團隊，為了名稱，內部其實苦思頗久。

根據臉書民意，最多人覺得是「上等牛肉」，這是我們想具象傳遞的好料沒錯；其次多人選的是「以上皆是」這答案也不錯；就像學 Amazon 也是一種普及使用的檢驗指標。

但最接近正解的，是「猜 C 按加油：怕人家不知道這是數學的==角分符號==」。

有網友留言說「會先想到質數」，這也是數學，但我們不是為了賣弄數學，而是這段對話：

# 開發就是創作，行銷兼顧初衷

>[name= Max] Prime 在數學上，可以表達一個變數經過事件後的符號，就像 A 變成 $A'$

>[name=社群經理] ~~看不起文組膩？~~ 為什麼是數學？

>[name= Max] 我現在在編輯器裡打一個字，經過伺服器處理，傳送到你那邊，才看得到這個字[......]我們開發就是一直看到演算法，看到 Prime 就很有感覺。

>[name=社群經理]跟[中文裂掉](https://hackmd.io/@hackmd/CompositionEvent)那篇提到的有關嗎？

>[name= Max] 對，這是協作軟體的重要技術，從我這裡打字，到你那裡看見，要有一個「操作轉換」。

>[name=社群經理]有聽 Yukai 提過那叫 Operational Transformation。

>[name= Max]Prime 其實就是一個標記，同樣的符號，只是加上了角分。當然也可以兩撇，變成角秒，還可以三撇[......]不斷累加，對我們來說，就是表示變得更好。

![](https://hackmd.io/_uploads/BJ-kTidMK.png =600x)

HackMD，也是經過很多的事件，變得更好，加上標記，加值成為 HackMD Prime。幾經思索，我們不是唯一一個用這個單字來代表「加值」的產品服務，同時音節數已經很多，念起來順口。

我看著 Max 分享給我的畫面，是關鍵字 `Operational Transformation` 搜尋出來的技術論文。確實會一直看到像是 $X'$ 這樣的符號。我雖然不是開發者，也能從他興沖沖的描述裡，理解這對編輯器開發者而言，會是一個更有意義的名字。

# 募資成功，伴隨壓力與喜悅

HackMD 是 Max 北科大的期末作業，[Star Rocket 有做過專訪](https://medium.com/starrocket/hackmd-product-story-1e332f83d343)，這份作業，過了幾年之後，像魔法般地衍生，到了今天，已經變成一個完成天使輪募資的耀眼產品。

身為產品的最初開發者，面對招募來的社群經理、業務開發等新同事，有各種各樣的問題要問他，他偶爾會像是「解釋了一萬遍」的機器表情疲倦。

但每當聽到新的用法、新的詮釋，他又會嘩啦嘩啦開心分享起來。像是「你知道我因此學了好多語言學，還有排版學」，或是興高采烈說著意想不到的使用者，用來做好多他本來完全沒聽過的事。

聽他信手捻來的使用情境，像心智圖一樣從產品衍生出去每一個枝幹，我想，過去幾年他身兼技術的領導，又要帶領台北辦公室的大小事，應該總有許多力不從心的事。募資成功之後，要逐一來實踐了，這條路走起來確實不容易。難怪對 Prime 的描述「變數，經過事件」如此深刻。

>[name=社群經理]對了，您幾歲啊？

>[name=Max]我 1993 啊，所以比你晚一週打疫苗。

# Prime 有太多意思，其實是好事

起初，HackMD 團隊內在選擇改版後收費方案的名稱時，並不特別看好 Prime 這個選手。

![](https://hackmd.io/_uploads/BJCodhuzt.png =600x)

總覺得 Prime 有太多意思了，首先會有點餓，而且似乎用 Pro 或 Plus 才更接近我們的原意。各項名稱選手裡面，團隊成員在共筆裡補著各式各樣的意見，最後才進到決定的環節。

如同文章一開始所說，最後我覺得產品有產品的氣味，創作有創作的初衷，HackMD 有各種用法，所以也經常被詢問「產品調性」是否明確？我們有太多意思。但現在這會變成一個好事。

就像 Prime 有多種意思，下週即將上線的全新方案，是從來沒出現過的「**HackMD Prime 個人方案**」，同時也升級了「**HackMD Prime 團隊方案**」。

HackMD 定位在團隊生產力工具。我們是台灣本土團隊，卻有許多國外的組織、團隊採用，作為內部溝通、協作的平台，也有企業採用自架設的版本，用來銜接數位轉型的困難。

台灣在疫情之後，漸漸也要搭上這個趨勢，但我們仍要推出個人方案，因為有太多的使用者，已經創造出了專屬於他們的個人筆記用法，也期望更好的、加值的服務。個人、團隊、企業，**HackMD 有好多用法，好多意涵，不是內部工作團隊自己決定，也是使用者們跟著我們一起創造出來。** 

:::success
:tada: 免費試用升級版一個月，立刻使用折扣碼：[PrimerONE](lihi1.cc/J4tG4)
:::

Prime 還有一個意思，是「最初的」。許多個人筆記家，他們可能也會用更完整、繽紛的筆記軟體，但「想法最初發生紀錄之處」常是在最快速、便捷、文字為本的 HackMD。Prime 上線，請多指教。:rocket: 


人物：吳承翰，以及他的 HackMD Prime

# 文件：用註腳，俐落收納資料

註腳有種學究味。只有教科書、學術書籍才會在字裡行間穿插蠅頭小數字，一言不合就編到上百號，誰會看呢，我就聽過許多人抱怨書後的註腳內容、參考書目應該全部拿掉，賣便宜一點。

不過，實際撰寫文件，尤其需要做功課再下筆的文件，註腳其實挺好用的。譬如開發產品，常要設想使用情境，拍完腦門拍膝蓋，光憑自己設想還是有點乾，需要引用調查、論壇文章，甚至是論文。又好比一個功能可能有好幾種實現方式，各有優缺點，多半要參考許多討論才能定案，其間的折衷，有時也需要留下紀錄。

我們寫在文件裡的一句話，往往花了十倍時間和力氣調查、比較、分析。文件的讀者可能是主管、同事、外部合作單位或未來的新人，他們不見得下過相當的工夫了解文件的主題，因此，需要額外說明考慮的因素與經過。

傳達論點，同時也希望化解讀者可能有的疑問，所以需要附資料佐證。這時，註腳就是**簡明**和**翔實**的平衡點。

不過在 Markdown 文件裡，怎麼使用註腳呢？

>:point_left: 回到 [HackMD 中文官方部落格](https://blog.hackmd.io/zh) :point_right: [本文單篇連結](https://blog.hackmd.io/zh/blog/2021/10/12/footnote)

# 跟字面脱勾

本來 Markdown 沒有專屬於註腳的語法。HackMD 遵循的主要規範 [CommonMark](https://spec.commonmark.org/) 中，最接近的是「連結參照」。


「連結參照」包含連結標籤、網址、標題（可省）：

```md
[連結標籤]: hackmd.io "HackMD"

[連結標籤]
```

上面這段 Markdown 會被解析為以下的 HTML：

```htmlembedded=
<p><a href="hackmd.io" title="HackMD">連結標籤</a></p>


```
跟常用的超連結功能，也就是`[連結標籤](網址)`，效果是一樣的。

如果寫在 Markdown 文件中，算繪結果如下分隔線夾住的內容（請用 <i class="fa fa-columns"></i> [雙欄模式](https://hackmd.io/Ajzseh5wQbi1KwjqyIXewQ?both)參看 Markdown 的語法）：

---

這裡有一個[連結標籤]，不過連結的目的地其實寫在這個段落後面。

還隔了一個段落。請開 <i class="fa fa-columns"></i> [雙欄模式](https://hackmd.io/Ajzseh5wQbi1KwjqyIXewQ?both)看看呀  :point_up_2: 也可以按 `Ctrl` + `Alt` + `B`。按 `Ctrl` + `Alt` + `V` 可以切回檢視模式。

[連結標籤]: hackmd.io "HackMD"

---

可以發現，上面的寫法跟常用的超連結寫法 `[連結標籤](網址)` 會得到幾乎一致的結果，只是 `[連結標籤]` 可以放在文件的任何位置。

這個「連結參照」其實已經很接近我們從書本、論文接觸到的註腳。不過它有一個缺點：不管你把連結標籤取名為 `[大中天]` 還是 `[AZ]`，它一定會有「字面」，有字面就難以避免跟文件的正文混淆。

印刷文化裡的註腳之所以會演化成蠅頭小數字，固定長在字面的右上角（或用中括號括住），就是要讓註腳成為一種結構，好比樑、柱、牆之於建築，才不會跟正文混淆。

# Caret 不是胡蘿蔔

於是，在各式擴充的 Markdown 語法裡，出現了專屬註腳的語法。 :sparkles: 

HackMD 透過 [markdown-it](https://github.com/markdown-it/markdown-it) 的 [markdown-it-footnote](https://github.com/markdown-it/markdown-it-footnote) 支援註腳，而 markdown-it-footnote 則是根據 Pandoc 的[成例](https://pandoc.org/MANUAL.html#footnotes)。所以在 HackMD 當中，我們用以下的語法來寫註腳：

```md
[^註腳標籤]

[^註腳標籤]: 註腳內容

    如果註腳超過一個段落，第二個段落開始請記得縮排 4 個空白字元。
```

「^」：這個符號叫**脱字符**，不過大家比較熟悉的可能是 Y-hat $\hat{Y}$ 的「^」，英文叫 `caret`[^懺悔]。

[^懺悔]: 我每次都以為是胡蘿蔔。

實際應用的情況：

> 我知道有一項研究的主題是，圖書館裡哪種書最常被偷。[^Schwitzgebel][^label_caution]

你發現了嗎？在 HackMD 裡，註腳有兩大特性：

### 首先，你**不需**幫註腳編號。 :exclamation: 

在 Markdown 文件裡的註腳經過解析後，會自動依連結參照出現的順序編號，跟連結標籤的內容（`[也就是中括號裡的文字]`）無關。所以你可以隨時增刪註腳，不用擔心重新編號的問題。

### 其次，註腳的內容可以出現在文件的**任何**位置。 :exclamation: 

一個值得推薦的作法是：把註腳內容寫在註腳出現段落的下一個段落。這樣一來，即使直接閱讀 Markdown 檔案，仍舊很容易讀懂。


![](https://hackmd.io/_uploads/BkTBLZrbK.png =600x)

>你發現「我每次都以為是胡蘿蔔。」只有出現在本文最下方的註腳處了嗎 :eyes: 


# 善用註腳，精簡兼翔實，流通更容易

如果你曾經在 Word 或 Google Doc 裡用過註腳，就會知道**註腳**跟**正文**，屬於文檔的不同部分，而且樣式通常有別；意思是說，在不同軟體、甚至同一軟體的不同版本間，註腳的格式還有可能會跑掉，還要多換心思處理。 :sweat_drops: 

在 Markdown 的情況，因為是純文字的格式，註腳的內容跟正文寫在一起，直接讀沒問題，不必多費心思再去手調格式，文件仍然保持著良好的可攜性。

雖然**註腳**不在 CommonMark 規格中，但已獲得廣大支援（阿就真的好用咩），不擔心淪為語法孤兒，可以放心使用，享受「註腳自己會編號」跟「註腳內容放在正文段落裡也不會被發現」的快感。

下次提案，就利用註腳讓你的文件更精簡、更有說服力！


[^Schwitzgebel]: Schwitzgebel 2009; Schwitzgebel and Rust 2014.

[^label_caution]: 請留意，註腳標籤中間不能有空白。建議使用 `-` 或 `_` 代替，英文也可以用 CamelCase，來兼顧可讀性。

文件：用註腳，俐落收納資料


# 情境：用 HackMD 做「不斷更新」的懶人包


長期搬運敏感資訊進出中國的異議人士突然音訊全無，關心他的人用 HackMD 做了懶人包，此事登上了[《The Diplomat》](https://thediplomat.com/2021/07/ghost-in-the-machine-a-faceless-famous-chinese-blogger-goes-silent/)線上雜誌。

當一個爭議事件迅速發展，各方說法和內容都隨時在更新，不適合貿然製圖、簡化散佈，但，又需要一個平台整理這些內容，方便**不斷更新**，快速打字加段落來補充、修訂，容易畫重點加警語規則，快速排版放圖片，還能開放網友留言補充、更正——沒有比 HackMD 更適合的平台了。

不斷補充「文字、截圖」的事件連載敘述，讓「製作」本身「懶人化」，這是其中一種獨特的 HackMD 使用情境。


>:point_left: 回到 [HackMD 中文官方部落格](https://blog.hackmd.io/zh) :point_right: [本文單篇連結](https://blog.hackmd.io/zh/blog/2021/08/19/eventrecord)

# 哪一份懶人包，登上了國際雜誌？

今年六月，[《被捕、病逝、主动静默，编程随想停更事件长文分析 2021-06-21》](https://hackmd.io/@comemory/programthink-2021-06-21)一文直接以公開發布的形式吸引許多瀏覽次數，因此當時馬上就從 HackMD 的熱門文件裡面發掘到。

同時，這篇文章也在台灣的網站[方格子](https://vocus.cc/article/60d3dd21fd8978000105f34b)發佈，原因是這篇內容的性質屬於政治敏感，要多方的備份，以免資訊突然消失。

這裡，我們並不是要討論任何一份懶人包的實質內容及政治立場，而是，從網友選擇不同網站進行備份的使用方法，很容易**理解 HackMD 在使用上跟單純的部落格、文章發布網站有什麼樣的區別**：

>HackMD 版的事件分析，是不斷在更新內文內容，同時有許多留言不斷在幫忙加註、討論，正適合一篇文章在未定稿、不斷更新狀態下持續撰寫之用。

尤其當一個事件需要「備份」的時候， **「速度」** 是很重要的。

為了即時捕捉事件，我們可能用電腦的內建筆記本來做文字紀錄，或是用截圖來快速存證。這時候，如果有線上同步的軟體工具，可以同樣快速地把文字、截圖放在一起，甚至能簡易排版，就很符合 ==「快速交代一件事並傳播出去」== 這種需求了。

>HackMD 非常注重「編輯器」體驗，堅持在 Markdown 基礎上保留純文字的編輯格式，同時支援直接拉進圖片、嵌入各種格式的功能。

# 共筆體現了事件當下，網友們的合作

在這則事件的傳播上，HackMD 成為最廣泛使用的版本，或許也是因為網友在這份文件上的瀏覽次數即時顯示在介面上，留言、編輯與修改的痕跡也在文件呈現，體現「網友如何協力保留這個事件」。

不只是內容，也是分散式協作的體現，跟事件原初的性質似乎有所呼應，跟 HackMD 的產品初衷也不謀而合。這或許是為什麼《The Diplomat》選擇放上我們的連結。


# 這些功能，對「製作懶人包」特別實用

Markdown 語法有「純文字排版的魔法」之美名，一個井字號是大標，兩個井字號是次標，項目符號和縮排的符號又直觀，對於追求內容邏輯的一致、層次分明的人而言，本來就是相當低門檻的排版方法了。

而 HackMD 額外支援的幾項功能，在迅速大量資訊轟炸的狀況下，又特別適合輔助：
1. ==收合功能==：把暫時不需要全盤佔用版面的文字「收」起來
1. ==區塊上色==：適合標明文件的撰寫規則、免責聲明或重要提醒
1. ==自動目錄==：只要井字號標題層級訂好，可自動產生連結目錄
1. ==彈性權限==：事件發展階段可開放共筆，免費方案可指定三人協作
1. ==版本紀錄==：不斷更新，可能漏掉或要撈回舊內容，不怕手殘誤刪
1. ==雙欄檢視==：時間緊迫，即時渲染省下檢視的功伕，降低寫作門檻
1. ==自訂網址==：文件公開發佈時可以自訂 id 後的網址，方便搜尋
1. ==自訂縮圖==：在社群媒體分享時的標題、縮圖與敘述，更方便傳播
2. ==留言回應==：寫作多少會有疏漏，開放補充、腦力激盪或是善意提醒
3. ==愛心收藏==：擔心文章找不到，可以收藏，同時也給寫作者鼓勵

# 上述功能，你都會用了嗎？

懶人包必備的十項技能，你都知道怎麼使用嗎？這裡很簡短再提醒一下，同時附上相關的教學文件：
1. [收合功能](https://www.facebook.com/hackmdio/photos/4217593094964534)：單行最前面，打三個冒號，選 spoiler 區塊在檢視頁可以收合
1. [區塊上色](https://hackmd.io/s/features-tw#%E8%AD%A6%E5%91%8A%E5%8D%80%E5%A1%8A)：單行最前面，打三個冒號，選 info 等等的都是上色
1. [自動目錄](https://hackmd.io/s/features-tw#ToC)：半形方框框，裡面打上英文字 TOC ，像這樣`[TOC]`
1. [彈性權限](https://hackmd.io/s/how-to-set-permissions-tw)：右上角三角點的分享鈕，可以做編輯、留言的筆記權限設定
1. [版本紀錄](https://hackmd.io/s/how-to-save-tw)：右上角三點點的目錄鈕，第一項圓圈符號就是自動版本紀錄
1. [雙欄檢視](https://hackmd.io/s/quick-start-tw)：左上角三個正方形，是編輯（黑）、雙欄（黑白）、檢視（白）頁面
1. [自訂網址](https://hackmd.io/s/how-to-share-note-tw)：右上角三角點的分享鈕，最上方就可更改發佈網址
1. [自訂縮圖](https://hackmd.io/s/yaml-metadata-tw)：文件編輯頁最上方，三槓區塊內用 YAML metadata 快速制定 
2. [留言回應](https://hackmd.io/s/how-to-use-comments-tw)：檢視頁選取文字反白，就有留言功能，文件最上方有留言總覽
3. [愛心收藏](https://hackmd.io/@docs/like-bookmark-profile)：公開檢視頁最下方有個愛心，按下之後會留存在你的介紹頁

:crescent_moon: 以其中一個「版本紀錄」功能為例，如果很擔心短時間內的共筆協作，會有錯誤或違背了前一個書寫者的想法，可以在撰寫之後「命名版本」來回頭檢視，這樣就能無後顧之憂地「先寫再說！」

![](https://hackmd.io/_uploads/BywWPBsgF.gif)


# 定稿後，可攜性的部分

如果你需要切換不同的生產力工具、筆記軟體或各種網頁編輯器，用 HackMD 撰寫的優勢是  Markdown 語法的通用性，文章不必鎖死在這個平台，也不需要格式調整就能覆用。

:point_right: 點右上角三點點，選擇下載成 **.md** <i class="fa fa-file-text"></i> 的格式，就能匯到任何支援 Markdown 語法的地方。

同時，文件也可以匯出到 Google Drive、Dropbox、Gist 。除了網站的 HTML 檔，若有需要印製成紙本時（過了三十歲，眼睛要好好保養啊！），**用網頁列印選 PDF 格式**也是個容易的選項。

懶人包定稿之後，除了網址連結的傳遞，內容也有可攜性、變換格式容易，而不只是紀錄事件當下的便捷，使得 HackMD 意外成為眾多懶人包發佈的平台。

# 圖文「不斷更新」的應用啟發

不斷補充「文字、截圖」的事件連載敘述，不是 HackMD 獨有的內容，相反地，這種情境可能比我們想像更常出現。從前在 BBS 的文章就經常出現這種型態，到各種論壇、報導文章的網頁用括號來更新，通訊軟體裡的訊息用文字備註跟時間點來追蹤，種種情境都可以看到這種「不斷更新、連載」需求出現在各種突發、多方說法的事件之中。

HackMD 讓這件事變得更方便了，凡是 :bulb: **某些文章**有需要從前補充、往後增補內容，或是 :bulb: **某些報告或計畫書** 需要多人一起啟動協助，克服單打獨鬥的寫作門檻，因而保留一種回頭綜合整理跟對齊口吻和風格的文章；又或者是 :bulb: **某些動態場景的描述紀錄**，內容一直變，又需要多種格式的支援和自動整齊的版面——都可以嘗試轉換來用 HackMD 製作看看，製作效率、應用性會大增喔！

隨著使用者們的互相分享，多元應用的範本漸漸出現在大家面前。未來，我們的社群平台跟部落格，也會為大家整理這些使用情境。

# 還有哪些懶人包可以參考？

許多懶人包皆是以 HackMD 整理，或是以 HackMD 作為最初草稿撰寫協作發佈的地方，由於數量眾多，涉及的事件爭議也各種各樣，這裡就不列舉。建議有興趣的朋友，可以直接 Google 搜尋 `hackmd` & `懶人包` 這兩個關鍵字，或是`hackmd` 搭配事件名稱的關鍵字來找找囉 :eyes: 



情境：用 HackMD 做「不斷更新」的懶人包

# 文件：不怕找不到的 JD 整理術

認真作筆記一陣子，你發現筆記愈來愈多、用途不盡相同，找起來很吃力。

團隊順利完成各項專案，但營運過程接到、製作的各種檔案，**慢慢漫**出不同時期、情境下建立的目錄或標籤。每次花在找文件的時間都快要可以重新製作一份了。

找不到文件、文件找很久，這就是文件的「碎片化」。

打從人類開始製作、保存各式各樣的檔案，碎片化的夢魘就一直糾纏不去。所幸，人們也發明了各種整理檔案的規則，才有辦法管理像圖書館或行政機關等龐大的文件庫。

一個簡單的管理規則：「強尼十進位分類法」（[Johnny.Decimal](https://johnnydecimal.com/)，以下簡稱 JD），可以幫助你整理筆記和文件，克服碎片化的夢魘。

>:point_left: 回到 [HackMD 中文官方部落格](https://blog.hackmd.io/zh)

# 最多兩層！

殺雞焉用牛刀，一般人作筆記、團隊管理文件，用上分類人類知識的[杜威十進位分類法](https://en.wikipedia.org/wiki/Dewey_Decimal_Classification)未免太完備了。「==強尼十進位分類法==」（[Johnny.Decimal](https://johnnydecimal.com/)，以下簡稱 ==JD==），這是一個大幅簡化過後，適合個人和團隊的分類方法。

John Noble 先生提出的 JD 分類系統有兩層，也期待使用者**盡量**維持兩層：

- **領域（Area）**：用 `10`～`99` 的二位數字表示，上限十個，所以每個領域會佔用一個十位數。例如「財務」這個領域佔用 `10`～`19`。
	- **類別（Category）**：再細分領域，例如領域 `10-19 財務` 就可以再細分 `11 信用卡帳單`、`12 券商對帳單`、`13 貸款`、`14 税單`、`15 保單`，上限一樣是十個。

領域和類別組成一個二位數字，接著將相關的文件歸檔時，就可以給它們一個流水號，例如：

- `12.01 202106 ACME 券商對帳單`：第一碼 `1` 代表財務領域，第二碼 `2` 代表「券商對帳單」這個分類，`01` 是流水號（ID）。
- `14.28 2020 所得稅收執聯`

所以，我們可以將要操心的所有事情，分成至多十種領域，各類再細分至多十種類別，那麼 `12.01`、`14.28` 就代表一份獨一無二的文件——同時也緊扣著一大類我們關注、追蹤的事情。

在 JD 中，我們用 `AC.ID` 表記套用 JD 規則的一組代號。

# 這樣做有什麼好處？

別的不說，超好搜尋的啦！例如我在 HackMD 寫筆記，想起日前聽 podcast 聽到相關內容，但忘記是哪個節目、哪個單集，但我知道我的 podcast 筆記都歸檔在 `37` 底下。

那麼我按 `Ctrl` + `Shift` + `P` 叫出 HackMD 的 Spotlight，鍵入 `37`，馬上就篩選出有作筆記的節目。

![](https://hackmd.io/_uploads/HkuFQtPyY.png)

我還是想不起來到底在哪個節目聽到的，但沒關係，我是找不到資料的大人了，`Ctrl` + `Enter`（Windows/Linux）或 `CMD` + `Enter` （Mac），在新分頁開啟筆記吧。

如果你用這個方式命名資料夾，例如：

- `80-89 合約`
    - `80 經銷`
        - `80.01 老王_201607`
        - `80.02 小美_201608`
        - `80.03 老王_201607_附約`
        - `80.04 老王_2018`
    - `81 僱傭`
    - `82 委任`
    - `83 保險`

那麼今天要跟老王續約，想找之前的合約出來看，我們就知道去哪裡找。常用的分類很容易留下印象，所以實際上很有機會直接開啟 `80 經銷` 瀏覽，手甚至不必離開滑鼠。

協作的時候除了傳連結，也可以告知對方：「聖誕節那檔合作的特殊報價，去看 Dropbox 的 `80.03`。」就像去超商買菸的時候，可以告知店員「我要帆船號的茶菸，架上的 64 號。」

# 夠用嗎？

如果一個集合的元素**肯定會超過**十樣，它就**絕對不適合**放在兩層的領域或分類。

不過分店、客戶、經銷商、專案，這些都是預期會超過十樣的東西。該怎麼處理呢？

遇到這類情況，你有三種應對方式：

1. 建立**多個 JD 系統**：連鎖品牌的每家分店都可以有自己的 JD 系統，各自維護。
2. 換個**進位制**：例如 ID 換成十六進位或三十二進位。以十六進位為例，`52.79` 是 `52` 這個分類下的第 121 樣物件。這作法有點瘋，但如果你（和團隊成員）腦筋很靈活，也不失為一種配套。 `只是這就變成 Jonny.Hexadecimal 啦 XD`
3. 在 `AC.ID` 前面再加上三位數的 **「專案」編號**：例如 `102.72.21` 表示專案 102 的 `72.21`。

# 記不起來啦！

`AC.ID` 全部用完會有 100 個項目，別人我不知道，但我鐵定記不起來。定期維護一份索引，有需要的時候開出來查對，然後好好感謝那個高瞻遠矚的自己吧。

`00`～`09` 的領域、以及每個領域下的`00` 分類，可用來存放該領域或分類的詮釋資料（說明該領域或分類的用途等），就像圖書分類裡總論的意思。


此外，索引紀錄歸類資訊的**結構**，不是紀錄事物本身。如果把分類下的東西都放進索引，那就本末倒置了。



# 打破規則，不可恥且有用

John Noble 說明強尼十進位分類法時，提醒我們留意：

- 檔案要歸到一個完整的 Jonny.Decimal 數字對應的目錄下。
- 歸類任何事物的階層深度不超過兩層。

不過 John 自己還是會打破第二條規則——畢竟建立系統的初衷是容易收納、方便取用，不是要刁難自己。有些事務有時間的規律，例如一位接案工作者在 `41 請款憑證` 底下按每年週次建立目錄；有些事務會綁定某個地點，所以總公司的 `38 加盟合約` 下，再按照加盟店別建立目錄。

上述可能都是合理的考量，確實會加速歸檔和提取資料，足以支持我們打破規則。不過打破規則的代價，就是要記憶例外，例外一多起來，我們就無法信任這套分類法，導入它的效益就會遽降。

規則、例外可以靈活切換，重點是龐大的文件量，值得嘗試一種分類方式，擺脫碎片化的夢魘。

# 試試 JD 吧！

如果你還沒有採行某一套分類系統，也常苦惱找不到筆記、檔案等，甚至為此加班重做，那不妨馬上開新筆記，列出你操心、關注的事物，著手把它們分成**不超過**十個領域吧！

:::info
:bulb: 如果你使用 HackMD 來做這件事，一定會不斷用到這組交換上下行的快捷鍵：
- Windows/Linux：`Shift` + `Ctrl` + 方向鍵上下
- Mac：`Cmd` + `Ctrl` + 方向鍵上下
:::

文件：不怕找不到的 JD 整理術


# 技術：為什麼中文打字會裂掉？


中文打字的你，有沒有經歷過「中文裂掉」的窘境呢？例如說，當你想要打「筆記」兩個字的時候，卻變成「ㄅㄧˇㄐㄧˋ」這幾個注音符號赤裸裸地在網頁上，怎麼樣都組不成一個真正的中文字。

這個問題，來自編輯器有沒有好好處理「組字事件」。~~Facebook Messenger 可能就是沒有好好處理組字事件的軟體吧每次更新都超痛的。~~

這一篇，簡單帶大家認識「鍵盤事件」跟「組字事件」，以及這些事件與「協作軟體」的相關性。

這些認識，能夠幫助我們以後開啟 **HackMD 究竟蘊含了什麼樣的技術** 之大門。

:point_left: 回到 [HackMD 中文官方部落格](https://blog.hackmd.io/zh)

## 打字不就是按下去？認識鍵盤事件（Key Event）

![](https://hackmd.io/_uploads/Sy0tsKTa_.gif)


網頁瀏覽器裡面的文字，從鍵盤按下去的那一刻，會啟動一個「鍵盤事件」，這個看似簡單的動作，其實又分成三個操作：keypress, keydown, keyup. 

這邊先簡化一點講 **keydown** 跟 **keyup** ：==keydown==顧名思義是「按下去的那個瞬間」這件事，每一個按鍵都會有一個相對應的 keycode ，按鍵按下去就是取得了那個代碼；同樣顧名思義，==keyup==則是「放開手指頭的那個瞬間」所觸發的那件事。

舉例來說，當你打了「h」這個英文字，沒錯你在鍵盤看到它寫著「h」，在螢幕的網頁上也是「h」，事情相當單純。

```
keydown: h
keyup: h
```

但是，如果你用中文注音輸入法，想要打出「筆」這個字，而且不幸地，笨笨的注音輸入法，在拼字過程中出現了「比」，你還要按往下的箭頭，去選到候選清單上的另外一個「筆」，再多按幾下。

那麼事情會變成怎麼樣呢？

```
keydown: ㄅ
keyup: ㄅ
keydown: ㄧ
keyup: ㄧ
keydown: ˇ
keyup: ˇ
keydown: ArrowDown
keyup: ArrowDown
keydown: ArrowDown
keyup: ArrowDown
keydown: ArrowDown
keyup: ArrowDown
keydown: Enter
keyup: Enter
keydown: Enter
keyup: Enter
```

看到這邊，就可以理解英文字跟中文字，在網頁輸入時候的差別了。

### keydown 跟 keyup 有不一樣嗎？

接著你可能會想，上面的 down 跟 up 冒號後面的內容，不是看起來都一樣嗎？

剛剛說 down 是「按下去的那個瞬間」這件事，但如果你不只按一瞬間，而是**長按**，那麼可以「連續觸發」；相反地，因為 up 的抬起手指頭一定是一瞬間的事，所以沒有辦法連續觸發。

用「筆」來舉例，如果說你家的貓 :cat2: 踩到鍵盤，在你按完「ㄅㄧ」之後幫你按了那個三聲「ˇ」好幾秒，鍵盤事件會長什麼樣子呢？

```
keydown: ㄅ
keyup: ㄅ
keydown: ㄧ
keyup: ㄧ
keydown: ˇ
keydown: ˇ
keydown: ˇ
keydown: ˇ
keydown: ˇ
keydown: ˇ
keyup: ˇ
```

你會發現有 6 個 keydown，但只有一個 keyup。這樣一來，兩者的關係應該就清楚了。用鍵盤玩過電腦遊戲的人，相信此時也有點心領神會了。~~射擊的時候，按下去可以連續觸發，不過如果是那種瞄準了放開按鍵才丟出去的炸彈，那只能丟一次，所以開槍跟丟炸彈分別就是以 keydown 跟 keyup 兩種時刻觸發的吧我想。~~（還是比較像「上膛」&「擊發」呢？）

### 那麼 keypress 是什麼？

再回來介紹， ==keypress== 又是什麼？顧名思義，那是一種「按壓」。欸那跟 keydown 不是一樣嗎？不，這的動作，在「文字按鍵」跟「非文字按鍵」之間會有差別。

例如說，你按「h」會出現的是一個英文字「h」，不過你按「enter」並不是「出現一個字」這件事，而只有會執行這個對應的 keycode。

**keypress 只會出現在「產生文字的按鍵」**，像是「Esc」、「Enter」這些按鍵是沒有觸發的。

例如「英文字的大小寫」這件事，雖然都是按鍵同一個「h/H」，正因為多了 keypress 這個按壓的操作，而能區辨要去拿不同的 keycode 。而這，就是無法透過 down 跟 up 這兩個瞬間就判斷的事情。


## 所以為什麼中文打字會裂掉？認識組字事件（Composition Event）

介紹了 keydown, keypress, keyup 給大家認識，其實是為了凸顯另外一件事的重要性。

剛才說 keypress 是「產生文字的按鍵」才會發生，中文輸入的你，可能會想到下一個問題：

>注音算是「有產生文字」嗎？

注音會有 keypress 的操作嗎？多數時候，答案是沒有。 :no_entry_sign: 

剛剛中文的「筆」在輸入時，鍵盤事件裡拆解出了 keydown 跟 keyup 的每一個動作，不管 down 或 up ，其實都還只出現個別的注音符號和聲調，都==還沒有出現真正的中文字==，對吧？

```
keydown: ㄅ
keyup: ㄅ
keydown: ㄧ
keyup: ㄧ
keydown: ˇ
keyup: ˇ
keydown: ArrowDown
keyup: ArrowDown
keydown: ArrowDown
keyup: ArrowDown
keydown: ArrowDown
keyup: ArrowDown
keydown: Enter
keyup: Enter
keydown: Enter
keyup: Enter
```

:eight_spoked_asterisk: 重點來了：如果要在編輯器裡面使用 CJK （中、日、韓文），像是中文輸入，我們需要的是就不只有鍵盤事件（Key Event），還需要**組字事件（Composition Event）**。

以剛剛我們用注音輸入法打的「筆」為例：

「ㄅㄧˇ」之後還要從候選字庫裡選出對的選項，組字事件是長這樣的：

```
Composition Events:
compositionstart:
compositionupdate: ㄅ
compositionupdate: ㄅㄧ
compositionupdate: 筆
compositionupdate: 筆
compositionupdate: 筆
compositionupdate: 筆
compositionupdate: 筆
compositionupdate: 筆
compositionend: 筆
compositionstart: 筆
compositionupdate: ㄅ
compositionupdate: ㄅㄧ
compositionupdate: 比
compositionupdate: 比
compositionupdate: 🆚
compositionupdate: 筆
compositionupdate: 筆
compositionupdate: 筆
compositionend: 筆
```

看到組字事件的過程，是不是彷彿就看見從 Key event 的「ArrowDown、ArrowDown、Enter」同時地轉換成 Composition Event 的「比、🆚、筆」呢？

這就是組字事件，有別於鍵盤事件。唯有出現在「需要組字的語言」情境。

>註：每個瀏覽器的桌面、手機行為不同，也有可能有不同結果。可以用[我們的開發者 Max 寫的 codepen](https://codepen.io/jackycute/pen/EvNmWv) 來測試看看。

## 有沒有處理「組字」，會差很多

為什麼有些軟體服務很好用，但改版時，中文輸入就是有那麼一點卡卡的？經常「裂掉」而無法順利的組字呢？~~像是經常改版更新的 Facebook Messenger（到底多創傷要一直提）。~~

其實，就是在接收各種文字輸入者的「組字」過程時，沒有考慮到「組的過程出現的『字』」這個元素，要如何在編輯器裡面處理。很可能，因為也是在軟體更新時，忘記測試到這些語言啦！

>在撰寫這篇部落格的同時，也發現到我們的成員 [Yukai](https://hackmd.io/@Yukai) 曾經對 VSCode 發過一個組字事件的 PR: [Fix backspace in IME composition on iOS Safari](https://github.com/microsoft/vscode/pull/40546)。

## 何況還要「協作」！

如果一個編輯器，沒有想過它要接收的語言輸入裡面，會遇到「需要組字的語言輸入內容」，在 keypress 這端就漏掉了「組字過程中會產生的『準文字』」。

當然，換個角度想，如果沒有這些組字語言的使用者，這樣的需求與問題，也就不存在。

更重要的是，如果一個「協作」編輯器，沒想到要處理的不只是鍵盤事件，也還要處理組字事件，那麼在即時協作（Realtime Collaboration）這件事情上，恐怕就會遇到很多難關了。

每個軟體的產品定位不同，像是 Notion 就對於同一區塊的協作處理著墨較少。多人、同時編輯時，不容易找到對方在哪裡（沒有顯示游標），同時編輯一個區塊，甚至會出現某一方被蓋掉。

>測驗「協作」最嚴峻的考驗，就是找人一起，在編輯器同一行，打字，看看會發生什麼事。

介紹鍵盤事件、組字事件，是因為未來在談論「協作」這個技術時，能夠幫助認識解法的各種可能。

## 怎麼看得出來，編輯器有處理「組字過程」？

文章開頭，提到了「中文打字裂掉」的情境，這是許多人在使用如 Google Doc、Dropbox Paper **同時打字**經驗時曾經遇過的狀況。

干擾組字事件的可能因素有很多，端視軟體的演算法，想要優先帶給使用者什麼樣的體驗。

HackMD 在 keypress 這端，將「組字過程」（以注音輸入法來說，就是注音符號拼起來選取中文）也當成一個事件傳送出去。所以你跟夥伴在協作的時候，是可以看對方的「組字過程」的唷！

有時開會，共筆編輯時，也難免有點赤裸感，按鍵輸入過程都即時呈現出來了。~~說不定可以衍生用法藉此來迂迴委婉表達一種想說又不敢說得太明白的感覺呢。~~


## 測試看看你有在用的軟體，有沒有把組字事件傳送出去？

不同的編輯器和筆記軟體，有不同作法，你可以回想看看——

>你曾經看過「組字過程」出現在共筆文件上面嗎？

假設你的共筆對象，要打出「筆記軟體」這四個字——

- 你曾經在文件上，看到 ==「ㄅㄧˇ 筆 ㄐㄧˋ記」== 的這個過程嗎？

還是說，你會直接看到對方打出了「筆」——

- 然後隔了零點幾秒，游標顏色、底線閃爍，再看見對方打出了「記」、「軟」、「體」？

還是說，是等了多秒之後，對方已經打完好一陣子了，

- 你才看見「筆記軟體」這四個字？

各種做法有其優劣。以追求寫作流暢度、文字快速產出為優先的 HackMD 而言，將組字過程納入協作的一環是必要的，同時也會帶來較大的伺服器負擔。這就要回到產品的核心價值了。

## 還以為是筆記軟體，原來是線上遊戲

HackMD 的開發者 Max 曾經說過一句話：「這就像**大型多人線上即時遊戲**！」

單一個人輸入者，在編輯器上打字時，文字輸入即顯示的快慢，已經是一個重要的體驗了。

何況是兩個人以上，三個人、三十個人，同個時間在同一個編輯器上瀏覽、編輯時，就像多人即時的線上遊戲。有些玩家給出了一個動作，另外一個玩家反映了另外一個回饋，遊戲內的角色又要怎麼去處理多重拋接球及在互動過程的衝突干擾，而能順利闖關。

嵌入一個什麼，就像突然飛來一隻巨獸；玩家逃跑的時候需要一個傳送門，從戰場快速回到安全的堡壘；對了，還要跟隊友溝通聯繫戰術等等的事情。這種腳本，也通用在協作軟體的使用情境裡。

**鍵盤、組字；多使用者；即時輸入到文件裡——而能夠流暢——可能是個比你想像更複雜的事。**

從遊戲體驗的共鳴出發，以「讓大家快樂做筆記」為核心去開發產品，是我們的核心價值。

這些技術，還有許多可以深挖的有趣內容，就留待未來，慢慢分享了。

###

#### 參考資料
- [現代瀏覽器的拼字處理 Max Wu @ COSCUP 2017](https://hackmd.io/@MaxWu/HackMD-COSCUP2017#/)
- [透過 Composition Events 增強非拉丁語系輸入法對輸入框的支援](https://kuro.tw/posts/2016/10/11/%E7%AD%86%E8%A8%98-%E9%80%8F%E9%81%8E-Composition-Events-%E5%A2%9E%E5%BC%B7%E9%9D%9E%E6%8B%89%E4%B8%81%E8%AA%9E%E7%B3%BB%E8%BC%B8%E5%85%A5%E6%B3%95%E5%B0%8D%E8%BC%B8%E5%85%A5%E6%A1%86%E7%9A%84%E6%94%AF%E6%8F%B4/)
- [keydown, keypress, keyup 的差異](https://github.com/jijigo/notes/issues/30)
- [比較 keydown, keypress, keyup 的差異](https://medium.com/@yitailin/%E6%AF%94%E8%BC%83-keydown-keypress-keyup-%E7%9A%84%E5%B7%AE%E7%95%B0-4e873ba17e81)



技術：為什麼中文打字會裂掉？


# 文件：非同步工作的成功關鍵


受疫情影響，許多人體驗了一段在家工作的日子。縱然在家工作，大多數公司是把同在一處的工作方式移到線上，上、下班換成在通訊軟體上打卡，上班時間要求員工開語音、開視訊，本來有開的會議一個都沒少，甚至因為不習慣開線上會議，時間反而拖長。

換成遠端工作，如果能搭配==非同步==的工作方式，更能彰顯遠端的優勢。

## 什麼是「非同步」？

非同步，意思是團隊成員的工作時間不必一致。你工作的時候，我可能在陪孩子。我工作的時候，你可能在做家事。我們都呼呼大睡的時候，地球另一端的成員亮起了上線的燈號。 :crescent_moon: 

「不必一致？那開會怎麼辦！」非同步工作的團隊，成員往往散布在不同時區；但就算共處在同樣時區，成員之間仍然可以尊重彼此的作息，採取非同步工作的模式。

跟同在一處的團隊相比，非同步工作的團隊更難約時間、開會的成本更高。表面上的劣勢，卻未必不能轉換成優勢。

非同步的團隊仰賴各式文件來溝通，雖然需要較長的準備時間（打字畢竟比說話慢），換來的好處是充分的思考（可能會發現同事變更成熟了）。

此外，成員要貢獻想法，文件打開隨時補充；搭配版本控制，決策過程更容易稽查。 

## 不是每個人都習慣「文字」溝通，怎麼辦？

覺得文字太冰冷，線上白板和短影片都能輔助溝通，有些公司甚至有內部的 podcast。聲音和影像都可以重新鑲嵌在文件裡（至少 HackMD 沒問題）。

知名的架站工具 WordPress，其出品公司 Automattic 內部就[使用](https://wordpress.com/p2/) WordPress 架設的部落格溝通。

## HackMD 內部又是如何「非同步工作」呢？

HackMD 團隊的成員目前分布在兩個時區，內部當然也大量仰賴文件來溝通——當然，**我們的文件都使用 [HackMD](https://hackmd.io) 來管理。** 

最近我們要為付費方案取名，過程是這樣的：首先當然先開一份文件，列上標題，敘明這是一篇為付費方案取名的投票箱。 :ballot_box_with_ballot: 

行銷團隊先考察、整理了一些方案，再讓其他成員提案，接著投票，重要的是附上理由。非同步的狀況下，只要訂下一個截止時間，成員都可以在時段內思考、修改跟定稿他的選擇。

藉著顏色區分，不同人的意見在 HackMD 的編輯器裡一目了然；雖然不在同一間會議室腦力激盪，彼此的想法仍然在各自的腦海裡迴響，激發新的創意，隨時更新，直到新意收斂，再作統整。

>所以收費方案到底叫什麼名字？還請期待～

## 小孩子才做選擇：同步、非同步的排列組合

同步或非同步工作各有利弊，視公司的規模、業務性質等兼採所長，會是務實又聰明的作法。 

目前常見的安排，是以同處、同步工作為主，提供遠端工作的彈性；在同步工作的情境裡，納入非同步工作的前提。

組織性質與工作流程的排列，掌握到最舒適與效率的組合。這樣去重新檢視文件工具的使用，或許會有不一樣的啟發。

本文連結：https://blog.hackmd.io/zh/blog/2021/07/24/async-work


文件：非同步工作的成功關鍵


# 人物：初登板的新夥伴


2021年，HackMD 有一個重大的變革，就是首度公開對外招募夥伴了。

今年年中，新夥伴一個一個陸續加入，HackMD 正在忙著，長成稍稍不一樣的樣子。

## 新夥伴是誰，怎麼會加入 HackMD 呢？

2018年6月29日，HackMD 的宗鎧，寄出了一封名為「使用者訪談 - 文播手」的信。

> HackMD 的使命是：促進知識分享。文播對我們來說是一個好像可以發揮我們的價值，但是我們並不瞭解的使用情境，還希望能多多請教！

顧名思義，「文字轉播」是透過文字來進行一場會議、活動，或是任何一個討論脈絡的詳細記錄。比起逐字稿那種全面性的文字輸出，經由人類聽打、消化而書寫的文件，更有可讀性。

> 只需要對議題有初步了解，剩下就是勞力密集的「聽打」。但這項簡單的「聽打」卻奠定出一種文本傳播基礎，改寫公民社會運作。——[端傳媒：「打字，轉動公民社會」](https://theinitium.com/article/20160602-opinion-enenhsu-g0v/)

除了自己振筆疾書，在像是 g0v 等知識交流的研討會上，眾人一起共筆，協作文件裡面大家運用文字來捕捉內容、留下紀錄、互相溝通。這是文字愛好者的解放，不用拘泥於完整的文章書寫。

但是，文播手如果只是一個人，肉體極限上不可能撐太久，需要協作夥伴。跟許多使用者一樣，文播手也經歷了這個平台轉移路徑：**Hackpad ➡️（dropbox paper, google doc）➡️ HackMD**

對於打字速度飛快、需要持續性 typing 的文播手來說，中文輸入的協作不干擾，沒有比 HackMD 更出色的產品了。從 2018 年，文播手比任何人都更清楚，順暢的共筆協作，是一件多麼珍貴的事。

> HackMD 開始招募新成員 與我們一同創造未來吧！—— [HackMD 粉絲專頁](https://www.facebook.com/hackmdio)

2021 年，懷著對這個產品的好印象，這名文播手加入了 HackMD。（他只是其中一個，新夥伴。）

上工的第一個月之後，曾經的文播手，開始撰寫這篇部落格文章「HackMD 最近在忙什麼？2.0」。


## 新夥伴的第一個月，都在忙些什麼呢？

從 ~~大寶山、筆記家、玩樂團~~ 發臉書、做訪談、說故事，開始說起。

### 1. 發臉書：發現 HackMD 是座大寶山 :mount_fuji: 
新夥伴，並不是工程師，當他加入 HackMD 這個團隊之後，發現團隊夥伴跟他們的朋友，使用這個產品的方式，有點不太一樣。

他以前只知道打字體驗很舒服，共筆做會議紀錄很流暢，做草稿的發佈區很方便，Markdown的排版容易上手。他曾經在編輯文章時，被路人問說「你是工程師嗎？」😹 `我是麻瓜RRR`

因為黑底跟編輯器左邊「第幾行」的這種介面，實在太像在寫 code 了。當然他一直知道 HackMD 的編輯器似乎對於保存程式碼很友善，不過他都把這功能當作小字註解在用。 `就像這樣偷murmur`

> 原來，不同身份的人，會有完全不一樣的使用情境。

新夥伴在跟同事的聊天中，才發現原來 HackMD 有這麼多隱藏功能。說是隱藏，其實可能只是不好找，又或者對某些使用身份的人來說，他們還不知道怎麼善用這些功能。

新夥伴的第一任務，或許也是最容易上手的任務，是要在臉書粉專上發文。

於是一系列的發文以「你知道嗎？」為題，這個問題意識，所體現的就是一個特定身份的使用者，因為只看到 HackMD 的一個斷面，所以沒挖掘到的有趣功能。

> 另一名新夥伴，是這麼說的：HackMD 是一座大寶山 :snow_capped_mountain: 

在臉書發出一系列的功能教學文之後，他發現好多使用者，也不知道 HackMD 有這麼多炫砲的功能。或許在許多面向上，因為團隊過去的人手不足，而未能擴張去做的事情，現在都該來做了。


### 2. 做訪談：發現有孤獨筆記家，也有分享知識家 :man_and_woman_holding_hands: 

發現使用情境的不同，於是新夥伴開始做訪談。有很多身邊的朋友，屬於對知識有熱忱，需要快速簡潔的編輯器來充實自我。他們的筆記很豐富、很美，但多是自己默默整理。

曾經，在 FB 粉專上做了調查，發現會主動來填寫問卷的粉絲們，多是屬於這種「孤獨的筆記家」。孤獨的筆記家，並不是真的孤獨，而是能夠在撰寫筆記的過程中，品味一個人寫作的美好。

還有許多的筆記家，同時也是「分享知識家」。公開發表的筆記、邀請協作的筆記開出來，不特定的人們打下字，獲得的不是利益上的回報，而是知識觀點交流，更像是傳統上的「筆友」？:pencil:

原來， HackMD 後來才開發的留言功能，更多元的編輯多能，在拓展人們交流互動上扮演了這個角色。難怪，接近下半年，眾多研討會的共筆文件，都是採用以 HackMD 建置的書本模式。

除了筆記家之外，以「團隊」為單位的使用群體，他們往往需要快速把珍貴的討論紀錄下來，有時候不同的夥伴要肩負紀錄的任務，同時有好多人打字、補充，協作的流暢度成為團隊的首選。 :1234: 

> 團隊為了把筆記權限、圖片隱私的控管做好，可能會付費購買「私有團隊」方案，以外國人，尤其美國和日本特別多。或許是為軟體付費的習慣，或是工作文化差異，這部分還不清楚。

為企業所打造的客製化版本，又是另一個世界。當新夥伴接觸了企業客戶，發現原來大組織內部，各個部門在使用不同工具時，能夠在各種狀況下使用 HackMD，又增進了好大一塊理解。:office: 

> 個人、團隊、企業所需要的並不盡然相同。甚至企業內的需求，也很不一樣。

邊做訪談，邊探索著大寶山的內容，圖像越來越完整了。總之，無論是默默寫著筆記，在適當的時刻分享給其他人；團隊內以累積、任務取向，更追求效率及產出的組織社群；企業跨部門的文件溝通，多種工具結合成工作流程——

當共享、共筆、共創的價值出現，新夥伴就覺得，來到這個地方工作真是一件好事。

### 3. 說故事：怎麼想都覺得比較像是玩樂團 :guitar: 

新夥伴第一次加入新創公司，讀過 HackMD 最早期成員的故事。其實好幾個成員，年紀都還比新夥伴小一點點，這種青春熱血的味道，很像是獨立樂團的故事。

玩樂團，往往來自學生時期的熱音社之類，出於對音樂純粹的愛好，或是社團教學什麼的契機，漸漸對創作有熱忱，甚至發過在地下圈子迴響不錯的 demo ，畢業後，很多團員只能撥有限時間練團。

在聽團仔的圈子裡，這個樂團已經小有名氣，粉絲引以為傲。甚至也有幾次大型亮相的機會，資源的連結，受到鼓舞。團員們必須下定決心，是不是要走音樂這條路，去搞一張完整的專輯看看。 :cd: 

發行專輯之後，就會遇到許多真正在產業裡的挑戰，原來跟市場打交道，是一個漫漫學習的長路，有陸續加入的夥伴，專輯的風格與早期的 demo 或許調性也有點不同了，許多的取捨。

> 新夥伴有時候會被別人問：你為什麼會到這家公司來？你們在賣什麼？你們公司怎麼樣呢？

新創團隊的語言，多少學會了一些，不過在新夥伴的心中，其實 HackMD 就是一個還在發展與摸索的獨立樂團。作品無疑是受到多方肯定的，才會一步步走往專業。 :film_projector: 

不過，要讓樂團生存下來，不能只有埋頭苦幹做專輯，這一點大家都很清楚，真正要謀取平衡的時候，就會有好多實作的難題，那又有好多的故事。

新夥伴，像這個樂團的經紀人，有時也參與專輯製作的一隅。說故事的同時，也成為故事中的角色。


## 邁向 2021 的下半年，HackMD究竟在忙什麼？

新夥伴的第一個月，發現處處有想要動手實作的坑，似乎會繼續有機生長下去，像新芽長出來一樣，冒出了頭，還有許多探索的方向。

在暈頭轉向的多任務，以及探索的新鮮感之中，不時回到心中的叩問「我們的產品是什麼:question:」

這個問題，團隊內當然早就有一些答案，但如果不是新夥伴自己找出來的，似乎就不是那麼踏實。

網路上搜尋，會有一篇最動人的解答，那就是 「[為工程師文件而生的協作平台](https://medium.com/starrocket/hackmd-product-story-1e332f83d343)」，讓開發者社群能夠更加喜愛、善用且重視文件，讓文件變成一個轉換價值的重要橋樑。

對新夥伴來說，同時也是「為文字工作者而生的協作平台」，因為所謂的文字工作者，早就不只是作者、記者、紀錄者，更是所有透過文字來創造價值的人。

或者，好像還可以追加「我們的產品『還能』是什麼:question:」這樣的問題。

當然，很多時候，也有「我們還『無法』、『來不及』、『不適合』做什麼:question:」這樣的問題。

所以，**「究竟在忙什麼？」** 這個問題，可以很簡單，也可以很複雜。

對這個，似乎總是做得太多、說得太少的團隊而言——用更多管道，更豐富的語言，去回答這個問題，說給更多的人聽，就是新夥伴的任務。



人物：初登板的新夥伴


# HackMD 最近在忙什麼？

本篇文章的標題原本是叫做「HackMD 2019 年度回顧」的，不過由於筆者拖了又拖，從聖誕節拖到農曆新年，再從新年拖到了 228。2020 都已經要過完第一季了還在開天窗，只好忍痛改了標題 😂

在過去的幾個月，HackMD 團隊不斷努力為大家帶來更好的協作體驗。忙了這麼久，也該說說自己做了什麼吧！這次的文章將會總結最近一年 HackMD 在產品各個面向帶來的改進，錯過我們臉書貼文更新、或是很久沒關注 HackMD 消息的朋友，也可以藉此複習一下。

就讓我們開始吧！

## 利用範本快速建立新筆記

在[四月時][fb-template] HackMD 上線了「[範本][tutorial-template]」功能。利用範本，你可以快速的以預設內容來建立新筆記，不用每次開新筆記時，都得重複複製貼上。我們也提供了幾種不同的預設範本，像是會議記錄、簡報、README範例 等，讓對文件比較陌生朋友能夠快速上手 :handshake: 

![](https://i.imgur.com/u8scNrU.gif =500x)**使用範本建立筆記**

[fb-template]: https://www.facebook.com/hackmdio/posts/2270037116386818
[tutorial-template]: https://hackmd.io/c/tutorials-tw/%2Fs%2Fhow-to-use-template-tw


## 內容時光機 - 版本功能再度進化

HackMD 甫一上線就支援版本功能，隨著時間過去，我們也不斷地強化版本功能。在[七月時][fb-revision] 我們推出「[命名版本][tutorial-revision]」功能更新，以往的 HackMD 會每隔十分鐘定時建立版本記錄，如果使用命名版本，你就可以在任何時候建立新的版本，還可以留下版本名稱和敘述，讓這個版本有意義。

除了新增版本，你也可以[比較任意兩個版本的內容差異][tutorial-diff]。用更 geeky 的字來說，就是 `git diff` 啦！

![](https://i.imgur.com/orBlzdj.gif =500x)**新增命名版本**

![](https://i.imgur.com/nP1NscE.gif =500x)**比較版本內容差異**

[tutorial-revision]: https://hackmd.io/c/tutorials-tw/%2Fs%2Fhow-to-save-tw
[tutorial-diff]: https://hackmd.io/c/tutorials-tw/%2Fs%2Fhow-to-save-tw#%E6%AF%94%E8%BC%83%E7%89%88%E6%9C%AC
[fb-revision]: https://www.facebook.com/hackmdio/posts/2412143235509538

## Markdown 表格編輯新體驗

對新手來說，Markdown 的表格一直是個難以上手的存在：需要特別記憶的符號、難以輕鬆的排版。筆者在過去也時常運用 [Markdown Tables generator](https://www.tablesgenerator.com/markdown_tables) 這類的網站，來幫忙快速生成 Markdown 表格語法。

![](https://i.imgur.com/795YQ3f.png =300x)**[ネタ](https://zh.moegirl.org/zh-tw/%E6%AC%A7%E5%B0%94%E9%BA%A6%E7%89%B9)**

不過看筆者這樣敘述就應該能猜到，在 HackMD 上建立表格已經不再是個痛了！HackMD 在十一月時推出了 [表格編輯][fb-table] 功能，除了有工具列的按鈕可以輕鬆調整表格欄列，還有給高效使用者專用的[表格快速鍵][tutorial-table]：

![](https://i.imgur.com/4eWcmDr.gif =500x)**利用快速鍵建立表格**

[fb-table]: https://www.facebook.com/hackmdio/posts/2699478126776046
[tutorial-table]: https://hackmd.io/c/tutorials-tw/%2Fs%2Fhow-to-create-table-tw

## 全新的首頁，全新的設計

儘管沒有大張旗鼓，你可能悄悄發現 HackMD 的首頁長得和之前不太一樣，這些改變都是為了讓初次遇到 HackMD 的新朋友能更快瞭解我們。

此外我們也大幅更新了 HackMD 網站各個頁面的設計，改善了易用性以及頁面切換速度。

![](https://i.imgur.com/iAxGCoj.png =500x)**HackMD 的新首頁**

![](https://i.imgur.com/8hYGByC.png =500x)**筆記總覽頁的新設計**

## 通知中心，不錯過新訊息

以往只要筆記更新或是有新留言，HackMD 就會寄送通知信到你的電子信箱，但有時信件太多，你可能因此忽略了重要的訊息。HackMD 在[今年初推出了全新的通知中心][fb-notification]，明確劃分了不同通知層級，並設計了簡潔漂亮的通知中心介面來收納通知，從此你不會再錯過重要的新訊息！

![](https://i.imgur.com/A7UHEbE.png =500x)**在通知中心縱覽所有新訊息**

[fb-notification]: https://www.facebook.com/hackmdio/posts/2797404056983452

## 外部服務整合與擴充功能

在 2019 這一年，我們整合了更多的外部服務。在[三月底][fb-account-integration] 上線的多 OAuth 授權整合功能，讓你用多組社群帳號（如 Facebook, Twitter）登入同一個 HackMD 帳號。在[八月初][fb-github]，我們整合了 [HackMD 的版本功能以及 GitHub 版本控制][tutorial-github]，你可以用 HackMD 來編輯、同步、更新 GitHub 上的檔案。

[fb-account-integration]: https://www.facebook.com/hackmdio/photos/a.1004391802951362/2251889861534877
[fb-github]: https://www.facebook.com/hackmdio/posts/2475780629145798
[tutorial-github]: https://hackmd.io/c/tutorials-tw/%2Fs%2Flink-with-github-tw

在 2019，我們也持續更新 HackMD 的瀏覽器擴充功能：[HackMD-it][tutorial-hackmd-it]。在[九月時][fb-hackmd-it]，HackMD-it 支援了釘選筆記以及新的設定介面。

也同樣在九月，我們在 VSCode Marketplace 發佈了 [HackMD VSCode][vscode-hackmd] 擴充功能。即使身處離線環境，我們也能在 VSCode 裡撰寫相容 HackMD 的 Markdown 語法，並即時預覽：

![](https://i.imgur.com/X31HZqm.png =500x)**在 VSCode 裡寫 HackMD Markdown!**

[fb-hackmd-it]: https://www.facebook.com/hackmdio/posts/2525902220800305
[tutorial-hackmd-it]: https://hackmd.io/c/tutorials-tw/%2Fs%2Fhackmd-it-tw
[vscode-hackmd]: https://marketplace.visualstudio.com/items?itemName=HackMD.vscode-hackmd

## 協作與社群

在[五月時][fb-invitation]，HackMD 上線了筆記的 [邀請協作][tutorial-invitation] 功能，輸入使用者名稱或 Email，搜尋並邀請你的夥伴一起編輯筆記，並能進一步的調整協作者的權限。

![](https://i.imgur.com/zxUnb1B.png)**邀請介面**

在[九月初][fb-team-private-testing]，藉著與台灣微軟合辦的[一場小聚][hackmd-meetup]，我們偷偷上線了團隊功能並進行了封測。最近我們更加完善了團隊功能，並推出「開放團隊功能」。只要你有協作的需求，你可以新增一個團隊，在把夥伴同學們邀請進來，讓協作更有效率！

![](https://i.imgur.com/ixspMDF.png )**打開首頁左上角的「空間選單」，選擇「建立新團隊」**

![](https://i.imgur.com/XfgbeYq.png )**如果團隊的筆記能讓全世界都受益，可以將「團隊隱私性」設為「開放」哦！**

[tutorial-invitation]: https://hackmd.io/c/tutorials-tw/%2Fs%2Finvite-tw

[fb-team-private-testing]: https://www.facebook.com/hackmdio/photos/a.1004391802951362/2527782943945566
[fb-invitation]: https://www.facebook.com/hackmdio/photos/a.1004391802951362/2325041240886405
[hackmd-meetup]: https://hackmd.kktix.cc/events/markdown-vscode-github-developer-meetup

## 邁向 2020...的 Q2 啦！

你以為我要說的是邁向 2020 嗎？答錯了，因為 2020 年的第一季都快過了 :joy: 

回顧近一年的 HackMD，在[編輯體驗](#利用範本快速建立新筆記)、[介面設計](#全新的首頁，全新的設計)、[外部整合](#外部服務整合與擴充功能)、[團隊協作](#協作與社群)等，各個方面都有巨大的升級。在接下來的一年，開發團隊也會繼續卯足能量，會各位帶來更好的 HackMD！

順便在這裡預告一下，最近團隊正在加緊努力的讓「提及」功能上線，以後在筆記就可以用「**@**」符號來標記協作夥伴，請他們出來乖乖面對囉 :sunglasses: 



HackMD 最近在忙什麼？


# HackMD 新部落格開幕

嗨！歡迎來到 HackMD 的新部落格 🤗

HackMD 的新功能，除了能在站上的公告欄看到外，你也可以在 HackMD 的社群帳號，[Twitter](https://twitter.com/hackmdio) 帳號以及 [Facebook](https://www.facebook.com/hackmdio) 粉絲專頁上看到。

不過社群網站的貼文容易被淹沒，我們需要一個地方能妥善整理所有關於 HackMD 的新資訊，讓所有 HackMD 的新朋友能夠清楚的看到我們的軌跡。這些資訊到底該放在哪裡呢？聽說有個服務名字 Hack 開頭 MD 結尾，拿來寫 Markdown 超方便，又支援多人共同協作，不如就來試試看吧！🤩

![](https://i.imgur.com/zI2vgHp.png =500x)
**▲ HackMD 的臉書粉絲專頁**

![](https://i.imgur.com/1p3zD3w.png =500x)
**▲ HackMD 的官方 Twitter 帳號**

![](https://i.imgur.com/lNwP1ej.png =500x)
**▲ HackMD 的公告欄**


## HackMD 的書本模式

如你所見，我們的部落格就在這裡誕生囉，而且可能會讓你有點驚訝的是，這個部落格是用 HackMD 的「[書本模式][book-mode]」做的！

書本模式是什麼呢？書本模式是在 HackMD 裡**整理多篇筆記**的功能，它可以將多篇 HackMD 「整理成一本書」，透過側邊欄來瀏覽、切換多頁筆記內容。我們該如何使用呢？

1. 開一篇新的筆記，並使用無序清單來整理多篇筆記的連結
    ```md
    - [連結 1](https://hackmd.io/link-to-note-a)
    - [連結 2](https://hackmd.io/link-to-note-b)
    ```
2. 設定筆記共享模式為書本模式，並按下預覽
    ![](https://i.imgur.com/TzU0tA2.png =300x)

一本簡單的小書就完成了！

![](https://i.imgur.com/fKoIb1f.png)
**▲ 書本模式完成圖**


我們把每篇部落格文寫在 HackMD 上，再使用書本模式來整理文章，部落格文章的首頁即是以書本模式發佈的 HackMD 筆記。

不過看到這裡你可能會想：「騙誰啊！書本模式明明跟我現在看到的部落格長得完全不一樣啊！！」

確實，要完成現在你看到的 HackMD 部落格，還需要一點點的 *hack*！

## 在 HackMD 自訂筆記樣式表

這 **一點點的 hack** 指的就是 CSS！CSS (Cascading Style Sheets) 是網頁製作中不可或缺的要素之一，筆記的字體、顏色、粗細、排列方式都交給 CSS 定義，而且有一點很重要：

**HackMD 是可以自訂筆記的 CSS 的！**

只要在 Markdown 的編輯區輸入 `<style>` 標籤，HackMD 會自動把裡面的樣式套用到筆記，你甚至可以像寫網頁一樣自訂自己的元素或各種內容喔！

拿 CSS Tricks 的 [The Shapes of CSS](https://css-tricks.com/the-shapes-of-css/) 當做例子，裡面有一段用 CSS 畫月亮的程式碼如下

```css
#moon {
  width: 80px;
  height: 80px;
  border-radius: 50%;
  box-shadow: 15px 15px 0 0 red;
}
```

讓我們把這段程式碼貼進 HackMD 的筆記裡：

```md
## Title

<div id="moon"></div>

<style>
#moon {
  width: 80px;
  height: 80px;
  border-radius: 50%;
  box-shadow: 15px 15px 0 0 red;
}
</style>
```

就能在 HackMD 筆記中成功畫出月亮了！

![](https://i.imgur.com/JF8lLu0.png)
**▲ 在 HackMD 使用自訂 CSS 畫月亮**

透過 CSS，我們甚至可以大幅度的改造 HackMD 發佈樣式，下面兩個主題分別為直書排版和閱讀器主題。自訂 CSS 有著無限的可能性，歡迎大家來玩玩！

![](https://i.imgur.com/b3ICfHq.png)
**日文直式排版範例 ([連結](https://hackmd.io/@yukai/BJlXYPEcr))**

![](https://i.imgur.com/MbbgzVV.png)
**Reader 主題 ([連結](https://hackmd.io/@yukai/BkQM8MNmS))**

## 使用內嵌筆記功能共用筆記樣式表

當多份筆記中有許多共通內容時，身為一個軟體開發者，根據 **Don't repeat yourself** (DRY，不要重複你自己) 原則，我們應該共通的部分拆分出去。

程式碼可以用模組的方式共用，那筆記內容呢？這種「提出共用內容」的功能，在 HackMD 我們把它稱為「[內嵌筆記][embed-note]」，內嵌筆記的用法分成三個步驟：

1. 建立一篇共同內容的筆記
2. 複製筆記的 ID
3. 使用內嵌筆記的語法，在想要使用共同內容的筆記，內嵌該筆記內容
    :::info
    &#x7B;%hackmd 筆記ID %&#x7D;
    :::

<style>
.alert.alert-info {
    font-family: Menlo, Monaco, Consolas, "Courier New", monospace;
    background-color: #f7f7f7;
    border: none;
    color: #333;
    font-size: 85%;
}
</style>

讓我們看個實際例子吧！首先我們先建立一份準備裡面有共用內容的筆記，在網址列後面的部分就是這篇筆記的 ID，我們把它複製起來

![](https://i.imgur.com/LHO51pN.png)

接著到另一篇筆記，輸入內嵌筆記的語法：

:::info
&#x7B;%hackmd IZkuNzoQSjCNfEGOd0bESA %}
:::

![](https://i.imgur.com/OV40hze.png)

可以看到剛剛在另一篇筆記的內容被嵌進來了，只需要一行引用的語法。利用[內嵌筆記][embed-note]功能，我們可以將筆記的共用內容提取出去，提取的內容當然也包含樣式表，以中文直書主題為例，在你的筆記加上以下語法：

:::info
&#x7B;%hackmd @yukai/vertical-writing %}
:::

就可以讓筆記的發表模式以直書排版顯示囉！

![](https://i.imgur.com/b3ICfHq.png)


## 成果

在組合了「書本模式」、「自訂樣式表」、「內嵌筆記」這幾個 HackMD 功能，我們的部落格終於完成了！

![](https://i.imgur.com/FdzHM3p.png)


經過本文的介紹後，各位是否對 HackMD 的這幾個功能有了更深的理解呢？更多關於這幾個功能用法，可以參考 HackMD 的使用教學：

- [書本模式][book-mode]
- [內嵌筆記][embed-note]

**Happy Hacking!**

[book-mode]: https://hackmd.io/c/tutorials-tw/%2Fs%2Fhow-to-create-book-tw
[embed-note]: https://hackmd.io/c/tutorials-tw/%2Fs%2Fhow-to-embed-note-tw

---

HackMD 新部落格開幕


# Live Streaming Your Note

Hello markdown hackers,

You can now live stream a collaborative note! :ocean: 
Share your window scrolling with your collaborators, so they don't get lost! :cold_sweat: 

[Learn how now.](https://hackmd.io/c/tutorials/%2Fs%2Flive-hosting)

And don't forget to [let us know how you think and how we could improve!](https://github.com/hackmdio/hackmd-io-issues/issues)


Live Streaming Your Note


# Sync a Note with GitHub

Hello markdown hackers,

:tada: **GitHub Sync is HERE!** :tada:

You can now **link a HackMD note with a Markdown file on GitHub** to keep all your documentation in sync. :arrows_clockwise:

[See how to sync with GitHub!](https://hackmd.io/c/tutorials/%2Fs%2Flink-with-github)

Also, choose your line break rendering rules for :one: note or ALL :100: your notes!!

[Let us know how you think and how we could improve!](https://github.com/hackmdio/hackmd-io-issues/issues)


Sync a Note with GitHub


# Save and Name a Note Version

Hello markdown hackers,

You can now **save your notes manually and name the version**. :open_file_folder:
HackMD has been saving revisions of your work faithfully, now you can save it when you need to.
You can give your version a name and a description. [Learn more](/c/tutorials/%2Fs%2Fhow-to-save).
You can also compare any two versions. [See how](/c/tutorials/%2Fs%2Fhow-to-save#Compare-Versions)
This is our first step toward syncing with GitHub. Stay tuned! 

[Let us know how you think and how we could improve!](https://github.com/hackmdio/hackmd-io-issues/issues)






Save and Name a Note Version


# Publish Notes with Permalinks to Your Profile

Hello markdown hackers,

We're thrilled to announce **THREE** new features! :tada:

You can now Publish notes :one: with Permalinks :two: to your Profile page :three: !

1. You now have a public profile page at https://hackmd.io/@username :rocket: 
    - Set your username and short bio at https://hackmd.io/settings
    - Access your profile page at https://hackmd.io/profile
    - Read more about your profile page [here](https://hackmd.io/c/tutorials/%2Fs%2Fall-about-profile-page).

2. You can now use permalinks for your notes. Non-English characters - even emojis can be used! :accept: [Learn more](https://hackmd.io/c/tutorials/%2Fs%2Fhow-to-publish-note). 

3. Finally, you can publish your notes in the mode (book, slide, static view, or collaborative) you want people to see. :sunglasses: [Learn more](https://hackmd.io/c/tutorials/%2Fs%2Fall-about-profile-page). 

[Let us know how you think and how we could improve!](https://github.com/hackmdio/hackmd-io-issues/issues)



Publish Notes with Permalinks to Your Profile


# Share private notes with specific users

Hello markdown hackers, 

You can now (finally) share a private note with specific people. :two_men_holding_hands: 

Click the <i class="fa fa-unlock-alt fa-18"></i> permission icon on the top right corner and invite your friends to share the secret! :see_no_evil:

Remember to fill your email at: https://hackmd.io/settings before you can be invited to a secret party yourself! :love_letter:

Let us know how to improve [here](https://github.com/hackmdio/hackmd-io-issues/issues).

Share private notes with specific users


# Fill Your Email to Be Invited :email: and Separation of Comment Permissions :lock_with_ink_pen:

## Fill your email address to be invited!

We are one step closer to launching the long-requested feature: sharing with specific users. To invite your collaborators, you need a way to invite them - nothing beats email address in doing that. 

Go to hackmd.io/settings to fill your email, so you can be invited by your collaborators when we launch the specific sharing.

Also, you could now sign-in with email address and password (and reset your password). Yeah, I know this sounds basic, but we want to be least intrusive to your privacy and just didn't need it previously.

## Separation of Comment Permissions

The permission to comment is now separated into its own permission - no longer tied to editing. This should allow more fine-grained permission control for your notes.

Submit an issue to tell us [where to improve](https://github.com/hackmdio/hackmd-io-issues/issues).

Fill Your Email to Be Invited :email: and Separation of Comment Permissions :lock_with_ink_pen:


# Boost Productivity with Templates 

Hello markdown hackers,

Now you could HackMD faster with templates!
1. Save your time copy-pasting from recurring notes, such as your weekly meeting minutes.
2. Keep your contents consistent, use the same styling for all your blog posts and study notes.
3. Let you re-use complex components, such as UML diagrams, so you don't have to build them from scratch every time.

Hover your mouse on the "New note" button :heavy_plus_sign: and click "<i class="fa fa-file-image-o" aria-hidden="true"></i> Create a note from template" in the drop down menu. You will then see the template panel.

![](https://i.imgur.com/LZdj7IT.png)


We also include few default templates that you could use or change to your liking.

See the tutorial [here](https://hackmd.io/c/tutorials/%2Fs%2Fhow-to-use-template) or [中文教學](https://hackmd.io/c/tutorials-tw/%2Fs%2Fhow-to-use-template-tw).

Boost Productivity with Templates


# Merging two accounts 

Hello markdown hackers,

Now you can merge two of your accounts into one. Doing this could reduce your confusion of "which account did I use to sign-in to HackMD?" and make it easier for you to manage all your notes.

Go to hackmd.io/settings and choose the sign-in method you want to merge. Your current sign-in method has a check mark behind it. Once you sign-in with other method, you will see how many notes the other account has, then you could choose to merge the two accounts, or not.

![](https://i.imgur.com/Whmbysr.png)


We have been working on letting you share a note with specific users, this is the first step. When the next step is done, you would be able to sign-in using email address. By the end of the last step, you could invite your partners to collaborate on HackMD using emails.

Let us know [how do you think, how can we do better](https://goo.gl/forms/wQdTn6hEN1pIy9qD2).


Merging two accounts


# Batch Download All Your Notes :package:

Hello markdown hackers, 

You can (finally) download all your notes at once! :tada:

Please go to Settings (by clicking your profile picture at the top right corner or go to https://hackmd.io/settings), where you will find a button to "Download all notes" next to "Backup".

One of the reasons we love writing in markdown is its unbeatable portability. Therefore, it is imperative to us that you own your data wherever you want, whenever you want it.

Let us know [how do you think, how can we do better](https://goo.gl/forms/wQdTn6hEN1pIy9qD2).

Please also check out our recent support for [choosing your interface language](/c/tutorials/%2Fs%2Fhow-to-choose-language).

Batch Download All Your Notes :package:


Introducing HackMD Enterprise Edition
===

Dear Markdown hackers,

We are introducing **HackMD Enterprise Edition (EE)**, a new HackMD service with features specifically designed for knowledge sharing and collaboration. We are releasing these features to a new service for try out: Demo.hackmd.io. More importantly, we want to take this chance to thank you.

### Thank You

We've seen significant growth in HackMD.io in the past six months. Our hosted notes increased from 100,000 in March to more than 220,000 today. Our registered users had doubled from 16,000 to more than 33,000. We've been blown away by how quickly our project went viral and humbled by all the support HackMD had received. We want to say thank you and assure you that we are committed to keep making HackMD the best tool for knowledge management and collaboration with Markdown syntax. We've heard all your questions, comments, suggestions, and complaints. We deeply appreciate all of them. 

### HackMD Enterprise Edition (EE)

HackMD(EE) is our response to your requests. We added two long-awaited features so you could have better control over your private information:
* HackMD(EE) comes with **Advanced Permission Controls** for each note. You can now invite registered users to your note and set individually read, write, or admin priviledge for each invitee. 
* With HackMD(EE), you can now keep all your images private with our **Private Images Hosting** service.

To improve your experience organizaing knowledge, HackMD(EE) now comes with a new **Overview Page** to aid notes organization and knowledge discovery. With the **Book Mode** released earlier, your notes could now be viewed and found the way your think of them in your mind.

To free our users from the overhead of managing their own instances, HackMD(EE) would be a hosted **Software-as-a-Service (SaaS)** offering. We now provide service manager a **Dashboard** for notes management and users access monitoring. Customer supports and other customizable options are also available. Leave the maintenance and other hassles to us, so you can focus on making great things and sharing valuable insights. 

### New Playground: Demo.HackMD.io
Features available in HackMD(EE) would be available in demo.hackmd.io, an instance with ephemeral storage. User of this instance would have access to dashboard and advanced permission controls, among other new enterprise features of HackMD(EE). However, notes created on demo.hackmd.io would be deleted weekly. These make demo.hackmd.io a playground great for feature try-outs, disposable notes, or other creative usages.

### HackMD.io Remains Free
For the past two years, we've run HackMD.io as a free service providing real-time collaboration and knowledge management across the globe. HackMD.io hosted shared notes for countless tech conferences, meetups, seminars, and hackathons. We are so grateful to be part of the exchange of so many great ideas. We are therefore committed to **keep HackMD.io free and open to everyone**, as it always was. It is our privilege to have the opportunity to contribute to the greater community. We will keep it that way.

The past two years were quite an adventure. We would like to thank you for all your supports. As always, please don't hesitate to [like us on Facebook](https://www.facebook.com/hackmdio/), join the [chat on twitter](https://twitter.com/hackmdio) or [drop us a mail](mailto:hackmdio@gmail.com) if you have any questions or comments. We'd love to hear. 

Happy hacking,
HackMD Team

最近文章

立刻開始使用 HackMD