はじめに
「Qiitaの記事投稿に挑戦してみよう!」と思っていてもアウトプットに慣れていない場合、最初の一歩が踏み出せない経験は大いにあります。
身近な方にQiita記事はどのように書いているか質問しても「他の人の記事を参考にする」という意見が多かったです。
参考するにしても誰の記事を参考にするのか余計に迷う方もいます。
私自身も同じ経験を持っていたため、Qiita記事投稿初心者向けに、投稿頻度をあげられるフレームワークを発信できればと思います。
Qiitaへ投稿する最初のハードル
- Qiita記事の書き方が分からない
- Qiita記事作成に時間がかかりすぎる
- Qiita記事の見栄えを考えるのが難しい
- Qiita記事のネタが見つからない
いざ記事作成に向き合うと多くのハードルがあります。
Qiita記事投稿をするということは、誰かの目にとまる可能性もあります。
そのため、「誰かのため」に記事を書こうとする気持ちがあるとは思いますが、そうすると思うように記事作成が進みません。
Qiita記事投稿を「誰かのため」→「自分のため」に置き換えると気持ちが楽になると思います。
最初の第一歩として、自身の経験をまとめて「自分のため」に投稿できるとよいです!
この記事の対象者
- Qiitaに記事を投稿してみたいと思う方
- Qiitaに今後投稿してみようと思う方
- Qiitaに投稿する時間を削減しようと考えている方
本記事の構成
- 投稿フレームワーク紹介
- 各見出しの解説
- 記事を書く際に頻出頻度の高い方法
- まとめ
- 参考にしたサイト
1. 投稿フレームワーク
# はじめに
# この記事の対象者
# 開発環境
# 問題
# 解決方法
# おわりに
# 参考サイト
基本的な技術投稿内容は上記の構成で満たせます。
下記の「各見出しの解説」をもとに記事作成を頑張ってみましょう!
2. 各見出しの解説
はじめに
記事を投稿するとき様々な目的を持って行っております。
- 過去に経験した問題の共有
- 自身のナレッジを発信する
この記事の対象者
誰に対して、何を伝えたいか対象者を記載します。
# この記事の対象者
- Qiitaに記事を投稿してみたいと思う方
- Qiitaに今後投稿してみようと思う方
- Qiitaに投稿する時間を削減しようと考えている方
開発環境
技術記事を書く場合、開発環境を書くことをおすすめします。
類似した問題にめぐり合わせた時、開発環境によって再現有無が変わるケースもございます。
自分自身が問題に直面した時や、他の人が同様の問題に直面した時の解決のヒントになる可能性があるので記載しましょう。
# 開発環境
- OS:Windows11
- 開発ツール:UiPath Studio
- バージョン:2023.10.0
- ライセンス:Community License
- モダン デザイン エクスペリエンス:いいえ
- Microsoft Excel:2310
:::note warn
- 本投稿の開発環境になっております
- バージョンによっては画面が一部異なる可能性はございます
:::
問題
本記事で自身が直面した問題を記載します。
文面だけではなく、「エラー内容」・「スクリーンショット」を貼ることにより視覚的に問題のイメージがつきます。
解決方法
問題に対しての解決方法を記載します。
画像やソースコードなどがある場合、貼ることをオススメします。
文面だけだと分かりにくい問題も視覚的に解決するヒントになります。
また苦労した経験も補足して記載することもよいです。
他の人も同じ事象で苦労した可能性もあるため、同様に解決するヒントになります。
おわりに
全体の総括を書きます。実装する際に心掛けたことや自身の思いなど、率直な意見を書くと良いです。
参考サイト
記事を書く際、参考にしたサイトがある場合、必ず記載しましょう。
自身が記事を作成した時の振り返りにも使用可能ですし、説明に対する根拠として示すことになります。
# 参考サイト
[Markdown記法 チートシート](https://qiita.com/Qiita/items/c686397e4a0f4f11683d)
3. 記事を書く際に頻出頻度の高い記法
■見出し
# 見出し
## 見出し
### 見出し
#### 見出し
■リンク
[Markdown記法 チートシート](https://qiita.com/Qiita/items/c686397e4a0f4f11683d)
■文字色
<font color="Red">赤文字</font>
<font color="Blue">青文字</font>
<font color="Green">緑文字</font>
<font color="Yellow">黄文字</font>
赤文字
青文字
緑文字
黄文字
■補足説明
:::note info
インフォメーション
:::
:::note warn
注意
:::
:::note alert
警告
:::
インフォメーション
注意
警告
4. まとめ
Qiita記事投稿に関する考え方は様々ですが、自身の経験をまとめてアウトプットすることは重要です。
自身の知識の定着や言語化能力の向上に繋がります。
良い記事を最初から書こうと思ったら、ハードルはとても高くなるので、自分自身のペースで継続して投稿できると良いです。継続して投稿することにより、心理的ハードルが下がっていくので、Qiita投稿の発信活動が進みます。
本記事でアウトプットする頻度が増えたり、Qiita記事投稿に興味を持てたら大変嬉しく思います。