0

私はGithubマークダウン(* .md)で書かれた私の雇用主のコーディング基準にいくつかの小さな改良を提案しようとしています。Github Markdown文書にコードの塊の中にURLリンクを含めることはできますか?

私は、このマークダウン言語の書式設定の慣例をいくつか参考にして説明しました。私は、少なくとも2つの異なる方法でURLを追加することができていることがわかり、私の測定値から

  • 標準HTML:
    <a href="LINK_URL">TEXT</a>
  • 値下げスタイルリンク:
    [TEXT](LINK_URL)

...そしてコード・マークダウンは次のように書かれています:

  • 値下げスタイル:

    ```LANGUAGE MY CODE; ```

  • 暗黙のコード表記スペースのインデント4を介して。

しかし、私はあなたが(すなわち、リポジトリ内のそのオブジェクトのソースの場所に)コードのブロック内にハイパーリンクを含めることができるかどうかの参照を見つけることができませんしてきました。

は、すなわち私のような何かをしたい:しかし、動作しない、と私は明示的にこれが可能であるかどうかを知らせる文書を見つけることができませんされてきた

```javascript 
_myQObject: <a title="QML Source for MyQObject" href="URL_TO_SOURCE">MyQObject {} 
``` 

フォーマットされたGithubマークダウンのチャンク内にURLへのリンクを含めるにはどうすればよいですか?

これは可能ですか?

参考のために私が確認しました、基本的なスタイルガイドは、次のとおりです。

答えて

1

私はチャンク内のURLへのリンクを含めることができますどのようにフォーマットされたGithubのマークダウンの?

私が知る限り、これは不可能です。

original Markdown specificationsays:コードスパンで

、アンパサンドと角括弧は、それが簡単に例のHTMLタグが含まれるようになりますこれ、自動的にHTMLエンティティとしてエンコードされています。

...

通常のマークダウン構文はコードブロック内で処理されません。たとえば、アスタリスクはコードブロック内のリテラルアスタリスクだけです。つまり、Markdownを使用してMarkdown独自の構文について書くことも簡単です。

GitHub Markdownのドキュメントでは、コードブロック内のリンクのサポートが追加されているとは言いませんでした。

他のMarkdown実装でもこの機能が見られませんでした。

+0

ああ、それは残念です...私はちょうどコードブロックの上にリンクされたファイル名でラベルを配置することです私の秋を使用します。ありがとう、クリス。彼らがこれを実装している場合は、このソリューションを更新してください! –

関連する問題