在掘金(Juejin)上使用 Markdown、代码块和选择标签的一些关键点和技巧

一、 Juejin 的 Markdown 使用

掘金的编辑器支持标准的 Markdown 语法,并且通常会提供实时预览功能。以下是一些最常用的 Markdown 语法:

  1. 标题 (Headings): 使用 # 号来创建标题,# 的数量表示标题的级别(1-6级)。

    shell 复制代码
    markdown复制代码
    # 这是一级标题
    ## 这是二级标题
    ### 这是三级标题
  2. 加粗和斜体 (Bold & Italic):

    • 用两个星号 ** 或两个下划线 __ 包裹文字表示加粗。
    • 用一个星号 * 或一个下划线 _ 包裹文字表示斜体。
    • 用三个星号 *** 或三个下划线 ___ 包裹文字表示加粗并斜体。
    markdown 复制代码
    markdown复制代码
    **这是加粗文字**
    *这是斜体文字*
    ***这是加粗斜体文字***
  3. 列表 (Lists):

    • 无序列表: 使用 -, *, 或 + 开头,后面跟一个空格。
    • 有序列表: 使用数字加点 . 开头,后面跟一个空格。
    markdown 复制代码
    markdown复制代码
    - 列表项 1
    - 列表项 2
      * 嵌套列表项 2.1
      * 嵌套列表项 2.2
    
    1. 步骤一
    2. 步骤二
    3. 步骤三
  4. 链接 (Links): 使用 [链接文字](链接地址) 格式。

    less 复制代码
    markdown复制代码
    [访问掘金官网](https://juejin.cn/)
  5. 图片 (Images): 使用 ![图片替代文字](图片地址) 格式。掘金编辑器通常也支持直接拖拽或粘贴上传图片。

    less 复制代码
    markdown复制代码
    ![掘金 Logo](https://lf3-cdn-tos.bytescm.com/obj/static/xitu_juejin_web/img/logo.a7995ad.svg)
  6. 引用 (Blockquotes): 使用 > 开头。

    markdown 复制代码
    markdown复制代码
    > 这是一段引用文字。
    >
    > ------ 引用来源
  7. 分割线 (Horizontal Rules): 使用三个或更多的 -, *, 或 _

    yaml 复制代码
    markdown复制代码
    ---
    ***
    ___
  8. 行内代码 (Inline Code): 使用反引号 ````` 包裹代码片段。

    scala 复制代码
    markdown复制代码
    这是一个 `inline code` 的例子。

二、 代码块 (Code Blocks)

代码块对于技术文章至关重要。

  1. 基本语法: 使用三个反引号 ``包裹代码块。

    复制代码
    markdown复制代码

    function hello() { console.log("Hello, Juejin!"); }

    复制代码
    复制代码
  2. 语法高亮 (Syntax Highlighting): 为了让代码更易读,强烈建议在开始的三个反引号后面指定代码的语言。掘金会根据语言进行语法高亮。

    ini 复制代码
    markdown复制代码
    ```javascript
    function greet(name) {
      return `Hello, ${name}!`;
    }
    const message = greet('Developer');
    console.log(message);
    python 复制代码
    python复制代码
    def add(a, b):
      """This function adds two numbers"""
      return a + b
    
    result = add(5, 3)
    print(f"The result is: {result}")

    常见的语言标识符包括:javascript, typescript, python, java, csharp, cpp, html, css, sql, bash, json, yaml, markdown 等。

  3. 可读性:

    • 保持代码块简洁,只包含必要的代码。
    • 复杂的代码段可以在文章中分步解释。
    • 适当添加注释,但主要逻辑解释应放在代码块外的文本中。

三、 标签选择 (Tag Selection)

选择合适的标签能显著提高文章的曝光率和可发现性。

  1. 重要性: 标签帮助掘金将你的文章分类,并推荐给对相关领域感兴趣的读者。用户也可以通过标签来搜索和浏览内容。

  2. 选择原则:

    • 相关性: 标签必须与文章内容紧密相关。这是最重要的原则。

    • 准确性: 使用能精确描述文章核心技术或主题的标签。例如,如果文章是关于 React Hooks 的,ReactReact Hooks 就比单独一个 前端 更准确。

    • 覆盖度: 可以结合使用宽泛标签和具体标签。

      • 宽泛标签 (父标签):前端, 后端, 人工智能, Android, iOS 等,有助于覆盖更广泛的读者群。
      • 具体标签 (子标签):Vue.js, React, Node.js, Spring Boot, TensorFlow, SwiftUI 等,有助于吸引对特定技术栈感兴趣的读者。
    • 热度与官方推荐: 掘金可能会根据你输入的内容推荐标签,这些通常是比较常用或官方定义的标签,可以优先考虑。同时也要考虑标签的热度,但不要为了热度选择不相关的标签。

    • 数量: 通常建议选择 3-5 个标签,不宜过多,以免分散焦点;也不宜过少,以免覆盖面不足。

  3. 示例:

    • 一篇关于 "使用 Vue 3 Composition API 进行状态管理" 的文章,可选标签:前端, Vue.js, Composition API, 状态管理
    • 一篇关于 "优化 Nginx 性能配置" 的文章,可选标签:后端, Nginx, 性能优化, 服务器
    • 一篇关于 "入门 Python 数据分析 Pandas 库" 的文章,可选标签:Python, 数据分析, Pandas

总结建议:

  • 熟悉 Markdown: 多使用掘金编辑器写草稿,利用预览功能熟悉各种语法效果。
  • 代码高亮: 务必为你的代码块指定正确的语言,提升阅读体验。
  • 精心选标签: 花点时间思考最能代表你文章内容的标签组合。
  • 参考优秀文章: 看看掘金上你喜欢或高阅读量的文章是如何使用 Markdown 和标签的。

希望这些信息能帮助你在掘金上更好地创作!如果你有具体的文章想法或草稿,我可以提供更进一步的建议。

相关推荐
To_OC2 天前
万字解析《JS 语言精粹》之第五章:继承 5 大核心精髓(JS 原型核心)
前端·javascript·代码规范
Coffeeee2 天前
闲聊几句,Android老哥们,你们多久没做技改需求了
android·程序员·代码规范
饼干哥哥2 天前
扣子3.0测评:我让 Codex 和 Claude Code 住同一个桌面,结果它们打架了!
人工智能·开源·代码规范
码哥字节4 天前
为什么 Claude Code 读你的代码库,光靠 embedding 根本不够?
claude·代码规范
kisshyshy6 天前
从递归到迭代,一文吃透二叉树的核心知识与 JavaScript 实现
javascript·算法·代码规范
用户69190268133910 天前
Vibe Coding 开发项目的基本范式
人工智能·设计模式·代码规范
Cosolar10 天前
藏在 Claude Code 里的极致浪漫:完整 187 条 Spinner Verbs 全收录
后端·程序员·代码规范
Mickey86111 天前
MCP 加持下的零代码逆向:全自动化绕过 APP 验签与加密实战
代码规范
专注VB编程开发20年14 天前
WebView2 + HostObject 架构的核心痛点 ——强耦合、同步阻塞、异常连锁、内核绑定
代码规范