在掘金(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 和标签的。

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

相关推荐
异常君5 小时前
线程池隐患解析:为何阿里巴巴拒绝 Executors
java·后端·代码规范
xiezhr2 天前
程序员的快乐其实很简单
程序员·代码规范
苏近之2 天前
Rust 重构 Rust:枚举和模式匹配
rust·代码规范
Nyingchi_X2 天前
vite6+vue3+ts+prettier+husky9+lint-staged+eslint9配置前端项目(后台管理系统、移动端H5项目通用配置)
前端·代码规范
前端大白话2 天前
超详细!前端必学的CSS动态水波涟漪效果实现全攻略
前端·css·代码规范
桦说编程2 天前
编程原则不是目的,而是手段
设计模式·程序员·代码规范
kaede3 天前
Prometheus配置Docker采集器
linux·架构·代码规范
三次握手四次挥手3 天前
基于Python+Pytest实现自动化测试(全栈实战指南)
开发语言·python·自动化·k8s·apache·pytest·代码规范
三原3 天前
组件源码:实现列表无缝滚动支持Vue3、vue2
前端·vue.js·代码规范