技術記事を書くことは、最初はなかなかハードルの高い作業に思えます。文章を書くにはある程度の慣れが必要である考えています。 誰しも初めのうちはうまく文章を書くことができず、文章を書く訓練を重ねることで、内容を伝えやすい・理解しやすいある種の「型」を発見されているのではないかと思っています。 この記事では id:azukiazusa が普段記事を書く時に考えていることを書き下していきます。 見出しを先に書く コードは実行可能にする 文法エラーがないように 文脈依存にならないように foo や bar のような名前を使いすぎない 記事は1日寝かせる その他文法的な事項 見出しは ## から始める インラインコードブロックは装飾目的で使わない 英語と日本語の間に半角スペースを空ける おわりに 参考 見出しを先に書く 私が技術記事を書くときには最初に見出しから書き始めます。下記のような感じです。 見
![私の技術記事の書き方 - azukiazusaのブログ](https://cdn-ak-scissors.b.st-hatena.com/image/square/bd66322da967138525ca98e4e8788f7fc767132d/height=288;version=1;width=512/https%3A%2F%2Fcdn-ak.f.st-hatena.com%2Fimages%2Ffotolife%2Fa%2Fazukiazusa%2F20230102%2F20230102111642.png)