This article introduces the basic concepts of Markdown and its applications in various software. It recommends using VSCode as an IDE and lists recommended plugins. The author shares their experience switching from Hexo to Hugo, emphasizing Hugo’s flexibility and customization capabilities. Finally, it provides tips for quickly getting started with new technologies and shares a trick for resolving Hugo theme styling update issues.
Preface
Markdown
A lightweight markup language that allows people to write documents in an easy-to-read and write plain text format
Detailed Markdown syntax is not elaborated on here; instead, an ebook is recommended: 点击此处
Many software programs already support md as a writing format. The CSDN blog system launched an online editor that supports md syntax, and it includes a helpful introductory article on md syntax when you first use it. Evernote added md note support in 2018, with various md markup options readily available, making the experience similar to editing regular articles and suitable for beginners.
Recommended IDEs
By the time this article was written, it was 2020. You’ve likely heard of VS Code—after all, anyone considering using Git Page to build a blog system is an industry professional. While Sublime and Atom were good choices in earlier years, with two years of community support, VS Code has rapidly developed and become the preferred starting point for beginners.
Microsoft’s relationship with the open-source community has transitioned from a fractured state to a honeymoon period: embracing open source. The company I work for has also actively adopted the Java ecosystem in recent years; in other words, the current Java landscape is genuinely appealing within China.
VS Code plugin recommendations
Please provide the Chinese text you want me to translate. I am ready when you are.
Plugins typically include Readme files detailing basic usage, core features, and sometimes dynamic effect demonstrations provided by the plugin authors
It easily integrates images, complementing Hugo’s image plugin approach
Can’t remember the shortcuts, open the VS Code shortcut management menu, search for “md,” look at it several times; review the plugin instructions again
hugo
I’m naturally restless; I can’t just sit still and write articles
- Hugo supports placing images and Markdown documents in separate folders
- Academic themes support various article styles in design
- Various convenient custom extensions
academic
The website defaults to ______
The URL structure allows single-page navigation, avoiding scrolling on the homepage—a matter of personal preference
- Formats: Essays, speeches, ebooks
- Flexibility: Customize overall style, customize CSS styles
This theme’s support for Chinese is not yet fully mature, mainly from a visual perspective – the font size isn’t ideal for Chinese reading habits. However, it benefits from being developed by mostly Chinese developers, giving it an advantage over Hugo.
However, it’s best to do things yourself – inspect the browser elements. Once you’ve located an element, clicking on Insert Style Rule Below in the sidebar allows you to easily retrieve the CSS style name, even for deeply nested styles.
- Please provide the Chinese text you want me to translate. I am ready when you are! Just paste the text here.
- Please provide the Chinese text you want me to translate. I am ready when you are! Just paste the text here.
- Theme-specific syntax highlighting settings, 官方链接
Conclusion
The child is about to complain again – why are you being so vague from beginning to end, without mentioning any details?
I want to say that these things are enough for you
- Official Manual
- Plugin Description
To quickly get started with new technology, it’s recommended to first read the official documentation. Don’t feel pressured to understand everything in one go; at least aim for a general understanding. Search engine results may not always align with the latest version and could be misleading. The same applies to new books – start by looking at the table of contents to grasp what the author intends to cover. Sometimes, reading the preface first is helpful; in some foreign works translated into Chinese, the translator’s preface often summarizes the book’s core content.
Easter egg
Switching Hugo Academic’s built-in style and publishing to the site didn’t change the appearance. Clever users likely figured out that clearing the browser cache would solve the problem. And me, being ingenious: F12 developer mode, switched to networkBOLD_2disable cache, refreshed, and it’s done!
