常連

## テーマ、知りたいこと

皆さんはどのような形式でファイルの管理やディレクトリの管理をしデータを管理しているのでしょうか？
自分は最近、PCのディレクトリを整理したり個人のスマホのメモ帳でメモっていた内容すべてをスプレッドシートに移行したりしていました。
特にディレクトリについては、決まったテンプレートもなく開発で様々なソフトを使っているとuser(ログイン名)のディレクトリにたくさん不要なファイルが作られたりして行きますよね。
そこでmyFolder的なのを作って
project,社内情報, 報告書、toolなどのフォルダを作っています。

メモについてはプログラミングに関して言えば
対象, 概要, メモ
のような列を持ったスプレッドシート状のテーブルを作成して、対象には言語やソフトウェアが何かを書いて管理しています。

また、こういった情報って業務上で学べるものなんでしょうか？新卒で採用された経験がないので新人研修的なものもなく、どのように皆さん考えておられるのか不思議です。

## 背景、状況

twitterで
「今新入社員にひと言伝えるなら、「すべての情報を基本mdファイルで管理しよう」ですね」
という内容の投稿が2,000回以上いいねされていました。

また、友人から「エンジニアだったりパソコンに詳しい人はオフィスソフトじゃなくてmdを使うのか？」と質問され、自分の考えが特殊なのもあり皆さんのご意見をお伺いしたいと思いました。

mdって使いづらい感じがするんですが、そんなにいいものでしょうか。
段落を自分で考えねばならず、ファイル毎の管理になるのでデータ管理としては見通しもよくありません。
人に見せる用の使い捨てであればわかりますが、すべての情報をと記載されていますしmdってデータの管理の側面で使い道あるのでしょうか。
md以外の形式からmdとしてデータを出力するプログラムはかけそうですが、逆は厳しい感じもします。

## 補足
mdだけに話題を絞ると内容がなさそうなので、データ管理全般についてもお伺いしようかと思いました。
意見交換の使い方がいまいち分かっていないのですが。
使い方がどこに書いているのか定かではありませんでしたが、とりあえず以下の内容を読むに問題無さそうと判断しています。
https://blog.teratail.com/entry/release-discussion

## 質問後追記
投稿前に気づけよって話ですがgitでバージョン管理しているなら、mdとクラウドサービス一択になりそうですね。。。
自分のところではsvnを使用しているので、完全に失念していました。。。
そう考えると使い分けの考えについても完全に納得いきます。。。

データの管理、ディレクトリやファイル形式について

### 実現したいこと
mdファイルの中にある「サンプル文字」をwordに書き込みたいが、**下線を引いた状態で出力できない。**

プログラムは実行できる、wordファイルも出力できる。wordに文字も出力されている。

### 発生している問題・分からないこと
luaフィルタのRawInline関数で下線が見つかったならば、pandocを用いて下線を引く処理を追記しているが出力されたwordファイルを見ると、下線が引かれていない。



### 該当のソースコード

```python(main.py)
# ■■ Pandocインストール必要(https://github.com/jgm/pandoc/releases/tag/3.6.4)
import os, re
import subprocess
from docx import Document
import time

# Markdownの整形処理
def md_edit(md_file_path, temp_file_path):
 with open(md_file_path, 'r', encoding='utf-8') as infile, open(temp_file_path, 'w', encoding='utf-8') as outfile:
 prev_line_flg = False
 for line in infile:
 # リンク内のスペース除外
 if '<a name="' in line and '</a>' in line:
 start_index = line.find('<a name="') + len('<a name="')
 end_index = line.find('">', start_index)
 name_content = line[start_index:end_index].replace(' ', '').replace('　', '')
 line = line[:start_index] + name_content + line[end_index:]
 
 # URL以外は、リンク内のスペース除外
 if '](' in line and ')' in line and 'http' not in line:
 start_index = line.find('](') + len('](')
 end_index = line.find(')', start_index)
 link_content = line[start_index:end_index].replace(' ', '').replace('　', '')
 line = line[:start_index] + link_content + line[end_index:]
 
 # 行の先頭が<で次に英語または/以外の文字が続く場合、<を＜に置換し、同じ行の次の>を＞に置換
 if re.match(r'^<[^a-zA-Z/]', line):
 line = line.replace('<', '＜', 1)
 line = line.replace('>', '＞', 1)
 
 # "#"から始まる対象は、前回が空でなければ改行を追加
 if line.startswith('#') and prev_line_flg:
 outfile.write('\n') # 改行追加
 
 # ">"のみの対象は、半角スペースを追加
 if line.strip() == '>':
 line = '> \n'
 
 # 行の末尾が" "または" "の場合、除外
 if line.rstrip().endswith(' ') and line.strip() != ' ':
 line = line.rstrip()[:-4] + '\n'
 elif line.rstrip().endswith(' ') and line.strip() != ' ':
 line = line.rstrip()[:-5] + '\n'

 

 outfile.write(line) # 行反映

 # 改行のみであったかチェック
 if line == '\n':
 prev_line_flg = False
 else:
 prev_line_flg = True

# Word編集処理
def word_edit(docx_file_path):
 document = Document(docx_file_path)
 for paragraph in document.paragraphs:
 if paragraph.text.startswith('> '):
 paragraph.style = 'Quote'
 paragraph.text = paragraph.text[2:]

 document.save(docx_file_path)

def main():
 try:
 # ◆Markdownファイルリスト
 in_dir = "in"
 md_file_lists = list(filter(lambda f: f.endswith(".md"), os.listdir(in_dir)))

 # ◆ディレクトリ直下のカスタムテンプレートファイル
 # Wordのスタイルウィンドウを出して、出力したいスタイルのテンプレートを作成
 template_file = "template.docx"

 # ◆出力ディレクトリ
 out_dir = "out"

 # ◆出力ディレクトリが存在しない場合は作成
 if not os.path.exists(out_dir):
 os.makedirs(out_dir)

 # ◆Pandocコマンド実行
 if md_file_lists:
 for i, md_file in enumerate(md_file_lists):
 input_file_path = os.path.join(in_dir, md_file) # インプットファイルパス作成
 temp_file_path = os.path.join(in_dir, 'temp_' + md_file) # 一時ファイルパス作成
 output_file_path = os.path.join(out_dir, os.path.splitext(os.path.basename(md_file))[0] + ".docx") # アウトプットファイルパス作成
 
 md_edit(input_file_path, temp_file_path) # Markdownファイル整形
 
 if template_file != "":
 # ◇テンプレート指定あり
 cmd = [
 "pandoc", temp_file_path,
 "--reference-doc", template_file,
 "--lua-filter=fix.lua",
 "--wrap=preserve",
 "-o", output_file_path
 ]
 else:
 # ◇テンプレート指定なし
 cmd = [
 "pandoc", temp_file_path,
 "--lua-filter=fix.lua",
 "--wrap=preserve",
 "-o", output_file_path
 ]
 
 result = subprocess.run(cmd, capture_output=True, text=True) # Pandoc実行
 if result.returncode != 0:
 raise Exception(f"変換異常発生: {result.stderr} >{md_file}")
 
 word_edit(output_file_path) # word編集
 
 os.remove(temp_file_path) # 一時ファイル削除
 
 if i == 0: print("【変換対象ファイル一覧】")
 print(f"{i+1}: {md_file}")

 print("-- 変換完了 --")
 
 else:
 print("-- MDファイルなし --")

 except Exception as err:
 print(err)


if __name__ == '__main__':
 main()
```

```luaフィルタ(fix.lua)
local b_cnt = 0

-- ブロック処理
function RawBlock(el)
 -- 改ページ処理
 if el.text == '<div style="page-break-before:always"></div>' then
 return pandoc.RawBlock('openxml', '<w:p><w:r><w:br w:type="page"/></w:r></w:p>')
 else
 return el

 end
end

-- インライン処理
function RawInline(el)
 -- 2025/05/07下線処理
 if el.text:match('(.-)') then
 local underlined_text = el.text:match('(.-)')
 return pandoc.RawInline('openxml', '<w:r><w:rPr><w:u w:val="single"/></w:rPr><w:t>' .. underlined_text .. '</w:t></w:r>')

 -- 改行処理
 elseif el.text == ' ' or el.text == ' ' then
 return pandoc.RawInline('openxml', '<w:br/>')

 -- ブックマーク処理
 elseif el.text:match('<a name="(.-)">') then
 local b_name = el.text:match('<a name="(.-)">')
 b_cnt = b_cnt + 1
 return pandoc.RawInline('openxml', '<w:bookmarkStart w:id="' .. b_cnt .. '" w:name="' .. b_name .. '"/><w:bookmarkEnd w:id="' .. b_cnt .. '"/>')

 else
 return el

 end
end

-- リンク処理
function Link(el)
 if el.target:match("^#") then
 b_cnt = b_cnt + 1
 local b_name = el.target:sub(2):gsub("%%20", " ")
 local content = pandoc.utils.stringify(el.content)
 return {
 pandoc.RawInline('openxml', '<w:bookmarkStart w:id="' .. b_cnt .. '" w:name="' .. b_name .. '"/>'),pandoc.RawInline('openxml', '<w:hyperlink w:anchor="' .. b_name .. '"><w:r><w:t>' .. content .. '</w:t></w:r></w:hyperlink>'),
 pandoc.RawInline('openxml', '<w:bookmarkEnd w:id="' .. b_cnt .. '"/>')
 }
 else
 return el
 end
end
```

```sample.md
 アイウエオ
サンプル文字
```

### 試したこと・調べたこと
- [ ] teratailやGoogle等で検索した
- [x] ソースコードを自分なりに変更した
- [ ] 知人に聞いた
- [x] その他

##### 上記の詳細・結果
ネットで「pandoc luaフィルター」と調べ、pandoc.Underlineメソッドも使ったが実行できなかった。
[https://pandoc.org/lua-filters.html#type-inlines](url)

chatgptを使っても、私が書いたコードと同じになり、実行結果も変わらない。

### 補足
pandoc 3.6.4
python 3.8

python、pandoc、Luaフィルタを用いてmdファイルの内容をwordに書き込みたい

### 前提・実現したいこと

VS CodeでMarkdownを記述してローカルに保存した画像を表示したいのですが、表示できません。
VS Code自体は先程インストールしたばかりで特別な設定などはしておりません(日本語にしてpast imageという拡張機能を導入したくらいです)。
```
![](google.png)
```
フォルダ階層は以下の通りです。(Test1.mdがMarkdown記述ファイルです)
![](aeeeebcaebcd6aebbad647a6670665b0.png)


単純に画像を表示する機能がないだけだと思い、以下のように記述したところ画像の表示がされました。
```ここに言語名を入力
![](https://teratail.storage.googleapis.com/assets/img/common/icnReloadBtn.png?1536717371869247)
```
また、相対パスの設定か何かがおかしいのかと思い、以下のような記述にしてみても表示されませんでした。
```
![](file:///C:/フォルダまでのパス/google.png)
```

どなたかご教授よろしくお願い致します。

追記
以下のようになっています。
![イメージ説明](b27762345b2471f9199b5e656bee4e41.png)

VS CodeでMarkdownを記述してローカルに保存した画像の表示方法

###前提・実現したいこと
 ←ここにスペースを空けたい

###発生している問題・エラーメッセージ
 ←ここにスペースが空かない

###該当のソースコード
```text
 ←ここにスペースを空けたい
```

###試したこと
 ←ここに半角スペース
 ←ここに全角スペース
          ←ここに全角スペース*10
.          ←行頭以外はスペースが効く


###補足情報(言語/FW/ツール等のバージョンなど)

行頭に半角/全角スペースをいくら突っ込んでも、プレビュー段階で勝手に削除されてしまう。
単純に行頭を1文字下げてテキストを表示したい。

コード中の2行目以降であれば効くが(何故か1行目は効かない)、平文の部分で行いたい。
ヘルプのmarkdownには該当のような項目の記載はなかった。
HTML等は当然無効。

というか半角だけならまだしも全角を勝手に潰すってのはどうなんだ。

![イメージ説明](6599668debf1503d10a41f05165fece5.png)

【teratail】行頭にスペースを入れたい

### 前提・実現したいこと

JupyterのMarkdownでの出力において、表自体（表のセルの内容ではなく）を
左に寄せる形で出力したいです。

### 発生している問題・エラーメッセージ

表自体が中央ぞろえのような形で出力されます。
※両画面端までいくような大きな表ではなく、比較的小さな表です。

### 試したこと

Jupyter 表 Markdown
といったキーワードで検索しましたが、
実現したい方法がみつかりませんでした。

### 補足情報（FW/ツールのバージョンなど）
Windows7 32bit
Jupyter 5.0.0
Python 2.7.13
Anaconda custom (32-bit)
IPython 5.3.0
Chrome 64.0.3282.186（Official Build） （32 ビット）

JupyterのMarkdownで表自体を左寄せしたい

VS Code Markdown　で画像がPreviewに表示されません。
ここは初めてなので使い方がうまくないと思いますが、ご容赦ください（ご指摘は歓迎します）

![イメージ説明](https://ddjkaamml8q8x.cloudfront.net/questions/2022-06-30/e9aae459-b212-4ee8-98c9-58e9033c55d6.png)
ワークスペースに記述したマークダウンに画像を表示しようとするとローカルフォルダへの画像の表示ができません。
~~~
![BorderLine種類](img/BorderLine.png)
![qwerty](file:///C:/tmp/BorderLine.png)
![Test](./img/BorderLine.png)
![Test1](../../c#/img/BorderLine.png)


![picture 2](https://images.tetsudo.com/report/305/65_001.jpg)
~~~
インターネットのURLに対しては表示されていますが、このマークダウンファイルを起点とした表示などではうまくいきません。
ワークスペースを起点とかするという話もあったので、念のため　プログラムヒント.code-workspace　のあるフォルダからのパスも書きましたが(Test1)ワークスペースの起点の位置がこのファイルの位置かもわからない程度なのかもしれませんがダメでした。

拡張機能は、使ってもいない Jupytter や、Kite, Markdown All in One, Path Intellisense, PrintCode,Python, Remote WSL, vscode.pdf などなどいろいろ入れています。

Markdown Imageは、いったん入れて外して　Paste Imageを入れましたが、どうやら入れる前と後で変わりはないようです。

なお、OSは　Windows11 Proです。

どうか、よろしくお願いします。

VS Code Markdown　で画像がPreviewに表示されません。

Markdownで下記のようにリストの入れ子を記述する時に、GitHubのMarkdownなど、実装によっては入れ子の行先頭に半角スペース2個以上が必要なようですが、2個以上でないといけない何か明確な理由があるのでしょうか？

```Markdown
- foo
  - bar
- hoge
  - fuga
```

利便性を考えると個人的には半角スペース1個以上で問題ないとは思うのですが、なにか資料などがありましたら教えて下さい。宜しくお願いします。

Markdownでリストの入れ子のインデント数について

こんにちは。 

###前提・実現したいこと
すごく基本的な質問で恐縮です。
teratailやマークダウンで使う、コードを示す「```」の、キーボードからの入力方法や、文字コード番号(Unicode/SJIS)、読み方などを教えていただけないでしょうか。

###発生している問題・エラーメッセージ
入力できずに、コードをマーキングできず困っています。

です。 
 よろしくお願いします。