CSS 論理的プロパティと値のボックスモデルに関するプロパティを更新

- 2021/11/15 時点の英語版に同期

1 files changed, 52 insertions, 60 deletions

diff --git a/files/ja/web/css/margin-block-start/index.md b/files/ja/web/css/margin-block-start/index.md
index 77303e2d5a..dcdd27b58f 100644
--- a/files/ja/web/css/margin-block-start/index.md
+++ b/files/ja/web/css/margin-block-start/index.md
@@ -3,28 +3,27 @@ title: margin-block-start
 slug: Web/CSS/margin-block-start
 tags:
   - CSS
-  - CSS Logical Property
-  - CSS Property
-  - CSS プロパティ
   - CSS 論理的プロパティ
-  - Experimental
+  - CSS プロパティ
+  - 実験的
   - NeedsContent
-  - Reference
+  - リファレンス
   - margin-block
   - margin-block-start
+  - recipe:css-property
+browser-compat: css.properties.margin-block-start
 translation_of: Web/CSS/margin-block-start
 ---
-<div>{{CSSRef}}{{SeeCompatTable}}</div>
+{{CSSRef}}
 
-<p><strong><code>margin-block-start</code></strong> は <a href="/ja/docs/Web/CSS" title="CSS">CSS</a> のプロパティで、要素のインライン方向の論理的な先頭側のマージンを定義し、それが要素の書字方向やテキストの方向に応じて物理的なマージンに対応付けられます。</p>
+**`margin-block-start`** は [CSS](/ja/docs/Web/CSS) のプロパティで、要素のインライン方向の論理的な先頭側のマージンを定義し、それが要素の書字方向やテキストの方向に応じて物理的なマージンに対応づけられます。
 
-<div>{{EmbedInteractiveExample("pages/css/margin-block-start.html")}}</div>
+{{EmbedInteractiveExample("pages/css/margin-block-start.html")}}
 
-<p class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</p>
+## 構文
 
-<h2 id="Syntax" name="Syntax">構文</h2>
-
-<pre class="brush:css no-line-numbers">/* &lt;length&gt; 値 */
+```css
+/* <length> 値 */
 margin-block-start: 10px;  /* 絶対的な長さ */
 margin-block-start: 1em;   /* テキストの大きさに対する相対値 */
 margin-block-start: 5%;    /* 直近のブロックコンテナーの大きさに対する相対値 */
@@ -35,35 +34,42 @@ margin-block-start: auto;
 /* グローバル値 */
 margin-block-start: inherit;
 margin-block-start: initial;
+margin-block-start: revert;
 margin-block-start: unset;
-</pre>
+```
+
+これは {{cssxref("margin-top")}}, {{cssxref("margin-right")}}, {{cssxref("margin-bottom")}}, {{cssxref("margin-left")}} の何れかのプロパティに対応し、どれに対応するかは {{cssxref("writing-mode")}}, {{cssxref("direction")}}, {{cssxref("text-orientation")}} で定義された値によって決まります。
 
-<p>これは {{cssxref("margin-top")}}, {{cssxref("margin-right")}}, {{cssxref("margin-bottom")}}, {{cssxref("margin-left")}} の何れかのプロパティに対応し、どれに対応するかは {{cssxref("writing-mode")}}, {{cssxref("direction")}}, {{cssxref("text-orientation")}} で定義された値によって決まります。</p>
+関連プロパティとして、要素の他のマージンを定義する {{cssxref("margin-block-end")}}, {{cssxref("margin-inline-start")}}, {{cssxref("margin-inline-end")}} があります。
 
-<p>関連プロパティとして、要素の他のマージンを定義する {{cssxref("margin-block-end")}}, {{cssxref("margin-inline-start")}}, {{cssxref("margin-inline-end")}} があります。</p>
+### 値
 
-<p>{{cssinfo}}</p>
+`margin-block-start` プロパティは {{cssxref("margin-left")}} プロパティと同じ値を取ります。
 
-<h3 id="Values" name="Values">値</h3>
+## 公式定義
 
-<p><code>margin-block-start</code> プロパティは {{cssxref("margin-left")}} プロパティと同じ値を取ります。</p>
+{{cssinfo}}
 
-<h3 id="Formal_syntax" name="Formal_syntax">形式文法</h3>
+## 形式文法
 
 {{csssyntax}}
 
-<h2 id="Example" name="Example">例</h2>
+## 例
 
-<h3 id="HTML">HTML</h3>
+<h3 id="Setting_block_start_margin">ブロック方向の先頭のマージンの設定</h3>
 
-<pre class="brush: html">&lt;div&gt;
-  &lt;p class="exampleText"&gt;Example text&lt;/p&gt;
-&lt;/div&gt;
-</pre>
+#### HTML
 
-<h3 id="CSS">CSS</h3>
+```html
+<div>
+  <p class="exampleText">Example text</p>
+</div>
+```
 
-<pre class="brush: css">div {
+#### CSS
+
+```css
+div {
   background-color: yellow;
   width: 120px;
   height: 120px;
@@ -73,36 +79,22 @@ margin-block-start: unset;
   writing-mode: vertical-lr;
   margin-block-start: 20px;
   background-color: #c8c800;
-}</pre>
-
-<p>{{EmbedLiveSample("Example", 140, 140)}}</p>
-
-<h2 id="Specification" name="Specification">仕様書</h2>
-
-<table class="standard-table">
- <thead>
-  <tr>
-   <th scope="col">仕様書</th>
-   <th scope="col">状態</th>
-   <th scope="col">備考</th>
-  </tr>
- </thead>
- <tbody>
-  <tr>
-   <td>{{SpecName("CSS Logical Properties", "#propdef-margin-block-start", "margin-block-start")}}</td>
-   <td>{{Spec2("CSS Logical Properties")}}</td>
-   <td>初回定義</td>
-  </tr>
- </tbody>
-</table>
-
-<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
-
-<p>{{Compat("css.properties.margin-block-start")}}</p>
-
-<h2 id="See_also" name="See_also">関連情報</h2>
-
-<ul>
- <li>対応付け先の物理的なプロパティ: {{cssxref("margin-top")}}, {{cssxref("margin-right")}}, {{cssxref("margin-bottom")}}, {{cssxref("margin-left")}}</li>
- <li>{{cssxref("writing-mode")}}, {{cssxref("direction")}}, {{cssxref("text-orientation")}}</li>
-</ul>
+}
+```
+
+#### 結果
+
+{{EmbedLiveSample("Setting_block_start_margin", 140, 140)}}
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- 対応づけ先の物理的プロパティ: {{cssxref("margin-top")}}, {{cssxref("margin-right")}}, {{cssxref("margin-bottom")}}, {{cssxref("margin-left")}}
+- {{cssxref("writing-mode")}}, {{cssxref("direction")}}, {{cssxref("text-orientation")}}