Qiitaはじめました。
自分も情報発信したいなと思い始めたのですが、書き方が分からなくて色々と調べました。
投稿の練習として書いていますが、私と同じように初投稿される方の参考になれば幸いです。
アカウント作成
GitHub連携でアカウントを作成しました。
Twitter, Googleアカウントとの連携も可能です。
ガイドライン
良い記事を書くためのガイドライン
Qiita公式のガイドラインを最初に読みました。
タイトルの付け方やルール等が書いてあるので、まずはガイドラインを読みましょう。
早速投稿してみる
PCから投稿しました。
入力画面
右上の投稿するボタンを押すと、こんな画面が開きます。
最低限、これだけ知っていれば困らないと思います。
- 左欄に本文を入力すると、右欄にプレビューが表示される
- Markdownの書き方がわからなくなったら「?」(ハテナ)を押す
- 右下のボタンから、投稿と下書き保存ができる
- 画像マークを押すと画像の挿入が出来る
Markdown記法
QiitaではMarkdown記法で投稿します。
GitHubでREADMEを書いたことのある方は違和感なく書けると思います。
書き方が分からなくなったら本文の上の「?」(ハテナ)を押しましょう。
詳しいことを知りたい場合は、Qiita公式のチートシートを参考にしましょう。
Markdown記法 チートシート
他の方の書き方を参考にする
他の方の投稿のMarkdownを見ることも出来ます。
コードの書き方
バッククォート3つで囲います。
``` main.c
#include
int main(void){
printf("Hello, World!!¥n");
return(0);
}
```
#include <stdio.h>
int main(void){
printf("Hello, World!!¥n");
return(0);
}
その他のトラブルシューティング
- バッククォートを文字列として扱う場合はバックスラッシュ''を使う
- 半角スペースをどうしても入れたいときは を使う
- 画像の挿入で"Bad Request"と出たら少し待ってからリトライする
参考にさせていただいた投稿
@riocamposさん、@sugaryoさん、ありがとうございます。
Qiitaに投稿する記事の書き方に望むこと
Qiitaのはじめかた。
いざ投稿
「Qiitaに投稿」ボタンを押すと、Twitterと紐づけるか聞かれました。
Qiitaに投稿したことをツイートしたいと思っていたので、紐づけることにしました。
が、失敗しました。
連携が上手くいっていなかったようで、Qiitaに投稿してもTwitterにツイートされていませんでした。
記事を投稿する前に、アカウント設定でTwitter連携を設定しておくのが無難なようです。
最後に
アカウント作成から投稿するまでに、2時間くらいかかってしまいましたが、慣れればもっとスムーズに書けるようになると思います。
他の方の投稿を参考にさせていただいて、情報を残すことの重要性とありがたみを改めて感じました。