私は本ブログを書いたり、また技術書を出版するなどして文章の書き方について学んできました。今では自分なりの型ができましたが、初めの頃はうまくかけませんでした。

この記事では、「技術ブログを書きたいけど、うまく書けない」や「読んでもらえる書き方を知りたい」といった悩みについて、次の4つのステップで記事の書き方を解説します。

1. 記事を設計する
2. タイトルを作る
3. 導入文を書く
4. 本文を書く

この記事を読むことで技術ブログの書き方がわかるようになります。あなたのブログがたくさんの人に読まれるようになって、ブログを書くのがもっとたのしくなると思います。

Hiroki Zenigami

テクニカルライター。元エンジニア。共著で「現場で使えるRuby on Rails 5」を書きました。プログラミング教室を作るのが目標です。

Follow @zenizh

テクニカルライティングを学ぶ

わかりやすい文章の書き方が学べる入門をnoteで公開しました。ブログやドキュメントなどを書くときにお役立てください。

テクニカルライティング入門

まずは何より記事を設計します。いきなり本文を書き始めるのではなく、記事を書くのに必要な項目を決めます。この理由は、設計が読まれるかどうかを決めるからです。記事を書くときは、まず次の7つの項目を決めます。

表だけだとわかりづらいので、本記事を書いたときの上の各項目についてを次に示します。

## キーワード
* 技術ブログ, 書き方

## ターゲット
* 技術ブログを始めようとしている人
* ブログを書いているけど、いい文章が書けない人

## 読者の悩み
* 技術ブログを書きたいけど、うまく書けない。読んでもらえる書き方を知りたい。

## 悩みが解決する条件
* 技術ブログの書き方がわかること

## 悩みの解決策
* 技術ブログの書き方について、次の4つのステップで解説する：
  1. 記事を設計する
  2. タイトルを作る
  3. 導入文を書く
  4. 本文を書く

## 記事を読むメリット
* 技術ブログをたくさん読んでもらえるようになる
* ブログを書くのがたのしくなる

## 記事の信頼性
* 本ブログを書いている
* 技術書の出版を通して書き方について学んだ

7つの項目の中でとくに重要なのがキーワードです。このキーワードは1つに絞りましょう。例えば本記事ですが、実は一度書き直していて、前のタイトルは次のようなものでした。

エンジニアが技術ブログを始めるメリットと書き方、おすすめのブログサービス

つまりキーワードは「エンジニア, 技術ブログ, メリット, 書き方, おすすめ, サービス」と、6つも入っていました。

こんな感じでたくさんのキーワードが入っていると、一番伝えたい「書き方」に対する関連度が小さくなって、「技術ブログ 書き方」で検索しても上位に表示されにくくなってしまいます。

読んでいる側としても、テーマがいくつもあると読みづらいです。キーワードを決めるときは、記事の範囲を狭くすることを意識しましょう。必要に応じて記事を分けるといいです。

ユーザーは悩みがあるときにGoogleなどの検索エンジンで検索します。このときのキーワードはステップ①で設計したやつです。タイトルには、このキーワードをふくめることが必要条件です。キーワードをふくめることで、検索したときにより上位に表示されるようになります。

キーワードをふくめた上で、ステップ①で設計したそれ以外の項目をもとに、記事を読みたくなるタイトルをつけます。

ステップ①の例で示した通り、この記事のキーワードは「技術ブログ, 書き方」です。記事を読むメリットは「ブログをたくさん読んでもらえるようになる」で、ターゲットは「初心者」です。これをもとに、次のようなタイトルを付けました。

技術ブログの書き方とは？読まれる記事を書く4つのステップ【初心者向け】

導入文は、読者が記事を読むかどうかを判断する大切な文章です。記事の冒頭の文章です。これも、①で設計した内容をもとに書きます。導入文の構成は次のような流れです。

順番については前後しても問題ありません。読みやすい文章になるように書いていきます。

この記事も上の流れにそって書いているので、例として示します。

【5. 記事の信頼性を示す】
私は本ブログを書いたり、また技術書を出版するなどして文章の書き方について学んできました。

【1. 読者の悩みに共感する】
今では自分なりの型ができましたが、初めの頃はうまくかけませんでした。

【2. 悩みが解決する条件を提示する】
この記事では、「技術ブログを書きたいけど、うまく書けない」や「読んでもらえる書き方を知りたい」といった悩みについて、次の4つのステップで記事の書き方を解説します。

【3. 記事で示すことを書く】
1. 記事を設計する
2. タイトルを作る
3. 導入文を書く
4. 本文を書く

【4. 記事を読むメリットを示す】
この記事を読むことで技術ブログの書き方がわかるようになります。あなたのブログがたくさんの人に読まれるようになって、ブログを書くのがもっとたのしくなると思います。

最後に本文です。本文はステップ①の「5. 悩みの解決策」を元に書きます。構成は自由ですが、文章をどう書くかについては気をつけるべきポイントがあります。具体的には次の8つです。

1. 結論を先に述べる
2. 文章を短く切る
3. わかりやすい単語を使う
4. 読者が知りたいことだけを書く
5. 再現条件を示す
6. 認識を揃える
7. 図や表、コードを提示する
8. 一次情報を引用する

再現条件は、OSやライブラリのバージョンなどです。記事で示すコードが動作する条件を書いておきます。「認識を揃える」については、例えば「アーキテクチャ」という単語でも文脈がインフラかソフトウェア設計かによって変わります。ここを書いておくと親切です。

一次情報については、適切に引用することで記事自体の信頼性が上がり、検索エンジンからの評価も高まります。

記事の書き方については以上です。書く手順については、次の4つのステップで書くといいです。

1. アウトラインを作る
2. 文章を書く
3. 公開する
4. リライトする

重要なのは、各ステップごとに推敲することです。アウトラインを作ったら推敲、文章を書いたら推敲、という感じです。こうすることで、読みやすい文章に仕上がります。

上手に文章を書けるようになるには、とにかくたくさん技術ブログを書くしかありません。「書く時間がない」あるいは「書くことがない」というときは、それぞれ解決策を書きましたので参考にしてください。

• いつ技術ブログを書くのか
• 技術ブログの記事のネタの出し方

本記事で紹介した技術ブログの書き方とは別に、アクセス数をふやすためのテクニックというものがあります。それがSEO対策です。これについては次の記事で解説しています。

• 技術ブログのSEO対策

技術ブログを書く環境、読む環境をよくすることも大切です。いいブログ環境を作るならWordPress一択です。WordPressがいい根拠と、ブログの作り方については次で解説しています。

• 技術ブログはWordPressがいい理由
• ロリポップでブログを始める手順

技術ブログを書くときは、文章ではなく記事の設計に力を入れることが大切です。この設計さえきちんとできれば、タイトルや本文はスムーズに作れます。この記事の内容はあくまで参考にしつつ、あなたなりの書き方が見つかるといいのかな、と思います。

情報発信

エンジニアのための技術ブログの始め方を解説します【2023年】

2023-8-20