How to Write Compelling Technical Articles: Proven Tips for Engineers

1. Content Is King

Good technical articles must provide valuable content that benefits readers; without solid substance, a piece should not be forced. Continuous reading, thinking, and writing build a reservoir of ideas, and specific tricks can help generate material.

2. Characteristics of Good Technical Articles

Reading count ≠ article quality – High views often stem from catchy titles or trendy topics, not necessarily depth. Quality is independent of popularity.

Longer articles tend to contain richer, more detailed information, but length alone does not guarantee quality; the content must be substantive and free of filler.

When an article feels thin, treat it as a note, expand it later with deeper analysis, and avoid merely copying documentation.

3. Clear Narrative Structure

Excellent content + clear structure = good article

Two common narrative styles help convey technical material:

Linear narrative – progress step‑by‑step, suitable for troubleshooting, design discussions, or project updates.

Structured narrative – hierarchical expansion, ideal for planning, summarizing, or presenting comprehensive solutions.

Linear narratives guide readers sequentially, often using a main thread and rhythmic progression, while structured narratives resemble a tree, allowing readers to jump to sections of interest.

Linear narrative is a linked list; structured narrative is a tree.

4. Writing Tips

Fragmented notes, structured organization – Record ideas daily (e.g., using a note app), then consolidate them into a material document before drafting.

Deliberate practice, write then revise – Draft short passages, describe viewpoints clearly, and spend five minutes revising for clarity; rewrite past articles to improve both technical understanding and writing skill.

Attention to layout and grammar – Use proper punctuation, distinguish headings, keep sections balanced, cite data sources, and maintain consistent language conventions.

Enhance readability with lists, tables, blockquotes, bold, italic , code marks, and occasional strikethroughs.

Limit heading depth to three levels.

Balance section lengths; split overly long sections.

Provide clear data sources and reference links.

Insert a space when mixing Chinese and English.

Observe correct capitalization for technical terms.

Prefer concise Chinese sentences; break long English clauses with punctuation.

Proofread to eliminate typos.

Use images liberally; even text‑only images convey more information than plain text.

5. Final Thoughts

Consistently writing helps develop a personal style, giving all articles a common thread. Over time, this style becomes recognizable and reinforces the author’s brand.