[Análisis completo] Cómo escribir un buen artículo técnico

prefacio

porque escribir
  • Crecimiento tecnológico : en comparación con el enorme sistema de conocimiento en el campo de la informática, la memoria humana aún es demasiado limitada y, con la edad, la memoria también disminuirá gradualmente. Como dice el dicho, "una buena memoria no es tan buena como una mala pluma". Y en el proceso de compartir blogs, también podemos comunicarnos con los grandes dioses y luego descubrir nuestros propios errores cognitivos y corregir el sistema de conocimiento. Lo último y más importante es que al grabar blogs, podemos resumir en el tiempo, ordenar ideas a través de la escritura y verificar omisiones.
  • Aumentar la influencia : en el mundo actual, si hay algo de lo que es más valioso hablar, es de la influencia. La razón por la cual las celebridades de Internet y las celebridades pueden ganar mucho dinero es porque tienen una gran influencia. En esta era de competencia feroz, aquellos con fuerte influencia son los verdaderos ganadores. Y la escritura es, sin duda, una herramienta para ampliar la influencia.
  • Oportunidades de trabajo : en el proceso de búsqueda de empleo, el papel de los blogs no debe subestimarse. El blog en sí mismo es una muy buena plataforma para la autopresentación. Al mostrar la amplitud y profundidad de sus habilidades al entrevistador, puede estar un paso adelante. de la mayoría de los buscadores de empleo.
  • Ingresos adicionales : alquile espacios publicitarios en su propio blog/cuenta oficial, o coloque anuncios dentro de la empresa, o firme un contrato con un escritor en una plataforma de escritura, o escriba y venda libros con la ayuda de la influencia

imagen-20230719192253189

1. Aclara tu propio posicionamiento técnico y audiencia

El primero es aclarar su propio posicionamiento técnico . Por ejemplo, si me especializo en tecnología front-end, entonces la selección de temas técnicos del blog también debe enfocarse en esta dirección, para crear una IP personal. Aquí, por cierto , la selección de temas

Hay muchos temas para artículos técnicos , que se dividen aproximadamente en las siguientes categorías:

  1. Evangelismo sobre nuevos enfoques/técnicas : como nuevas funciones de JS o nuevas herramientas de compilación, etc.
  2. Resumen de soluciones técnicas : como mecanismo de optimización de carga en un entorno de red débil, etc.
  3. Guía de experiencia para marcos excelentes : como el proceso de reaccionar SSR de 0-1, etc.
  4. Consejos que creo que son muy poderosos : como algunos métodos de optimización únicos, magia negra JS, etc.
  5. Clase de análisis de principio : como el principio XXX diff, etc.
  6. Soluciones a problemas difíciles : como la solución al secuestro de CDN

Entre ellos, los primeros 3 puntos son más adecuados para que comiencen los estudiantes principiantes, y puede comenzar desde estos puntos de acuerdo con su situación real. Puedes encontrar nuevos puntos de tecnología de caniuse

En segundo lugar, se debe aclarar el propósito de la escritura y la audiencia. Es decir, marca el tono de la publicación del blog, ya sea desenfadado y humorístico, detallista, serio, profesional y general, u otros estilos.

Véalo usted mismo , es solo un ensayo, una nota personal. Se puede escribir casualmente, o incluso una oración o una imagen. Puede ser un artículo autoproclamado.

Para el intercambio de tecnología , es necesario considerar de manera integral en este momento. No puede escribirse como un artículo autoproclamado. Debe tener una cierta rutina y aclarar qué grupos es la audiencia, si es un principiante, un maestro o un líder. Toque apropiadamente de acuerdo con las preferencias de la audiencia y su propio círculo de competencia.

En general , la Parte A brindará un determinado formato y requisitos, y combinará la experiencia de compartir tecnología para completar el manuscrito.

Artículo autocurativo: Las palabras de moda en Internet son artículos escritos con un tono alto y una retórica magnífica, pero no están escritos desde el punto de vista de los usuarios.

2. Elija la plataforma de escritura adecuada

  • CSDN : el foro de blogs más antiguo de China, el SEO está funcionando muy bien, la cantidad de usuarios es grande, pero la calidad de los artículos generalmente no es alta y hay muchos anuncios, la experiencia del usuario no es buena
  • Blog Garden : Al igual que CSDN, es un sitio de blog antiguo con buen SEO y muchos blogs de alta calidad, pero la experiencia de escritura es pobre y el estilo es antiguo (pero se puede personalizar y embellecer)
  • Nuggets : la plataforma es nueva, la experiencia de escritura es excelente, la interfaz es refrescante y el funcionario a menudo lanza actividades para proporcionar recompensas materiales a los escritores destacados.
  • Tencent Cloud/Alibaba Cloud Community : sesión especial de Daniel, no se puede decir la calidad del artículo, pero no es muy adecuado para principiantes
  • Zhihu/Jianshu : Ninguna plataforma es un sitio web técnico especializado, pero la calidad de los artículos es relativamente buena y el peso de SEO es alto, lo que puede ser adecuado para el drenaje.
  • Cuenta pública : principalmente para desviar el tráfico de otras plataformas, adecuado para la operación a largo plazo
  • Creación de sitios web independientes : relativamente problemático, pero relativamente gratuito, debe optimizarse para SEO, blog de Daniel: Zhang Xinxu , Ruan Yifeng , Liao Xuefeng

3. Cómo titular el artículo

En promedio, 5 veces más personas leen los titulares que el cuerpo del texto - David Ogilvy

De hecho, hay dos principales importancias del título, una es la optimización SEO (motor de búsqueda) y la otra es mejorar la experiencia de lectura de los lectores.

Puntos clave del título.

1. Sencillo

He leído debates sobre los títulos de los artículos que generalmente coinciden en que los títulos de los artículos deben ser simples, breves y fáciles de entender. Si violas este principio, también puedes llamar la atención, esa atención confusa y abrumada. Los títulos cortos también son buenos para el SEO: mantenga los títulos de menos de 40 caracteres para asegurarse de que todos aparezcan en los resultados de búsqueda.

2. Llamar la atención

Un buen título puede hacer que su artículo se destaque y atraiga a los lectores a leerlo. Atraer la atención se puede lograr mediante el uso de palabras que crean un efecto de "choque", "apelación", "sorpresa" o incluso "confusión". Estas palabras pueden atraer a los lectores a leer el texto principal, aunque puede ser que el texto de la parte del título no se ajuste al título. Usa titulares para atraer lectores tanto como sea posible, aunque sea un pequeño truco.

3. Para satisfacer las necesidades

Los buenos titulares llevan a los lectores al cuerpo del texto simplemente porque creen que hay algo que satisface sus necesidades. Una encuesta del sitio web index http://del.icio.us muestra que los títulos que atraen más lectores suelen ser artículos como "Cómo..." o "Tutoriales para..." porque quieren resolver el problemas relacionados que encuentran .

4. Intuitivo

Aunque muchos lectores se verán atraídos por el texto principal por esos títulos ambiguos, la mayoría de los lectores prefieren títulos intuitivos para que puedan decidir si aprender más. El título debe ser corto e intuitivo para indicar el contenido principal del texto.

5. Palabras clave

Anteriormente en este artículo, mencioné la importancia de los títulos para el SEO, por lo que si desea aprovechar al máximo este efecto, debe pensar en cómo elegir palabras clave que sean más fáciles de llamar la atención. Puede parecer difícil tener un título que sea a la vez conciso y convincente, pero se puede lograr. Por ejemplo, en SEO, la frase delante del título es más efectiva que la frase detrás.

Suplemento: Cómo escribir una introducción/resumen

El trabajo del encabezado es lograr que el lector comience a leer la primera oración . La tarea del comienzo del artículo es atraer lectores y hacer que sigan leyendo tu artículo .

La introducción al principio sigue la fórmula de la aplicación , es decir, requisitos coincidentes ( alinear ), mostrar ( presentar ), prueba de efecto ( prueba ), ejemplos

Primero, hacemos coincidir los requisitos ( Align ). En 1 o 2 oraciones, demuestre a sus usuarios que comprende el problema al que se enfrentan.

A continuación, presenta tu artículo como una solución.

Infórmeles que ha descubierto una solución al problema. O explique el método lo más brevemente posible sin revelarlo todo . "Alimentar" el contenido de las personas para que puedan seguir mirando.

Finalmente, se da nuestra prueba de efecto ( Prueba ).

Aquí puedes explicar por qué deberían confiar en ti. Después de todo, es probable que sus visitantes estén viendo su blog o sitio web personal por primera vez. Tienes que demostrar tu éxito, experiencia y pericia.

imagen-20230719164805226

4. Construya la estructura del marco del artículo.

A veces no puedo seguir escribiendo mientras escribo. Si configura el marco con anticipación y hace un mapa mental , será mucho más fácil y no se quedará atascado en la mitad de la escritura. La estructura general de los blogs técnicos es total-punto-total . Las siguientes son algunas plantillas que uso para compartir, y se pueden usar como ejemplo. Si tiene otras plantillas, es posible que desee compartirlas y avanzaremos juntos.

  • Hacer preguntas->analizar problemas->resolver problemas->resumir la experiencia y compartir problemas técnicos.
  • Antecedentes->pensamiento->intento->dificultades encontradas->solución->resultado final, problema compartido
  • Resumen->Introducción->Temas de rama->Resumen, intercambio técnico general.
  • Qué-Principio-Antecedentes>Qué problemas se resuelven->Operaciones básicas->Comparación similar->Resumen, adecuado para compartir nuevas tecnologías

5. Haz fotos y materiales relacionados

draw.io : una herramienta de dibujo en línea, muy poderosa, con varios elementos e íconos incorporados de uso común.

imagen-20230719165339992

excalidraw : una herramienta de dibujo de código abierto en forma de dibujo a mano. Puede dibujar imágenes directamente en el sitio web sin iniciar sesión. Puede exportar archivos fácilmente. Después de salir y volver a ingresar, también mostrará la imagen dibujada cuando salió la última vez Importar módulos dibujados por otros. Pero no es compatible con la escritura a mano en chino, aquí está la URL que admite la escritura a mano en chino

imagen-20230719165516798

6. Cómo redactar contenidos más atractivos

fácil de leer

A nadie le gusta leer. Solo quieren información. Si pueden descargar esta información en sus cerebros, lo harán. ——Tim Soulo

Lo primero que tenemos que hacer es cómo hacer que nuestros artículos sean fáciles de leer, recomiendo el libro de Bond Halbert The Halbert Copywriting Method Part III, el siguiente es un breve resumen

  • **Utilice párrafos cortos. **Bond dice que esto proporciona "alivio para los ojos". Mucho texto puede disuadir a los lectores, pero los párrafos cortos pueden invitarlos a entrar. Herramientas como Hemingway pueden hacerlo más fácil.
  • ** Desglose oraciones largas. **Las personas generalmente leen a la voz en su cabeza. Por lo tanto, las oraciones largas pueden dificultar el seguimiento de la lectura. Divide las oraciones encontrando las columnas reales donde se usan "y", "porque" y "esto".
  • ** Insertar multimedia. **Los videos, imágenes, animaciones, etc. pueden ayudarlo a explicar su punto de vista sin agregar texto.
  • Usar formato de texto. Negrita, cursiva, comillas o listas para dividir grandes cantidades de contenido y puede enfatizar puntos específicos.
  • Lea su ensayo en voz alta. Esto te ayuda a detectar cosas que no fluyen o son aburridas.

Forma de expresión

Un artículo técnico no es necesariamente un ensayo argumentativo o un ensayo narrativo, y se pueden explorar más formas de expresión.

  • Los cómics, como el programador Xiaohui, son divertidos y muy inmersivos.
  • Clase de caja de chat WeChat/DingTalk, la experiencia de lectura también es buena
  • Fan fiction, como "JavaScript: Immortals"
  • Sui Sui leyó el artículo, similar al estilo del artículo de Zhang Xinxu, este tipo de artículo también puede tener un efecto muy bueno con algunas bromas diarias.

empatía

Después de escribir un artículo, no significa que su artículo pueda publicarse o promocionarse, porque escribimos más desde nuestro propio punto de vista subjetivo, por lo que para garantizar la legibilidad del artículo, también puede pensar en ello desde lo siguiente perspectivas:

  • Si soy un novato, ¿puedo entender este artículo?
  • ¿Puedo entender el artículo si no reconozco las siglas en el artículo?
  • ¿Quiero agregar un diagrama de arquitectura aquí para explicar?
  • ¿Quiero agregar una imagen de demostración aquí para mostrarlo?
  • ¿Debo agregar comentarios de código aquí, qué sucede si la otra parte es un principiante?

Al mismo tiempo, hay otra habilidad muy importante, que es leer sus propios artículos varias veces, leerlo cuando se despierta por la mañana y leerlo antes de acostarse por la noche. Tal vez mientras lo lee, su inspiración viene de nuevo, y también puedes descubrir muchos errores tipográficos

Artículo de referencia:

Guía técnica para escribir un blog: material, diseño e imagen (jiekun.dev)

Pautas para escribir artículos técnicos - Comunidad de desarrolladores de KubeSphere

La guía técnica de redacción de blogs utilizada por todos los grandes dioses, hecha pública por primera vez, se recomienda ponerla junto a la almohada- Nuggets (juejin.cn)

¿Cómo escribir el título de una entrada de blog? -Zhihu (zhihu.com)

Cómo escribir un buen artículo técnico - Wakakawa

Lectura recomendada

17 habilidades efectivas de operación de blog (imprescindible para principiantes) (ahrefs.com)

9 consejos Título Consejos para crear una página de blog con una alta tasa de clics - Comunidad Lingxi (getlingxi.com)

Cómo escribo un blog técnico - Nuggets (juejin.cn)

Ruan Yifeng: Especificaciones de escritura para la documentación técnica china (github.com) —— ¡Muy recomendable! ! !

mensaje
  • Si siempre estás esperando un buen tema, una buena inspiración, es posible que no puedas escribir un artículo en tu vida.
  • No seas utilitario, escribe menos pautas para entrevistas XXX y escribe más casos e ideas reales.
  • mantén tu propio estilo, mantén tu propia personalidad
  • piensa en el momento, piensa en todo

Algunas imágenes de este artículo son de Wikipedia.

Supongo que te gusta

Origin blog.csdn.net/m0_63748493/article/details/131818692
Recomendado
Clasificación