質問をすることでしか得られない、回答やアドバイスがある。

15分調べてもわからないことは、質問しよう!

ただいまの
回答率

90.32%

  • Atom (テキストエディタ)

    556questions

  • GitLab

    135questions

    GitLabは Gitoliteをブラウザから管理できるようにする Rubyアプリケーションで、 GitHubのようなサービスをクローズドな環境に独自で構築できるように 公開されたものです。

  • TeX

    46questions

    フリーの組版システムで、字や図版などの要素を紙面に配置するという作業をコンピュータで行います

  • MathJax

    7questions

    MathJaxは、MathML/LaTeXなどで記述された数式をWebブラウザ上で整形・表示できるオープンソースのJavaScriptライブラリ。全てのモダンブラウザで動作し、プラグインのインストールやブラウザの設定などを行うことなく利用できます。

gitlab にアップロードする markdown ファイルの扱い方ベストプラクティスの募集

解決済

回答 2

投稿 編集

  • 評価
  • クリップ 1
  • VIEW 1,278

spectrum

score 31

私がいる最近始まったプロジェクトでは、gitlab にファイルやドキュメントをアップロードします。
ドキュメントはマークダウンで書いてあり、atomで編集しています。また、数式が含まれています。

atom で編集している md を gitlab に上げると、プレビューで上手く表示されません。
詳しくはまだ調べてないのですが、レンダリングの違いによります。

そこで、質問ですが良い解決方はありますでしょうか?
私が考えたのは
(1) 今まで通り atom で github markdown で編集し、アップロードするとき変換する正規表現プログラムを書き、それを通してアップロードする。ただプログラムを書くのも、毎回プログラムを通すのも面倒です。
(2) atom で gitlab markdown に対応する数式パッケージを探し、それをいれる。このパッケージが存在するかは分かりません。よろしければ教えて下さい。
(3) gitlab markdown に対応したエディタを探す。プレビューがあると嬉しいです。もしご存知でしたら教えて下さい。

何か良い解決方があれば教えて下さい。よろしくお願いいたします。

  • 気になる質問をクリップする

    クリップした質問は、後からいつでもマイページで確認できます。

    またクリップした質問に回答があった際、通知やメールを受け取ることができます。

    クリップを取り消します

  • 良い質問の評価を上げる

    以下のような質問は評価を上げましょう

    • 質問内容が明確
    • 自分も答えを知りたい
    • 質問者以外のユーザにも役立つ

    評価が高い質問は、TOPページの「注目」タブのフィードに表示されやすくなります。

    質問の評価を上げたことを取り消します

  • 評価を下げられる数の上限に達しました

    評価を下げることができません

    • 1日5回まで評価を下げられます
    • 1日に1ユーザに対して2回まで評価を下げられます

    質問の評価を下げる

    teratailでは下記のような質問を「具体的に困っていることがない質問」、「サイトポリシーに違反する質問」と定義し、推奨していません。

    • プログラミングに関係のない質問
    • やってほしいことだけを記載した丸投げの質問
    • 問題・課題が含まれていない質問
    • 意図的に内容が抹消された質問
    • 広告と受け取られるような投稿

    評価が下がると、TOPページの「アクティブ」「注目」タブのフィードに表示されにくくなります。

    質問の評価を下げたことを取り消します

    この機能は開放されていません

    評価を下げる条件を満たしてません

    評価を下げる理由を選択してください

    詳細な説明はこちら

    上記に当てはまらず、質問内容が明確になっていない質問には「情報の追加・修正依頼」機能からコメントをしてください。

    質問の評価を下げる機能の利用条件

    この機能を利用するためには、以下の事項を行う必要があります。

質問への追記・修正、ベストアンサー選択の依頼

  • t_shinohara

    2018/05/18 12:51

    編集中のMarkdown、どのコードは本来どのように表示されているのか。また、アップロード後はそのコードの部分がどのように表示されないのか。スクリーンショットなどの実例があると非常にわかりやすいと思います。また、GitLabはOSSを自社サーバーで使用しているのかそれともWebサービスを使用しているのかによっても異なるかと思います。

    キャンセル

回答 2

check解決した方法

0

gitlab の数式レンダリングは KaTex で、github の数式レンダリングは MathJax でした。
gitlab で見れるドキュメントの編集のための、atom での KaTex でのレンダリングのプレビューに対応したパッケージを探しました。探した結果 markdown-preview-enhanced が要件に対応しているようでした。
設定で KaTex と MathJax の切り替えができます(!)

今まで markdown-preview-plus を使っていましたが、これに乗り換えました。おすすめだと思います。

あいまいな質問でしたらすみませんでした。
ご回答ありがとうございました。

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

0

GitLabのmarkdownに合わせて書くしかないのでは。
あとはGitLab上で直接編集するとか。それならプレビューできる。

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

  • 2018/05/21 11:25

    ありがとうございます。 gitlab 上で編集できることは知りませんでした。

    キャンセル

15分調べてもわからないことは、teratailで質問しよう!

  • ただいまの回答率 90.32%
  • 質問をまとめることで、思考を整理して素早く解決
  • テンプレート機能で、簡単に質問をまとめられる

同じタグがついた質問を見る

  • Atom (テキストエディタ)

    556questions

  • GitLab

    135questions

    GitLabは Gitoliteをブラウザから管理できるようにする Rubyアプリケーションで、 GitHubのようなサービスをクローズドな環境に独自で構築できるように 公開されたものです。

  • TeX

    46questions

    フリーの組版システムで、字や図版などの要素を紙面に配置するという作業をコンピュータで行います

  • MathJax

    7questions

    MathJaxは、MathML/LaTeXなどで記述された数式をWebブラウザ上で整形・表示できるオープンソースのJavaScriptライブラリ。全てのモダンブラウザで動作し、プラグインのインストールやブラウザの設定などを行うことなく利用できます。